KibbleCommands

KibbleCommands is a command alias manager plugin for Paper, Spigot, and Folia servers running Minecraft 1.21 and newer. It allows server administrators to create dynamic custom command aliases, run command sequences, configure cooldowns, charge economy costs, and manage aliases through an in-game GUI.

---

Features

   
• Client Command Autocomplete Sync: Sends command updates to player clients (player.updateCommands()) when aliases are modified or reloaded—no relogs needed.
   
• Multi-Command Chaining: Execute multiple commands sequentially from a single alias input.
   
• PlaceholderAPI Support: Parses %papi\_placeholders% in command targets, feedback messages, and permission warnings alongside built-in placeholders ({player}, {args}, {cooldown\_remaining}, {warmup\_remaining}).
   
• Database Cooldown Persistence: Store player command cooldowns across restarts or multi-server proxy networks using SQLite or MySQL. All database operations run asynchronously.
   
• Warmup Delays: Configure countdown delays before command execution. Warmups automatically cancel if the player moves or takes damage.
   
• Vault Economy Integration: Charge player balance directly when executing an alias (requires Vault).
   
• Random Execution Selection: Select one command at random from a configured list of options (mode: "random").
   
• Event Triggers: Automatically execute console commands on player join (on-join), first join (on-first-join), or death (on-death).
   
• In-Game Administration: Manage aliases using commands (/kc add, /kc edit, /kc remove, /kc history) or the interactive GUI (/kc gui).

---

Commands & Permissions

                                                                                                                                                                                                                                                                                                                                                                                                                                                                               

Command	Usage	Description	Default Permission
/kibblecommands	/kc	Main plugin command router	kibblecommands.admin
/kc gui	/kc gui	Open the admin GUI menu	kibblecommands.gui
/kc edit	/kc edit <alias> <command...>	Modify an existing alias target	kibblecommands.admin
/kc remove	/kc remove <alias>	Delete an alias	kibblecommands.admin
/kc history	/kc history <player>	View player audit log records	kibblecommands.admin
/kc reload	/kc reload	Reload configuration & reset cache	kibblecommands.reload

Cooldown Bypass Permissions

   
• kibblecommands.cooldown.bypass — Bypass cooldown restrictions for all aliases.
   
• kibblecommands.cooldown.bypass.<alias> — Bypass cooldown restrictions for a specific alias.

---

Requirements & Compatibility

   
• Minecraft Version: 1.21+ (including 1.21.x, 26.x)
   
• Server Platform: Paper, Purpur, Spigot, Bukkit, Folia
   
• Java Runtime: Java 21 or higher
   
• Optional Dependencies: Vault (for economy costs), PlaceholderAPI (for placeholder expansion)