❄️ FrozenCmdWhitelist

📦 Plugin Info

A tier-based command whitelist plugin for Minecraft servers. It restricts which commands a player can execute and which commands appear in tab completion, based on permission tier (default / staff / op). Any command not on a player's whitelist is blocked and hidden from tab complete. OPs bypass all restrictions.

• Name: FrozenCmdWhitelist
• Version: 1.2.0
• Main class: me.drfrozenxd.frozencw.FrozenCmdWhitelist

👤 Author Info

• Author: DrFrozenXD

✅ Versions / Compatibility / Software Support

• API Version: 1.20
• Built against: Paper API 1.21.1-R0.1-SNAPSHOT (Java 17 toolchain) ☕
• Server software: Paper (and forks, e.g. Folia/Purpur, via Paper API) 🧵
• Dependency: LuckPerms 🔗 (required — depend: [LuckPerms]). Used to detect permission changes in real time so command lists and tab completion update instantly (via UserDataRecalculateEvent) without needing a relog. ⚡

🔐 Permissions

A player with none of the three tier permissions is not affected by the whitelist at all. OPs always bypass restrictions regardless of tier.

⌨️ Commands

🎯 Uses

• 🔒 Lock down a server to only a curated set of commands per rank (e.g. survival/economy servers, minigame lobbies, restricted staff environments).
• 🙈 Prevent players from discovering or running commands they don't have explicit access to — blocked commands don't even show up in tab complete.
• 🪜 Give staff a wider command set than default players, and give OPs an even wider (or unrestricted) set.
• ⚡ Instantly reflect permission changes: when a player's LuckPerms permissions change, or when the config is reloaded, their allowed command list and tab completion update immediately with no relog needed.
• 🔇 Blocked command attempts show a configurable action bar message and sound effect.

🛠️ How to Add More Commands to Tab Completion

Commands are defined per tier in config.yml under the commands: section. Add the command name (no leading slash) to the relevant tier's list:

commands:
  default:
    - home
    - spawn
    - mycommand   # add new commands like this

  staff:
    - kick
    - mute
    - mycommand

  op:
    - gmc
    - crate
    - mycommand

• ➕ Add the same command to multiple tiers if more than one rank should have access to it.
• 🔄 After editing config.yml, run /frozencmdwhitelist (or /fcw) to reload — this instantly updates tab completion and command execution rules for all online players without requiring them to relog.
• 🚫 Commands not present in a player's tier list will not appear in tab completion and cannot be executed by that player (unless they are OP). 👑