T2C-Alias - 命令别名插件

T2C-Alias 是一款适用于服务器及 BungeeCord 命令的别名插件。它允许你为常用命令创建简短的别名，并能根据玩家权限执行不同的操作，从而简化玩家体验并实现高级命令管理。

💡核心功能

• 执行多条命令：一个别名可触发多条命令的直接执行。
• 灵活的执行身份：支持以控制台或玩家身份运行命令。
• BungeeCord 支持：可以执行跨服（BungeeCord）命令。
• 管理员模式：为不同权限组的玩家设置不同的别名行为（详见下文）。
• 控制台别名：为控制台命令也设置快捷别名。
• 消息发送：通过别名向玩家发送消息，支持高级文本格式。

管理员模式详解

通过管理员模式，你可以根据玩家权限区分同一个别名的行为。

• 例如，别名 /citybuild 可以为普通玩家执行 /warp CityBuild，而为拥有特定权限（可调整）的玩家执行 /server citybuild。
• 这意味着你可以设置普通玩家传送到特定地点，而团队成员或 VIP 玩家则被传送到另一个服务器或他们最后的位置，实现高度自定义。

向玩家发送消息

本插件允许通过别名向玩家发送消息，支持使用 MiniMessage 组件和 TextBuilder 实现丰富的文本格式。

• MiniMessage 格式参考：
• Wiki: https://docs.adventure.kyori.net/minimessage/format.html
• WebUI: https://webui.adventure.kyori.net

悬停与可点击消息（需要 T2CodeHover）

此功能需要 T2CodeLib 11.9 或更高版本。

你可以为发送给玩家的所有消息添加悬停提示和/或点击动作。

示例与语法说明

• 使用 /*/ 来分隔消息的不同部分。
• 使用 [nl] 在消息或悬停文本中插入换行。

**消息格式示例**

• 带悬停的消息：<消息文本>/*/<悬停文本>
• 带悬停和点击的消息：<消息文本>//<悬停文本>//<动作>/*/<动作值>
• 仅带点击的消息：<消息文本>////<动作>/*/<动作值>

可用的点击动作

• OPEN_URL - 打开 ActionValue 中指定的 URL。
• OPEN_FILE - 打开 ActionValue 中指定的文件路径。
• RUN_COMMAND - 运行 ActionValue 中指定的命令。
• SUGGEST_COMMAND - 将 ActionValue 中的字符串插入玩家的聊天框。
• CHANGE_PAGE - 在书中切换到 ActionValue 指定的页码。
• COPY_TO_CLIPBOARD - 将 ActionValue 中的字符串复制到玩家的剪贴板。

控制台别名

可以为控制台命令设置快捷别名。

• 例如，在 Paper 服务器上，可以将繁琐的 /reload confirm 设置为简短的 /rlc。

> 提示：可以为玩家、管理员和控制台分别设置具有不同功能的别名。

🎮命令与权限

• /t2code-alias 或 /alias 或 /alias info
• 打开 T2C-Alias 插件信息。
• 所需权限：t2c.alias.command.info
• /alias reload
• 重载插件配置。
• 所需权限：t2c.alias.command.reload

权限节点列表

• t2c.alias.admin - 拥有所有 T2C-Alias 命令的权限。
• t2c.alias.updatemsg - 玩家加入服务器时，若插件有更新可用，会收到更新通知。

✨依赖

• 必需依赖：T2CodeLib

🔧开发者信息

**由 JaTiTV 开发的项目**

• T2CodeLib
• LuckyBox
• T2C-OPSecurity
• T2C-CommandGUI
• T2C-Alias
• T2C-AliasBungee
• T2C-AutomatedMessages
• T2C-AutoResponse
• T2C-AllayDuplicate
• PaPiTest

**由 Jkobs 开发的项目**

• Booster
• Invisible ItemFrames
• AntiMapCopy
• LoreEditor

T2C-Alias 是一款功能强大的 Minecraft 插件，它允许服务器管理员为复杂的命令或一系列操作创建简单易记的快捷指令（别名）。通过灵活的配置，您可以设置权限、冷却时间、经济成本，并支持跨 BungeeCord 执行命令，极大地简化了玩家的操作并丰富了服务器功能。

💡配置文件 (config.yml)

以下是 config.yml 的主要配置选项说明。

