HxBlockerCMD

HxBlockerCMD — Lightweight Paper command blocker plugin that hides and blocks unwanted commands with a clean vanilla experience.

---

✨ Features

• 🔒 Block Commands — Cancel blocked commands and show a vanilla-style error message (red, underlined, italic) that looks exactly like Minecraft's native "Unknown or incomplete command".
• 👁️ Hide from Tab — Remove blocked commands from the / suggestion list so players don't even know the command exists.
• 🔤 Tab-Complete Filter — Blocked commands won't appear in tab completion when typing.
• 🛡️ LuckPerms Support (Optional) — Group-based bypass via reflection (no hard dependency — plugin works perfectly without LuckPerms).
• 🎬 Title Effects — Show a configurable title + subtitle when a player tries a blocked command.
• 🔊 Sound Effects — Play a configurable sound to alert the player.
• 🔄 In-Game Reload — /hxbc reload updates everything instantly without restarting the server.
• ⚡ Tab Refresh on Reload — Automatically calls player.updateCommands() so the tab suggestion list refreshes immediately after reload.
• 🔀 Namespace Support — Blocks namespaced commands like /bukkit:plugins, /minecraft:plugins, etc.

---

📋 Requirements

Requirement	Version
Server	Paper 1.21+ (Purpur, Pufferfish, Folia supported)
Java	21+
LuckPerms	5.4+ (optional)

⚠️ Not compatible with Spigot or Bukkit — this plugin uses Paper's Adventure API (MiniMessage, Components, Titles).

---

📥 Installation

1. Download the latest HxBlockerCMD.jar from Releases
2. Drop into plugins/ folder
3. Start server
4. Edit plugins/HxBlockerCMD/config.yml
5. Run /hxbc reload

---

⚙️ Default Blocked Commands

• /?, /pl, /plugins, /ver, /version
• /teammsg, /tm, /trigger
• /icanhasbukkit
• /bukkit:?, /bukkit:about, /bukkit:help, /bukkit:pl, /bukkit:plugins, /bukkit:ver, /bukkit:version
• /minecraft:help, /minecraft:me, /minecraft:msg, /minecraft:teammsg, /minecraft:tell, /minecraft:tm, /minecraft:trigger, /minecraft:w

Namespaced variants are auto-blocked (e.g. blocking plugins also blocks /bukkit:plugins and /minecraft:plugins).

---

🔐 Permissions

Permission	Default	Description
hxblockercmd.admin	op	Access to /hxbc command
hxblockercmd.bypass	op	Bypass all blocked commands

---

🛠️ Commands

Command	Description
/hxbc	Show help menu
/hxbc list	Show blocked commands
/hxbc author	Show plugin author
/hxbc version	Show plugin version
/hxbc reload	Reload config without restart

---

🔗 Links

• Source Code: GitHub
• Issues: GitHub Issues
• Releases: GitHub Releases

---

👤 Authors

• Lebynut — Development Studio
• handxt — Lead Developer