asCMD - Armor Stand Command - Great for lobby servers! - asCMD - 盔甲架指令插件

💡简介

本插件是 Minecraft 服务器上为盔甲架添加右键点击命令最简单、最优秀的解决方案。它非常轻量，并且能够保护绑定了命令的盔甲架，防止其被破坏或物品被窃取。

🎮功能特性

• 添加命令：为盔甲架绑定点击后执行的命令。
• 保护机制：自动保护已绑定命令的盔甲架，防止其被破坏或物品被窃取。
• 点击控制：支持为左键、右键、潜行点击等不同交互方式绑定不同的命令。
• 命令类型：支持以玩家身份、控制台身份执行命令，或通过 BungeeCord 传送玩家。
• 向后兼容：旧版本的所有盔甲架命令在此版本中完全兼容。

🔧命令与权限

命令列表

• /ascmd edit

切换编辑模式。仅在编辑模式下，才能修改或破坏盔甲架上的物品。

• /ascmd addcmd [rRlL] <method> <command>

为盔甲架添加命令。具体用法见下文。

• /ascmd clear

清除盔甲架上的所有命令。

• /ascmd info

在聊天栏显示盔甲架上的所有命令。

• /ascmd reload

重载插件配置文件。

• /ascmd config <key> <value>

无需手动编辑 config.yml，直接设置配置项。可用键名：

• msgToConsole
• enableLeftClick
• cooldownMs

• /ascmd update

检查插件是否有新版本。

权限节点

• ascmd.admin

使用所有子命令的权限。

• ascmd.update

当有可用更新时接收通知的权限。

✨使用方法

添加普通命令

• 执行命令：/ascmd addcmd <console/player> <命令>。

- 例如：`/ascmd addcmd console say %player% is the best`

- 可使用 `%player%` 占位符，它将被点击玩家的昵称替换。

• 右键点击目标盔甲架。
• 完成。

添加 BungeeCord 传送命令

• 执行命令：/ascmd addcmd bungee <服务器名>。

- 例如：`/ascmd addcmd bungee kitpvp`

• 右键点击目标盔甲架。
• 完成。

清除命令

• 执行命令：/ascmd clear。
• 右键点击目标盔甲架以删除其所有命令。
• 完成。

为特定点击方式添加命令

通过命令中的 [rRlL] 参数来指定点击方式：

• r：启用非潜行状态下的右键点击。
• R：启用潜行状态下的右键点击。
• l：启用非潜行状态下的左键点击。
• L：启用潜行状态下的左键点击。

**示例**

• 仅右键点击执行：/ascmd addcmd rR console say Clicked with RMB
• 仅非潜行左键点击执行：/ascmd addcmd l bungee survival
• 仅潜行点击执行：/ascmd addcmd LR player me is sneaky

**说明**

• 可以自由组合字母，例如 rRlL。
• 如果省略此参数，命令将对所有点击方式生效。
• 左键点击功能需要在配置文件中启用 enableLeftClick 选项。

命令执行方式

• console：指定的命令将以控制台身份执行。
• player：指定的命令将以点击玩家的身份执行。
• bungee：将玩家传送至指定的 BungeeCord 服务器。例如：/ascmd addcmd bungee kitpvp

❓配置说明

配置文件为 config.yml，主要内容如下：

format-version: '2' # 请勿修改此项
config:
  msgToConsole: true # 为 true 时，控制台会收到玩家点击盔甲架执行命令的日志
  enableLeftClick: false # 为 true 时，玩家可以左键点击盔甲架触发命令
  cooldownMs: 100 # 点击冷却时间（毫秒/玩家）。设置为 1000 则表示玩家每秒最多使用一次盔甲架

⭐注意事项与兼容性

• 兼容性：插件与 plugin.yml 中注册的命令以及 PlayerCommandPreprocessEvent 事件完全兼容。
• 版本：插件主要针对特定版本测试，但可能在其他版本上运行。
• 声明：您可以反编译此插件进行研究，但请勿声称是您自己的作品，保留 SpigotMC 原帖链接即可。
• 反馈：欢迎在本插件页面提出建议，可能会在后续版本中加入。
• 致谢：这是作者制作的第一个插件，感谢所有用户的支持。