AkifsCustomCommands
使用限制、冷却时间、公共广播和完整的 Discord 日志记录,创建类似 /freevip 风格的奖励命令。
兼容 Minecraft 1.18.2 → 1.21.x,适用于 Spigot、Paper 及其分支版本。
✦ 亮点
动态命令 — 通过 [ICODE]/cac create <name>[/ICODE] 在运行时创建任意命令。无需重启,无需编辑 plugin.yml。
多步奖励 — 每个自定义命令都会执行一系列任意的控制台命令。
公共广播 — 当命令被使用时,向所有在线玩家宣布一条自定义消息。
Discord Webhook 日志记录 — 每次成功使用时发送一个本地化的嵌入卡片(Embed),包含玩家皮肤头像、广播文本、执行的命令以及剩余使用次数。
限制与计时器 — 总使用次数限制、每位玩家的使用次数限制、每位玩家的冷却时间、自动过期的活跃持续时间。
每命令权限设置(留空表示任何人都可以使用)。
现代色彩支持 — 支持传统 [ICODE]&[/ICODE] 代码、十六进制颜色 [ICODE]&#RRGGBB[/ICODE] 以及渐变色 [ICODE]gradient:#A:#Btext</gradient>[/ICODE]。
人类可读的时间格式 — 支持 [ICODE]30s[/ICODE]、[ICODE]5m[/ICODE]、[ICODE]12h[/ICODE]、[ICODE]1d[/ICODE]、[ICODE]7d[/ICODE],或组合形式如 [ICODE]1d12h[/ICODE]。
完整的多语言支持 — 内置英语、阿塞拜疆语 (Azərbaycan dili)、土耳其语 (Türkçe)。
可配置的聊天与控制台前缀(支持渐变/十六进制颜色)。
所有管理员命令均支持 Tab 补全。
✦ 快速开始
[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 嵌入卡片
每次成功使用时,都会发布一个丰富的嵌入卡片,其中包含:
作为缩略图的玩家皮肤头像
玩家名称、命令、时间戳
设置了限制时的剩余使用次数,例如 [ICODE]Server-wide: 7 of 10 left (3 used)[/ICODE]
已去除所有颜色代码/渐变效果的广播文本
已执行的控制台命令(以代码块格式显示)
所有嵌入卡片的标签均来自当前激活的语言文件 — 在 [ICODE]config.yml[/ICODE] 中更改 [ICODE]language[/ICODE],Discord 消息也会随之切换。
✦ 安装
将 [ICODE]AkifsCustomCommands-1.0.0.jar[/ICODE] 放入你的 [ICODE]plugins/[/ICODE] 文件夹。
启动服务器。插件会自动创建 [ICODE]config.yml[/ICODE]、[ICODE]commands.yml[/ICODE]、[ICODE]data.yml[/ICODE] 和 [ICODE]languages/{en,az,tr}.yml[/ICODE]。
编辑 [ICODE]config.yml[/ICODE](前缀、语言、Discord Webhook URL),然后运行 [ICODE]/cac reload[/ICODE]。
✦ 权限
[ICODE]akifscustomcommands.admin[/ICODE] — 访问 [ICODE]/cac[/ICODE](默认:op 操作员)
[ICODE]<your.permission>[/ICODE] — 可选的每命令权限,你可以通过 [ICODE]/cac setperm[/ICODE] 进行分配
✦ 注意事项
无依赖项 — 不需要 PlaceholderAPI。
异步 Webhook — Discord 消息传递在后台线程中进行;主线程永远不会被阻塞。
重载安全 — 命令会动态地注册或注销到 Bukkit CommandMap 中。
作者:Akif
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:#Btext</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
评论 0
登录后参与评分
还没有评论,来抢沙发吧