Minecraft plugin CommandWhitelist

🔌 O CommandWhitelist

CommandWhitelist je plugin pro Minecraft, který dává správcům serveru přesnou kontrolu nad tím, jaké příkazy mohou běžní hráči objevovat, doplňovat přes tab a spouštět. Prosazuje nastavitelný whitelist povolených příkazů a může přepsat výchozí odpověď "no such command", kterou uživatelé vidí.

🎯 Účel

Hlavním účelem tohoto pluginu je omezit viditelnost příkazů a zabránit neoprávněnému používání příkazů. Je určen pro administrátory serverů, kteří chtějí skrýt nebo blokovat příkazy před běžnými hráči (například plugin nebo admin příkazy) a kteří potřebují jemné řízení viditelnosti tab-completion.

⚙️ Funkce

• Nastavení whitelistu příkazů, které mohou běžní hráči spouštět nebo vidět.
• Blokování spouštění příkazů, které nejsou na whitelistu.
• Volitelné blokování tab-completion pro příkazy mimo whitelist (používá se integrace s packet/tab-completion hookem, pokud je k dispozici).
• Nahrazení nebo úprava zprávy zobrazené hráčům, když je příkaz zamítnut.
• Podpora blokování konkrétních subcommandů (jak doplňování, tak spouštění).

🧩 Pro koho je určen

• Majitelé a administrátoři serverů, kteří chtějí skrýt admin/plugin příkazy před běžnými hráči.
• Servery, které vyžadují přísnější kontrolu nad viditelností příkazů (SMP, public survival, moderované komunity).
• Sítě používající proxy software, které potřebují konzistentní chování viditelnosti příkazů napříč backend servery.

🏗️ Příklady použití

• Zabránit běžným hráčům v zobrazení příkazů pro správu pluginů a zároveň je nechat používat staff.
• Zastavit tab-completion, aby neodhalovalo názvy administrátorských příkazů uživatelům bez oprávnění.
• Nahradit výchozí zpětnou vazbu "unknown command" jasnější nebo značkovanou odmítací zprávou.

⚙️ Instalace

📥 Nastavení

• Stáhněte JAR pluginu z oficiální stránky vydání projektu.
• Umístěte JAR do složky plugins/ vašeho serveru (backend nebo proxy podle potřeby).
• Restartujte server a zkontrolujte serverovou konzoli, zda se plugin načetl.

📦 Závislosti

• ProtocolLib se běžně používá ke zlepšení blokování tab-completion; je volitelný a vyžaduje se jen tehdy, když správce serveru potřebuje, aby plugin skrýval completion na úrovni packetů.

🧠 Technické poznámky

• Oficiálně podporuje serverový software založený na Bukkitu a je distribuován se sestaveními pro servery ve stylu Bukkit/Spigot a proxy platformy.
• Projekt uvádí kompatibilitu od Minecraft 1.13 a novější (zdokumentováno jako "1.13+").
• Repozitář projektu a balení pluginu jsou vydány pod licencí GPL-2.0.
• Projekt poskytuje GitHub wiki a issue tracker pro dokumentaci a hlášení chyb; také publikuje vydání ke stažení.
• Projekt zobrazuje statistiky používání přes bStats.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete jednoduchou a jasnou kontrolu nad tím, jaké příkazy mohou vaši běžní hráči vidět nebo používat (včetně chování tab-completion, když je k dispozici packet hook), CommandWhitelist nabízí cílený whitelist přístup, který funguje na serverech ve stylu Bukkit i na podporovaných proxy sestavách.