VentureChat - 顶级频道聊天插件

💡重要须知

VentureChat 是 VENTUREMC 的官方聊天插件，在 Spigot 上被评为排名第一的 Bukkit 聊天资源。其强大之处在于无与伦比的灵活性，无论是大型还是小型服务器，Bukkit 还是 BungeeCord 网络，它都能完美运行。本插件包含大量可配置和可开关的独特功能，涵盖聊天相关的方方面面。

🎮核心功能

频道系统

• 可控聊天：玩家可以加入想听的频道，离开不想听的频道。
• 频道权限：可为频道设置权限，例如创建仅限管理员或赞助者的频道。
• 频道距离：可为频道配置收听距离，例如用于城镇或本地聊天。
• 频道冷却：可为频道设置消息发送冷却时间，并提供可绕过冷却的权限。
• 跨服频道：频道消息可发送到 BungeeCord 网络中的其他服务器。
• Towny 与 Factions 频道：支持为 Towny、Nation 和 Factions 创建特殊频道。

聊天格式与交互

• JSON 格式化：可根据配置中的自定义 JSON 组，为玩家前缀和名称配置悬停消息。
• 自定义格式：可使用默认的频道、队伍和消息格式，或使用格式功能创建自己的格式。
• 颜色支持：可为每个频道设置两种颜色（标签颜色和聊天文本颜色），并支持 Hex 颜色代码。
• 快速聊天：玩家可使用 /channel [消息] 直接向指定频道发送消息，而无需切换频道。
• PlaceholderAPI：所有 PlaceholderAPI 占位符均可在聊天格式、JSON 格式和管理 GUI 中使用。

管理与审核

• 禁言功能：可在单个频道或所有频道禁言玩家，并可设置定时解禁。
• 代理禁言：可通过 BungeeCord 代理禁言网络内任何服务器上的玩家。
• 强制操作：可强制单个或所有玩家发送消息或执行命令。
• 聊天过滤器：可在配置中设置过滤器，屏蔽不雅词汇或任何自定义内容。
• 反垃圾信息：可选择启用反垃圾信息功能，自动禁言刷屏者。
• 游戏内配置编辑：可在游戏内编辑配置，插件将自动重载以实现即时更新。

社交与集成

• 队伍聊天：玩家可以加入或创建队伍，形成私人聊天组。
• Vault 支持：支持 Vault 以显示玩家前缀，任何与 Vault 兼容的权限插件均可使用。
• 隐身插件支持：安装 VanishNoPacket 后，将无法向隐身的玩家发送私信（Bungee 网络下无效）。
• MySQL 日志：可选择使用 MySQL 数据库记录服务器上的所有聊天和命令。
• BungeeCord 同步：禁言状态、频道数据、间谍和命令间谍设置将在整个网络中自动同步。

扩展与兼容

• 跨服消息：将插件安装到 BungeeCord 的插件文件夹即可启用跨服消息功能。
• Velocity 支持：现已支持 Velocity 代理。
• EssentialsDiscord 初步支持：已提供对 EssentialsDiscord 的初步支持。
• 命令间谍自定义格式：支持自定义命令间谍的显示格式。
• 消息完全可定制：所有消息文本均可自定义。

🔧安装与要求

前置需求

• Java 版本：请使用 Java 17 或更高版本。
• 必需插件：本插件需要安装 Vault、ProtocolLib 和 PlaceholderAPI 才能运行。
• 兼容性注意：VentureChat 不能 与 EssentialsChat 同时使用，请确保未安装 EssentialsChat。

安装步骤

• 将 VentureChat.jar 文件拖入服务器的 plugins 文件夹。
• 如需使用跨服消息，请同时将 VentureChat.jar 拖入 BungeeCord 的 plugins 文件夹。
• 安装完成后，重启服务器（和/或代理）。

可选依赖与扩展

• DiscordSRV 与 PurpleIRC：支持与这些插件联动，请访问其插件页面下载并设置。
• MineverseChat API 移植：如果其他插件依赖 MineverseChat API，请同时安装此扩展（通常不需要）。

