Logo
HxBlockerCMD
PluginMIT

HxBlockerCMD

Lightweight Paper 1.21+ command blocker plugin with vanilla-style error messages.

9
Downloads
0
Followers
4 weeks ago
Updated
📦
1
Versions
managementutilityfoliapaperpurpur
Download Latestv2.0.0View on Modrinth

📖About 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

👤 Authors

  • Lebynut — Development Studio
  • handxt — Lead Developer