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 reloadupdates 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
- Download the latest
HxBlockerCMD.jarfrom Releases - Drop into
plugins/folder - Start server
- Edit
plugins/HxBlockerCMD/config.yml - 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
