Herochat - 最佳聊天频道插件

💡Herochat 5：强大的聊天频道系统

Herochat 5 是一个为大型服务器设计的、高度可配置的聊天频道系统。它完全重写了旧版本，旨在让玩家聊天变得易于管理和阅读。每个频道都是一个独立的聊天室，玩家可以同时加入多个频道，但每次只能在其中一个“激活”频道中发言。

🎮主要特性

• 可配置的聊天频道：创建并自定义各种频道。
• 密码保护频道：为频道设置访问密码。
• 基于权限的保护：几乎所有操作（加入、发言、管理等）都可通过权限控制。
• 频道管理：支持踢出、封禁、禁言等管理功能。
• 快速消息：无需切换激活频道即可向其他频道发送消息。
• 私聊系统：包含 /msg 或 /tell 命令，支持持续的私人对话。
• 简易集成：可轻松兼容大多数其他插件（如 Towny、Factions）的聊天标签。
• 基于正则表达式的消息审查：过滤不当言论。

✨依赖与权限

依赖

• 本插件需要 Vault 才能运行。

权限节点

以下是 Herochat 的主要权限节点列表。其中 <channel> 需替换为对应频道的小写名称。

• 基础与管理权限
• herochat.create：允许创建频道。
• herochat.save：允许强制保存玩家/频道数据。
• herochat.reload：允许强制重载玩家/频道数据。
• herochat.mod：允许使用 /ch mod。
• herochat.mute：允许使用 /ch mute。
• herochat.pm：允许使用 /msg。
• herochat.emote：允许使用传统表情动作。

• 频道特定权限
• herochat.emote.<channel>：允许在指定频道使用表情。
• herochat.join.<channel>：允许加入指定频道。
• herochat.leave.<channel>：允许离开指定频道。
• herochat.speak.<channel>：允许在指定频道发言。
• herochat.kick.<channel>：允许从指定频道踢出成员。
• herochat.ban.<channel>：允许在指定频道封禁成员。
• herochat.mute.<channel>：允许在指定频道禁言成员。
• herochat.remove.<channel>：允许删除指定频道。
• herochat.color.<channel>：允许在聊天中使用 &c 类颜色代码。
• herochat.info.<channel>：允许对指定频道使用 /ch info。
• herochat.autojoin.<channel>：首次登录时强制自动加入指定频道。
• herochat.focus.<channel>：允许玩家将指定频道设为激活频道。
• herochat.force.join.<channel>：每次登录时强制玩家加入指定频道。
• herochat.force.leave.<channel>：每次登录时强制玩家离开指定频道。

• 频道修改权限
• herochat.modify.nick.<channel>：允许更改频道昵称。
• herochat.modify.color.<channel>：允许更改频道颜色。
• herochat.modify.distance.<channel>：允许更改频道收听距离。
• herochat.modify.format.<channel>：允许更改频道消息格式。
• herochat.modify.shortcut.<channel>：允许更改频道是否启用快速消息。
• herochat.modify.password.<channel>：允许更改频道密码。
• herochat.modify.verbose.<channel>：允许更改频道是否显示加入/离开消息。

• 高级权限
• herochat.admin.stealth：隐藏用户，使其不被“无人听到你”检测发现。
• herochat.admin.unignore：用户不会被他人忽略。
• herochat.color.colortype.channel：允许使用粗体/斜体等格式（仅限最新开发版）。

注意：部分权限会自动授予频道管理员（可在主配置中修改）。大多数服务器会授予所有人 herochat.join.、herochat.speak. 和 herochat.leave.* 权限，然后对受限频道使用否定权限（例如，在 bPermissions 中使用 ^herochat.join.staff）来收回权限。

🔧配置与使用

创建与配置频道

使用命令 /ch create <name> [<nick>] 创建频道，其中 <name> 为频道名，<nick> 为昵称（可选）。创建后，频道配置文件将位于 plugins/Herochat/channels 目录下。

您可以通过文件编辑器手动修改配置，或使用游戏内的 /ch set 命令进行设置。输入 /ch set ? 可获取该命令的详细信息。

配置项说明

• name：频道名称。
• nick：频道昵称。
• password：频道密码（留空表示无密码）。
• color：频道颜色（使用 Wiki 上的代码或通用名称）。
• distance：玩家间能听到消息的最大距离（0 为全局）。
• shortcut：设置为 Allowed 时，允许使用 /<nick> <msg> 快速发送消息而无需切换激活频道。
• worlds：频道允许的世界列表。
• bans：被封禁的玩家列表。
• mutes：被禁言的玩家列表。
• moderators：频道管理员列表。
• format：频道消息格式（可用标签见下方“消息格式标签”部分）。
• verbose：启用加入/离开消息提示。
• focusable：允许使用 /ch <channel> 将该频道设为激活频道。