❓配置与使用提示

初始配置

安装后，plugins 文件夹内会生成 VentureChat 配置目录。您可以修改其中的配置文件来设置频道、格式等。配置文件内包含一些基础示例频道，您可以自由创建自己的频道。详细配置指南请查阅 Wiki。

专业技巧

如何创建基于群组的聊天颜色频道？

在频道配置中，将 chatcolor 设置为 "None"，并确保在 format 字段的末尾包含您的颜色代码或占位符。

示例

Global:
  color: dark_green
  chatcolor: "None"
  # ... 其他配置
  format: '&f[&2Global&f] {vault_prefix} {player_displayname}&2:{vault_suffix}'

占位符不显示？

• 请确保您安装了最新版本的 PlaceholderAPI。
• 下载必要的扩展，例如：

  /papi ecloud download Player
  /papi ecloud download Vault
  /papi ecloud download [其他插件]
  /papi reload

更新前请注意

• 下载新版本前，请务必阅读更新日志。
• 如果消息格式不工作，请检查您的配置是否已更新至新的 PlaceholderAPI 系统。可参考 defaultconfig.yml 获取最新的干净配置文件。

关于 offline_mode_acknowledgement 设置

• IP 转发 适用于 Spigot 服务器（如果您未使用，配置中会说明原因）。
• 如果您运行的是离线（破解）服务器，您会知道（需要单独的注册/登录插件）。
• 默认应将此设置保持为 OFF，以启用保护机制，防止在线和离线模式数据混淆，这可能导致错误。
• 长话短说：除非您运行的是“破解”服务器，否则请保持该设置为 OFF。

✨命令、权限与占位符

命令与文档

完整的命令和权限列表可在 FineGamers 的 GitHub 仓库查看（源代码位于 Bitbukkit）。

• 命令与权限文档：[点击此处查看](HERE)
• 注意：/setnickname 命令已被移除，请使用专用的昵称插件，如 NickNamer、Essentials、CMI 等。

特殊权限摘要

• venturechat.message.bypass - 允许悬停查看被删除的消息。
• venturechat.color - 允许使用所有传统颜色和 Hex 颜色。
• venturechat.color.legacy - 仅允许使用 16 种传统颜色。
• venturechat.format - 允许使用格式代码。
• venturechat.cooldown.bypass - 绕过频道冷却时间。
• venturechat.spy.override - 防止自己被聊天间谍监视。
• venturechat.commandspy.override - 防止自己的命令被命令间谍监视。
• venturechat.mute.offline - 允许禁言离线玩家。
• venturechat.json.[jsonFormatName] - 允许使用特定的 JSON 格式。
• 更多队伍 (venturechat.party.*)、忽略、清屏等权限，请查阅完整列表。

PlaceholderAPI 占位符示例

• {venturechat_channel_prefix} - 频道前缀
• {venturechat_channel_name} - 频道名称
• {venturechat_channel_color} - 频道标签颜色
• {venturechat_channel_chatcolor} - 频道聊天颜色
• {venturechat_channel_is_bungee} - 是否为 Bungee 频道
• {venturechat_channel_cooldown} - 频道冷却时间
• {venturechat_channel_distance} - 频道收听距离

⭐获取帮助与已知问题

获取帮助

• 如需帮助或有任何疑问，请在 讨论区 提问，我们会及时回复。
• 请附上您的配置文件和日志，以便快速准确地解决问题。
• 请不要在评论中请求帮助。
• 查看有用的指南和常见问题解答，请访问 [VentureChat Wiki](VentureChat Wiki)。
• 西班牙语评测视频由 [@Maximiliano](@Maximiliano) 提供。

已知问题

• 消息移除功能在 1.19+ 版本上目前无法工作，这是一个已知问题。
• 更多已知问题将在此处更新。

计划新增功能

• 更多的 BungeeCord 同步功能。
• 其他功能建议请在 讨论区 提出，而非在评论中。