插件设置

• language: 设置插件使用的语言。
• updateCheck.onJoin: 设置为 true 时，拥有权限 t2c.alias.updatemsg 的玩家在加入服务器时会收到插件更新通知。
• updateCheck.seePreReleaseUpdates: 设置为 true 时，更新检查会包含测试版和快照版本。
• updateCheck.timeInterval: 设置检查更新的时间间隔（分钟）。

购买确认

• buy.message: 设置为 true 时，玩家为需要付费的别名完成支付后会收到确认消息。
• buy.currency: 设置经济系统的货币符号（如 $）。
• buy.confirm.use: 选择支付确认的方式，可选 COMMAND（命令）、CHAT（聊天）或 GUI（图形界面）。
• buy.confirm.gui.fillItem: 设置确认 GUI 的填充物品。

- `enabled`: 是否使用填充物品。

- `material`: 填充物品的材料（如 `BLACK_STAINED_GLASS_PANE`）。

• buy.confirm.gui.confirm.material: 确认按钮的物品材料（如 GREEN_WOOL）。
• buy.confirm.gui.cancel.material: 取消按钮的物品材料（如 RED_WOOL）。

其他设置

• subAlias.tabComplete: 设置为 true 时，子命令将显示在 Tab 补全列表中。

🎮别名声明 (aliasDeclaration.yml)

此文件用于定义具体的别名及其行为。以下是一个配置示例的结构说明。

别名基础设置

• Enable: 启用或禁用此别名。
• AliasList: 定义触发此功能的命令别名列表。

- 例如：`- aliasexample1`、`- aliasexample2`

权限设置

• Permission.Necessary: 设置为 true 时，使用此别名需要特定权限。
• Permission.Permission: 设置所需的权限节点。可使用 [alias] 占位符代表别名名称。
• Permission.CustomNoPermissionMSG: 设置自定义的无权限提示消息。留空则使用默认消息。

冷却时间

• CooldownInSec.Global: 设置此别名的全局冷却时间（秒）。设为 0 则禁用。绕过权限：t2c.alias.cooldown.global.[alias].bypass
• CooldownInSec.Player: 设置此别名的玩家独立冷却时间（秒）。设为 0 则禁用。绕过权限：t2c.alias.cooldown.player.[alias].bypass

经济成本

• Cost.Enable: 设置为 true 时，使用此别名需要支付费用。
• Cost.Price: 设置使用别名所需支付的价格。
• Cost.AllowByPass: 设置为 true 时，拥有绕过权限 (t2c.alias.buy.[alias].bypass) 的玩家可以免费使用。
• Cost.Confirm: 设置为 true 时，付费前需要玩家确认。确认方式在 config.yml 的 buy.confirm.use 中设置。

命令执行

• Command.Enable: 设置为 true 时，别名将执行一个或多个命令。
• Command.CommandAsConsole: 设置为 true 时，命令将以服务器控制台身份执行。
• Command.BungeeCommand: 设置为 true 时，命令将在 BungeeCord 上执行（需在 config.yml 中启用 BungeeCord 支持）。
• Command.Commands: 定义要执行的一个或多个命令列表。可使用 [player] 占位符代表执行命令的玩家。

消息发送

• Message.Enable: 设置为 true 时，执行别名后将向玩家发送消息。
• Message.Messages: 定义发送给玩家的消息列表。支持多行和占位符（如 [player]）。
• 消息格式支持:

- Minecraft 原版颜色代码。

- T2Code 的悬停模块：使用 `/*/` 分隔消息、悬停文本和点击动作。

- MiniMessage 格式（Adventure API）。

管理员功能

此部分允许为拥有特定管理员权限的玩家配置不同的行为。

• Admin.Enable: 启用或禁用此别名的管理员专属功能。
• Admin.Permission: 设置管理员权限节点，可使用 [alias] 占位符。
• Admin.Command: 管理员执行别名时运行的命令配置（选项同 Command 部分）。
• Admin.Message: 管理员执行别名后收到的消息配置（选项同 Message 部分）。

控制台使用

• Console.Enable: 设置为 true 时，允许在服务器控制台使用此别名。
• Console.Command: 在控制台执行此别名时运行的命令配置。
• Console.Message: 在控制台执行此别名后发送的消息配置。