重载与保存

• 手动修改配置文件后，使用 /ch reload 加载更改。注意：这会覆盖在此期间通过游戏内命令所做的更改。
• 如需强制保存通过游戏内命令所做的更改，请使用 /ch save。

消息格式标签

在频道格式中，可使用以下标签

• {default}：默认格式（位于 config.yml 中）。
• {name}：频道名称。
• {nick}：频道昵称。
• {color}：频道颜色。
• {msg}：消息内容。
• {sender}：发送者的显示名称。
• {plainsender}：发送者的用户名。
• {world}：发送者所在的世界。
• {prefix}：发送者的前缀。
• {suffix}：发送者的后缀。
• {group}：发送者的主用户组。
• {groupprefix}：发送者主用户组的前缀。
• {groupsuffix}：发送者主用户组的后缀。
• {convoaddress}：显示“To”或“From”（仅用于私聊消息）。
• {convopartner}：发送者或接收者（仅用于私聊消息）。

⭐本地化与开发者

本地化

Herochat 5.5 及更高版本支持国际化。语言环境由 config.yml 中的 locale 设置指定，默认为 en_US（美式英语）。当前可用的本地化包括 en_US（英语/美国）、de（德语）和 pt_BR（葡萄牙语/巴西）。如果您有兴趣将 Herochat 翻译成未列出的语言，请通过私信告知。

开发者信息

您可以通过监听 ChannelChatEvent 来获取基于频道的消息信息。此自定义事件包含消息发送者（Chatter 对象）、消息发送到的频道、消息发送尝试的结果（Chatter.Result 对象）以及导致 ChannelChatEvent 的原始 Bukkit PlayerChatEvent。

如果您更改了消息要发送到的频道，应调用 event.setResult(event.getSender().canSpeak(newChannel))，除非您想忽略发送消息前的常规检查。

❓常见问题解答 (FAQ)

• 问：权限中的 <channel> 是什么意思？
• 答：<channel> 部分应替换为相应频道的小写名称。

• 问：如何让 Herochat 显示 XYZ 插件的数据？
• 答：每个插件处理聊天修改的方式不同。许多插件会在消息格式中搜索特定字符串（例如 Towny 的 {town}）并将其替换为数据。您需要查阅每个插件的文档，了解其对消息格式的要求。

• 问：为什么自动加入功能不起作用？
• 答：授予 herochat.autojoin.<channel> 权限仅在玩家首次登录服务器时生效。更具体地说，这仅在玩家登录时没有 chatter 文件的情况下有效。如果用户之前登录过（且 Herochat 处于活动状态），则会加载其之前的频道，自动加入将不起作用。此行为与旧版 Herochat 一致。

• 问：为什么我的所有消息都显示 [world]，而频道格式中没有 {world} 标签？
• 答：这是另一个插件添加的文本。最常见的插件是 Multiverse。请查阅 Multiverse 的配置以禁用它。

• 问：有哪些命令？
• 答：在游戏中输入 /ch help 可查看 Herochat 的命令列表。您可以通过提供问号 (?) 作为第一个也是唯一的参数来获取特定命令的详细信息，例如 /ch join ? 将提供关于 join 命令的更多信息。

• 问：可以移除某个命令吗？XYZ 命令与另一个插件冲突。
• 答：据我所知，Bukkit 仍然不允许动态注销命令，因此无法实现。但是，您可以打开 Herochat.jar 内的 plugin.yml 文件，删除任何不需要的命令/别名。

• 问：为什么我的管理员重新登录时会被踢出所有频道？
• 答：您可能正在使用 PEX，并且可能授予了管理员 权限。这意味着他们被授予了 herochat.force.leave. 权限，并在每次登录时被强制离开所有频道。您需要停止授予 权限，或否定 herochat.force.leave. 权限来解决此问题。

🔧支持与捐赠

支持

Herochat 的问题报告和功能请求应发布在此线程中。您也可以加入 esper.net IRC 服务器的 #Heroes 频道提问。

捐赠

众所周知，创建和维护此类插件需要大量的时间和精力。如果您喜欢使用 Herochat，请考虑捐赠以支持其开发。

点击此处捐赠支持我们！

其他资源

• Townships：融合 Factions 和 Towny 优点的最佳领地插件！
• Heroes Premium：最佳 Minecraft 职业与技能 RPG 插件！包含：
• ✫ 血与火 ✫ 符文与狂怒 ✫ 歌与宁静 ✫
• ✫ 工艺与增益 ✫ 奥术与恐惧 ✫ 荣誉与自然 ✫
• ✫ 死亡与神圣 ✫ 潜行与飞镖 ✫