UltraCommand - 自定义命令插件

UltraCommand 是一款允许服务器管理员创建无限数量自定义命令的插件。这些命令可以向执行者发送消息、以玩家身份运行指令，甚至以控制台身份执行操作。它曾是一款流行的 Bukkit 插件，后一度被弃用。本分支版本已针对 Minecraft 1.7 至 1.18 版本进行了修复、重映射和错误修补，使其重获新生。

💡核心功能

• 创建无限自定义命令：可以定义任意数量的自定义命令，每条命令可包含多行文本或操作。
• 多种命令类型：
• text：向玩家发送消息。
• chat：强制玩家发送聊天消息。
• pcmd：以玩家身份执行命令。
• ccmd：以控制台身份执行命令。
• 支持变量替换：在命令内容中使用 $p、$a、$1 等占位符来引用玩家名、参数等动态信息。
• 权限集成：每个自定义命令都可关联独立的权限节点。
• 实时配置：支持通过命令 /uc reload 重载配置，或 /uc save 手动保存。

🎮命令用法

主命令为 /uc 或 /ultracommand。

添加命令或元素

• /uc add <name> - 创建一个名为 <name> 的新命令。
• /uc add text <name> <text> - 向命令 <name> 添加文本行（支持 & 颜色代码）。
• /uc add chat <name> <chat> - 向命令 <name> 添加聊天消息。
• /uc add pcmd <name> <command> - 向命令 <name> 添加以玩家身份执行的命令。
• /uc add ccmd <name> <command> - 向命令 <name> 添加以控制台身份执行的命令。

管理与查看

• /uc list [name] - 列出所有命令，或指定命令 <name> 的详细内容。
• /uc remove <name> - 删除整个命令 <name>。
• /uc remove text/chat/pcmd/ccmd <name> - 删除命令 <name> 中指定类型的全部内容。
• /uc reload - 从磁盘重载配置文件。
• /uc save - 将游戏内的修改保存到磁盘（系统也会每分钟自动保存）。

🔧变量替换列表

在命令内容中可使用以下变量

• $p - 执行此自定义命令的玩家用户名。
• $d - 执行此自定义命令的玩家显示名。
• $a - 传递给自定义命令的所有参数，以空格分隔。
• $1, $2, $3... - 传递给自定义命令的第1、2、3...个参数。
• $2+, $3+... - 从第2、3...个参数开始的所有参数，功能类似 $a。

✨应用示例

屏蔽原版命令

覆盖 `/op` 命令，使无权限玩家收到提示

/uc add text op &6&l&oPrefix &f&l&o> &cYou do not have access to this command.

权限节点：ultracommand.commands.op

创建社交媒体命令

创建 /discord 命令来回复服务器邀请链接：

/uc add text discord &3&l&oDiscord &f&l&o> &e&nhttps://discord.invite.link/

权限节点：ultracommand.commands.discord

组合多个命令（脚本）

将多个世界的 /stopfire 命令合并为一个 /StopAllFire 命令：

/uc add ccmd StopAllFire stopfire A
/uc add ccmd StopAllFire stopfire B
...（为世界 C、D、E、F 重复添加）

权限节点：ultracommand.commands.stopallfire

创建命令别名

将 /lightning 别名设置为 /smite：

/uc add smite lightning

为长命令创建无需玩家权限的别名

将长传送命令 /tppos <player> <x> <y> <z> 简化为 /base，并通过控制台执行：

/uc add ccmd base tppos $p <x> <y> <z>

权限节点：ultracommand.commands.base

创建美观的等级列表命令

使用多行 text 元素创建 /ranks 命令，展示带颜色的服务器等级列表。

（详细代码较长，原理为多次使用 /uc add text ranks <带颜色代码的文本> 逐行构建）

创建欢迎命令

创建 /welcome <玩家名> 命令，在聊天中欢迎新玩家：

/uc add welcome
/uc add chat welcome Welcome to YourServer, $1!

（$1 会被替换为命令中的 <玩家名> 参数）

创建夜视效果命令

创建 /nightvision 命令，给予玩家1小时的夜视效果：

/uc add nightvision
/uc add ccmd nightvision effect $p 16 3600 10

权限节点：ultracommand.commands.nightvision

你还可以为其创建别名 `/nv`

/uc add pcmd nv nightvision

权限节点：ultracommand.commands.nv

⭐权限列表

• ultracommand.configure - 允许使用 /uc 和 /ultracommand 管理命令。
• ultracommand.commands.* - 允许使用所有通过本插件创建的自定义命令。
• ultracommand.commands.<name> - 允许使用特定的自定义命令 <name>。

❓注意事项与链接

• 本分支仍在开发中，但已修复了 1.7 至 1.18 版本中的已知错误。
• 官方 Wiki 地址：https://ultracommand.pluginwiki.xyz
• 开发构建版本可在 GitHub 的发布页面找到，但使用风险自负，它们可能未经充分测试。
• 在配置中提及原版命令 minecraft:op 时，请注意书写格式（例如 minecraft:op），避免因表情符号转换导致问题。