CommandAlias - 简易命令别名插件

💡简介

CommandAlias 是一款轻量级、易于设置的服务器插件，它允许你为命令创建自定义别名，且不会触发聊天过滤器，也不会在控制台产生重复日志。它支持 PlaceholderAPI，配置简单直观，适合任何配置经验的服主使用。

🎮如何安装？

安装过程非常简单

• 下载插件文件。
• 将其拖放至服务器的 plugins 文件夹。
• 重启服务器即可。

插件兼容所有服务器版本，无需担心兼容性问题。

⭐配置指南

配置文件设计得非常简单且功能强大。默认配置结构如下（以 gamemode 命令为例）：

gamemode:
  aliases:
    - gm
  enabled: true

• gamemode 是原始命令。
• 在 aliases 下添加的条目（如 gm）将成为新的快捷命令。
• 配置后，玩家输入 /gm 即可执行 /gamemode 命令。
• 如果未在配置中指定权限节点，插件将不会进行权限检查。
• 如果某个别名被禁用（enabled: false），例如 peepsonline，则输入该命令会显示“未知命令”。

发送自定义消息

你还可以通过别名发送自定义消息。只需在命令标签前加上前缀 -msg-，并将第一个 aliases 值设为你想要发送的消息（支持颜色代码）。

连接到其他 Bungee 服务器

你可以为连接到其他 Bungee 子服创建别名。只需在服务器名前加上前缀 -server-（确保名称与 Bungee 配置中的完全一致）。如果玩家不是通过 Bungee 网络连接的，此命令将不会生效。

为每个别名设置权限

你可以在配置中为每个别名设置独立的权限节点。缺少该权限的玩家将无法使用此别名。如果不需要权限，将此字段留空即可。

执行控制台命令

从 1.6 版本开始，你可以在别名被执行时运行控制台命令。可以使用 %alias% 等占位符。

list:
  aliases:
    - peepsonline
  console-command: 'say %name% just ran %alias%!'

此功能支持参数占位符（详见下文），但不会自动附加多余的参数。

添加自定义别名时，你可以直接编辑现有配置块，或复制一个区块并进行修改。

🔧高级功能

如果你需要更复杂的功能，以下高级选项可供使用。

参数占位符

对于带有复杂参数的命令（如 /lp user Potato parent set GroupName），你可以使用 {0}, {1} ... {n} 这样的占位符来重新排列参数顺序。

例如

'lp user {1} parent set {2}':
  aliases:
    - setgroup
  enabled: true

这将允许玩家输入 /setgroup xEline Cheescake 来执行命令。未使用的参数会自动附加在命令末尾，除非你使用的占位符索引超出了提供的参数数量。

一个别名执行多个命令

如果你想通过一个别名触发多个命令，可以进行如下设置：

• 在高级设置中，将 keep-iterating-when-match 设为 true。
• 在配置中创建多个指向同一别名的命令区块。

运行条件

从 1.5 版本起，你可以为别名添加运行条件。只需在别名配置下添加 conditions 部分即可。支持的条件有：

• args：命令输入的参数数量。
• world：玩家所在的世界（也支持世界列表）。
• gamemode：玩家的游戏模式。
• health：玩家的生命值。

你可以为一个别名设置多个条件。

允许无权限时执行原命令

此功能意味着，如果玩家没有该别名的使用权限，插件将忽略此事件，让其他插件（或服务器本身）来处理这个命令。这可以与运行条件结合使用。

❓命令与权限

插件提供以下游戏内管理命令

• /ca reload - 重载配置文件。需要权限：commandalias.reload
• /ca toggle - 启用/禁用别名节点。需要权限：commandalias.toggle

如果命令执行出错，插件会给出明确提示，无需在控制台翻找日志。

✨占位符支持

插件内置以下占位符

• %name% - 发送者的用户名。
• %display_name% - 发送者的显示名。

同时，插件完全支持 PlaceholderAPI，你可以使用任何已安装的 PlaceholderAPI 占位符。

🔧源码与 API

如果你对插件的技术细节感兴趣（尽管它非常简洁），可以在 GitHub 查看源码（插件使用 Kotlin 编写）。插件还提供了用于管理别名、运行条件和占位符的 API。

💡获取帮助与反馈

如果你遇到问题，我们很乐意提供帮助

• 加入 Discord 支持频道：https://discord.gg/c2myRcs
• 在频道中 @Me gusta 或发布讨论帖。

🔧统计信息 (bStats)

本插件集成了 bStats，用于收集匿名的服务器统计信息，例如：

• 玩家数量
• 服务器是否处于在线模式
• 服务器版本和插件版本
• CPU 核心数、系统架构、操作系统
• Java 版本等

如果你不希望分享这些信息，可以在插件目录下的 bStats 文件夹内的配置文件中禁用它。更多信息请访问：https://bstats.org

如果你觉得这个插件有帮助，请务必留下评论和建议，帮助我们改进！