From 21fb78515194d95fd87d3d6f5cc81ae7012b9617 Mon Sep 17 00:00:00 2001 From: Ryan Barlow <7389646+ryanbarlow97@users.noreply.github.com> Date: Thu, 15 Oct 2026 14:43:58 +0000 Subject: [PATCH 1/2] TFMCCore: document /tfmc promote|demote on the highest track Co-Authored-By: Claude Opus 5.5 --- .../src/main/java/net/tfminecraft/tfmccore/tfmc/TFMC.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/projects/TFMCCore/src/main/java/net/tfminecraft/tfmccore/tfmc/TFMC.md b/projects/TFMCCore/src/main/java/net/tfminecraft/tfmccore/tfmc/TFMC.md index 11b07ab..12b2c7d 100644 --- a/projects/TFMCCore/src/main/java/net/tfminecraft/tfmccore/tfmc/TFMC.md +++ b/projects/TFMCCore/src/main/java/net/tfminecraft/tfmccore/tfmc/TFMC.md @@ -20,8 +20,11 @@ Before this, `/tfmc` was served by AACommandsFiller (suggestions only) with Cond | `masks` | everyone | A random mask; 10 s cooldown | | `poster ` | everyone | Places a configured image poster | | `ban [reason]` | `tfmc.helper` | Essentials `tempban` for 8 hours | -| `helper promote\|demote` | `helper.promote` / `helper.demote` | One step along the `helper` LuckPerms track | -| `helper+ promote\|demote` | `helper+.promote` / `helper+.demote` | One step along the `helper+` LuckPerms track | +| `promote\|demote` | the step's permission on the player's highest track | One step along that LuckPerms track (see below) | + +### Promote and demote + +`helper-tracks` in `tfmc.yml` lists the LuckPerms tracks lowest first (`helper`, `helper+`, `staff`) with a promote and a demote permission for each. A player's highest track is the last one whose promote or demote permission they hold, and `promote` and `demote` always act on it. Each is offered only when the player holds that step's permission on that track. On every track, the `_player` group grants the promote permission and the `_inactive` group grants the demote permission. The active group inherits both. ### Disabled by default @@ -36,7 +39,7 @@ These sections ship with `enabled: false` in `tfmc.yml` and stay out of the comm ## Configuration -`plugins/TFMCCore/tfmc.yml` holds the messages (MiniMessage), console commands, item and mask lists, calendar names, donor tiers and posters. Reload it with `/tcore reload tfmc`; changes to `helper-tracks` need a restart because they add or remove command nodes. +`plugins/TFMCCore/tfmc.yml` holds the messages (MiniMessage), console commands, item and mask lists, calendar names, donor tiers and posters. Reload it with `/tcore reload tfmc`. The booster cooldown is stored in `plugins/TFMCCore/tfmc-cooldowns.yml`. On the first start without that file, TFMCCore imports last-use times from `plugins/ConditionalEvents/players/*.yml` (`events.global_booster.cooldown`). From 2aa0cfdbd8428a32dc7716869fed65897e11afa4 Mon Sep 17 00:00:00 2001 From: Ryan Barlow <7389646+ryanbarlow97@users.noreply.github.com> Date: Thu, 15 Oct 2026 14:48:29 +0000 Subject: [PATCH 2/2] TFMCCore: promote/demote track follows group membership Co-Authored-By: Claude Opus 5.5 --- .../src/main/java/net/tfminecraft/tfmccore/tfmc/TFMC.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/projects/TFMCCore/src/main/java/net/tfminecraft/tfmccore/tfmc/TFMC.md b/projects/TFMCCore/src/main/java/net/tfminecraft/tfmccore/tfmc/TFMC.md index 12b2c7d..cd40eba 100644 --- a/projects/TFMCCore/src/main/java/net/tfminecraft/tfmccore/tfmc/TFMC.md +++ b/projects/TFMCCore/src/main/java/net/tfminecraft/tfmccore/tfmc/TFMC.md @@ -24,7 +24,9 @@ Before this, `/tfmc` was served by AACommandsFiller (suggestions only) with Cond ### Promote and demote -`helper-tracks` in `tfmc.yml` lists the LuckPerms tracks lowest first (`helper`, `helper+`, `staff`) with a promote and a demote permission for each. A player's highest track is the last one whose promote or demote permission they hold, and `promote` and `demote` always act on it. Each is offered only when the player holds that step's permission on that track. On every track, the `_player` group grants the promote permission and the `_inactive` group grants the demote permission. The active group inherits both. +`helper-tracks` in `tfmc.yml` lists the LuckPerms tracks lowest first (`helper`, `helper+`, `staff`) with a promote and a demote permission for each. A player's highest track is the last one that holds one of their own global groups, and `promote` and `demote` always act on it. Each is offered only when the player holds that step's permission on that track. Membership decides the track because the active `helper+`, `staff_inactive` and `staff` groups hold `*`, which matches every track's permissions. A step never adds a player to a track they are not on. + +On each track, the `_player` group grants the promote permission and the `_inactive` group grants the demote permission. The active group inherits both. ### Disabled by default