AdvancedChat - 高级聊天定制

AdvancedChat 是一款易于使用的插件，可帮助你自定义服务器聊天框，使其外观更佳。它还提供了按群组自定义的系统及其他功能。如果你有想法或建议，欢迎在讨论区或 Discord 中提出！

💡重要通知

• 由于出现了一些错误，插件更新将延迟发布。我将在版本稳定无错后发布更新，感谢你的耐心。
• 在因任何错误或问题给予差评前，请先在 Discord 或 Issue Tracker 上寻求帮助。

🔧安装步骤

• 下载插件。
• 关闭服务器，以免发生错误。
• 将插件拖入服务器的 plugins 文件夹。
• 启动服务器，安装完成。

要求

• 需要 Java 8 或更高版本。

依赖插件

部分功能需要以下依赖插件才能正常工作。请点击名称前往依赖页面。

• PlaceholderAPI：提供大量变量，让你能更轻松地自定义插件。需安装其扩展才能使用这些变量。
• LuckPerms：配合 LuckPerms 可使用群组自定义系统，只需设置与权限组相同的名称即可。
• Vault：配合 Vault 可使用群组自定义系统，只需设置与权限组相同的名称即可。
• DiscordSRV：使你能在玩家加入或离开服务器时收到通知（此功能目前处于实验阶段）。

🎮命令列表

• /AdvancedChat 或 /Ac - 插件主命令的两种形式。
• /AdvancedChat help - 显示此帮助信息。
• /AdvancedChat reload - 重载插件配置文件。
• /AdvancedChat info - 显示插件信息。
• /AdvancedChat color <player> - 为指定玩家打开颜色选择 GUI。
• /ClearChat 或 /Cc - 在聊天框过于杂乱或必要时清理聊天记录。
• /Mute <player> - 禁言指定玩家。
• /UnMute <player> - 解除指定玩家的禁言。

✨权限列表

所有权限默认对 OP 玩家开放。

• AdvancedChat.*
• AdvancedChat.Update.Notify
• AdvancedChat.Reload
• AdvancedChat.Help
• AdvancedChat.Tab
• AdvancedChat.Chat.Color
• AdvancedChat.Chat.Bypass
• AdvancedChat.Gui.Color
• AdvancedChat.ClearChat
• AdvancedChat.Gui.Player
• AdvancedChat.Gui.Player.Mute
• AdvancedChat.Mute
• AdvancedChat.UnMute
• AdvancedChat.Chat.Color.*
• AdvancedChat.Chat.Color.Black
• AdvancedChat.Chat.Color.White
• AdvancedChat.Chat.Color.Dark_Gray
• AdvancedChat.Chat.Color.Gray
• AdvancedChat.Chat.Color.Dark_Purple
• AdvancedChat.Chat.Color.Light_Purple
• AdvancedChat.Chat.Color.Aqua
• AdvancedChat.Chat.Color.Dark_Aqua
• AdvancedChat.Chat.Color.Gold
• AdvancedChat.Chat.Color.Yellow
• AdvancedChat.Chat.Color.Green
• AdvancedChat.Chat.Color.Dark_Green
• AdvancedChat.Chat.Color.Blue
• AdvancedChat.Chat.Color.Dark_Blue
• AdvancedChat.Chat.Color.Red
• AdvancedChat.Chat.Color.Dark_Red
• AdvancedChat.Chat.Color.RainBow

⭐配置详解 (YAML)

以下为配置文件 config.yml 的主要内容摘要。

基础设置

• Config-Version：请不要修改此项。
• Update：启用后，当有插件更新时会通知你（不影响控制台消息）。
• Use-Default-Prefix：设为 true 使用插件默认前缀；设为 false 则使用在 Prefix 中自定义的前缀。
• Prefix：自定义前缀，例如 '&6[ &bMy Server&6 ] &7'。
• ChatFormat-Type：

- `default`：使用 Minecraft 默认聊天格式。

- `custom`：使用在 `Custom-Format` 中定义的格式。

- `group`：使用在 `Group.<name>` 中定义的格式（需要为群组添加相应权限）。

• Show-Chat-In-Console：启用或禁用在控制台显示聊天内容。
• Default-Color-Message：定义默认分配给玩家的聊天颜色。使用颜色名称（如 'white'），而非 & 符号。可用颜色列表见 Wiki。

自动清理聊天 (ClearChat)

• AutoClear.Enabled：启用或禁用自动清理功能。
• AutoClear.Default-Start-Tick：定义服务器启动后首次执行清理的 tick 数。
• AutoClear.Tick：定义自动执行清理的间隔 tick 数（默认 24000 tick，约 20 分钟）。

挂钩 (Hooks)

• Hooks.LuckPerms.Enabled：启用或禁用 LuckPerms 相关功能。
• Hooks.LuckPerms.Use-Luckperms-In-Groups：启用后，将通过 LuckPerms 系统识别群组。
• Hooks.Vault.Enabled：启用或禁用 Vault 相关功能。
• Hooks.Vault.Use-Vault-In-Groups：启用后，将通过 Vault 系统识别群组。
• Hooks.DiscordSRV.Enabled：启用或禁用 DiscordSRV 集成（实验性功能）。
• Hooks.DiscordSRV.Channel-ID：用于同步聊天内容的 Discord 频道 ID。

命令拦截器 (Command Blocker)

• Command-Blocker.Enabled：启用或禁用命令拦截功能。
• Command-Blocker.Mute-BlackList：定义被禁言玩家无法使用的命令列表。
• Command-Blocker.BlackList：定义所有玩家（包括管理）均无法使用的命令列表。

聊天格式

• Default-Format：当其他功能失效时使用的应急备份格式。
• Custom-Format：全局自定义聊天格式，影响所有玩家和群组。

- `Format`：定义聊天格式，可使用变量如 `%luckperms_prefix%`。

- `Type`：可选 `normal` 或 `modify`。

- `HoverEvent`：配置鼠标悬停时显示的文本。

- `ClickEvent`：配置点击聊天文本时的行为（执行命令、打开链接或建议命令）。

群组格式 (Groups)

• 注意：此功能目前被禁用。
• 可在此为不同群组或等级设置特定的聊天格式。
• 需要 Vault 支持，且群组名称必须与权限插件中的名称一致。
• 每个群组的配置结构与 Custom-Format 类似，包含 Format、Type、HoverEvent 和 ClickEvent。

聊天过滤 (Filter Chat)

• Filter-Chat.Enabled：启用或禁用不良词汇过滤。
• Filter-Chat.Message：当玩家使用屏蔽词时发送的提示信息。
• Filter-Chat.BadWords：需要屏蔽的词汇列表。

消息翻译

此部分包含插件所有提示信息的文本，可根据需要自定义。

❓支持与链接

• Spigot 页面：https://www.spigotmc.org/resources/advancedchat-1-7-x-1-17-x.83889/
• Songoda 市场：https://songoda.com/marketplace/product/advancedchat-chat-related.542
• Wiki（建设中）：https://jonagamerpro1234.gitbook.io/advancedchat/
• Discord：https://discord.gg/c5GhQDQCK5
• Issue Tracker：https://github.com/jonagamerpro1234/AdvancedChat/issues
• 插件统计：https://bstats.org/plugin/bukkit/AdvancedChat/8826

✨未来计划

• 本地与全局聊天频道
• 防刷屏功能
• 拦截 Tab 补全（正在 v1.7.0 开发中）
• BungeeCord 版本支持（即将到来）
• 按世界设置悬停文本