❄️ 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

Permission	Default	Purpose
frozencmdwhitelist.default	false	Grants the "default" tier command whitelist
frozencmdwhitelist.staff	false	Grants the "staff" tier command whitelist
frozencmdwhitelist.op	false	Grants the "op" tier command whitelist
frozencmdwhitelist.reload	op	Allows use of the reload command

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

Command	Aliases	Permission	Description
/frozencmdwhitelist	/fcw	frozencmdwhitelist.reload	🔄 Reloads config.yml and immediately pushes the updated command whitelist to all online players (refreshes both execution rules and tab completion)

🎯 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). 👑