FrozenCommands

Плагин FoliaPaperPurpur

A easy cmd whitelist plugin for 1.21+ servers supporting papermc, folia and purpur

46 скачиваний 0 подписчиков

Оцените первым

Канал

Ядро

Версия

❄️ 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). 👑