AkifsCustomCommands

AkifsCustomCommands

Create your own /freevip-style reward commands with limits, cooldowns, public broadcasts and full Discord logging.

Compatible with Minecraft 1.18.2 → 1.21.x on Spigot, Paper and forks.

✦ Highlights

Dynamic commands — create any command at runtime via [ICODE]/cac create <name>[/ICODE]. No restart, no plugin.yml edits. Multi-step rewards — every custom command runs an arbitrary list of console commands. Public broadcasts — announce a custom message to every online player when the command is used. Discord webhook logging — sends a localized embed on every successful use, with the player's skin head, broadcast text, executed commands and remaining usage count. Limits & timers — total limit, per-player limit, cooldown per player, auto-expiring active lifetime. Per-command permissions (empty = everyone can use it). Modern colors — legacy [ICODE]&[/ICODE]-codes, hex [ICODE]&#RRGGBB[/ICODE] and gradients [ICODE]<gradient:#A:#B>text</gradient>[/ICODE]. Human-readable durations — [ICODE]30s[/ICODE], [ICODE]5m[/ICODE], [ICODE]12h[/ICODE], [ICODE]1d[/ICODE], [ICODE]7d[/ICODE], or combined like [ICODE]1d12h[/ICODE]. Full localization — bundled English, Azərbaycan dili, Türkçe. Configurable prefix for chat AND console (gradient/hex supported). Tab completion for every admin command.

✦ Quick start

[CODE]

/cac create freevip

/cac addcmd freevip lp user %player_name% parent addtemp vip 7d

/cac addcmd freevip eco give %player_name% 1000

/cac addbcast freevip <gradient:#3FFF5C:#5CC8FF>%player_name%</gradient> earned 7 days of VIP!

/cac setlimit freevip 10

/cac setplayerlimit freevip 1

/cac setcooldown freevip 1d

/cac setduration freevip 7d

/cac setperm freevip myserver.freevip

[/CODE]

✦ Discord webhook embed

Each successful use posts a rich embed that contains:

Player's skin head as the thumbnail Player name, command, timestamp Remaining uses when a limit is set, e.g. [ICODE]Server-wide: 7 of 10 left (3 used)[/ICODE] Broadcast text with all color codes/gradients stripped Console commands that were executed (formatted as a code block) All embed labels come from the active language file — change [ICODE]language[/ICODE] in [ICODE]config.yml[/ICODE] and the Discord message switches with it.

✦ Installation

Drop [ICODE]AkifsCustomCommands-1.0.0.jar[/ICODE] into your [ICODE]plugins/[/ICODE] folder. Start the server. The plugin auto-creates [ICODE]config.yml[/ICODE], [ICODE]commands.yml[/ICODE], [ICODE]data.yml[/ICODE] and [ICODE]languages/{en,az,tr}.yml[/ICODE]. Edit [ICODE]config.yml[/ICODE] (prefix, language, Discord webhook URL) and run [ICODE]/cac reload[/ICODE].

✦ Permissions

[ICODE]akifscustomcommands.admin[/ICODE] — access to [ICODE]/cac[/ICODE] (default: op) [ICODE]<your.permission>[/ICODE] — optional per-command permission you assign with [ICODE]/cac setperm[/ICODE]

✦ Notes

No dependencies — PlaceholderAPI is not required. Async webhook — Discord delivery happens on a background thread; the main thread is never blocked. Reload-safe — commands are dynamically (un)registered into the Bukkit CommandMap.

Author: Akif