ViaVersionStatus - 玩家客户端版本显示

ViaVersionStatus 是一款用于报告玩家客户端版本的插件。当玩家加入服务器时，它会将玩家使用的 Minecraft 版本信息记录到日志，并通知拥有相应权限的在线管理员。此外，它还能向使用不匹配客户端版本的玩家发送警告，并可根据版本执行控制台命令。

💡核心功能

• 记录玩家加入时的客户端版本至服务器日志。
• 向拥有 viaversionstatus.notify 权限的在线玩家发送版本通知。
• 可向使用与服务器版本不符的客户端（过旧或过新）的玩家发送警告消息。
• 可根据玩家版本，在后台执行预设的控制台命令。
• 提供与 Prism 日志插件的集成功能。

🎮需求与依赖

• 必需插件: ViaVersion
• Java 版本: Java 17 或更高版本
• 兼容性: 与 ViaBackwards、ViaRewind 兼容。

🔧快速开始

插件提供了合理的默认配置，安装后即可使用。

• 将插件放入服务器的 plugins 文件夹。
• 重启服务器。
• （可选）给予管理员 viaversionstatus.notify 权限以接收游戏内通知。

注意：ViaVersion 本身提供了 /viaversion list 命令来查看所有在线玩家的版本。

⭐权限说明

所有权限默认均为 false。给予玩家相应权限可使其免于对应的处理。

管理员通知权限

以下权限通常仅授予管理员，用于控制玩家加入时的游戏内通知。

• viaversionstatus.notify - 拥有此权限的玩家将在其他玩家加入时收到包含其客户端版本的消息。默认对 OP 生效。
• viaversionstatus.notify.ignoresame - 拥有此权限的玩家，当加入玩家的客户端版本与服务器版本一致时，将不会收到通知消息。默认为 false。

玩家豁免权限

用于控制特定玩家触发 ViaVersionStatus 哪些功能。

• viaversionstatus.exempt - 使该玩家在加入时免于所有处理。
• viaversionstatus.exempt.log - 使该玩家加入时的客户端版本不被记录到日志。
• viaversionstatus.exempt.notify - 使该玩家加入时不会通知其他玩家，同时也不会触发配置的“加入通知命令”。
• viaversionstatus.exempt.notify.message - 仅使该玩家加入时不会通知其他玩家。
• viaversionstatus.exempt.notify.command - 仅使该玩家加入时不会触发配置的“加入通知命令”。
• viaversionstatus.exempt.warn - 使使用旧版本客户端加入的该玩家免于收到警告，同时也不会触发对应的警告命令。
• viaversionstatus.exempt.warn.message - 仅使该玩家免于收到旧版本警告消息。
• viaversionstatus.exempt.warn.command - 仅使该玩家免于触发旧版本警告命令。
• viaversionstatus.exempt.warn.newer - 使使用新版本客户端加入的该玩家免于收到警告，同时也不会触发对应的警告命令。
• viaversionstatus.exempt.warn.newer.message - 仅使该玩家免于收到新版本警告消息。
• viaversionstatus.exempt.warn.newer.command - 仅使该玩家免于触发新版本警告命令。

✨配置详解

配置文件中的字符串可使用以下变量

• %player% - 玩家名称。
• %displayname% - 玩家显示名称（由其他插件设置）。
• %version% - 玩家的客户端版本。
• %server% - 检测到的服务器版本。

字符串需用双引号 ("...") 包裹，并可使用标准 Minecraft 颜色代码。

通知设置

• notify-ops - 设为 true 时，任何玩家加入服务器都会向 OP 通知其客户端版本。
• notify-string - 当玩家加入时，发送给拥有 viaversionstatus.notify 权限玩家的消息。
• notify-command - 当玩家加入时，由控制台执行的命令（默认为无）。

版本警告设置

旧版本客户端警告：

• warn-players - 设为 true 时，使用比服务器版本旧的客户端加入的玩家将收到警告。
• warn-string - 发送给使用旧版本客户端玩家的警告消息（需启用 warn-players）。
• warn-command - 当使用旧版本客户端的玩家加入时，由控制台执行的命令（需启用 warn-players）。

新版本客户端警告：

• warn-players-newer - 设为 true 时，使用比服务器版本新的客户端加入的玩家将收到警告。
• warn-string-newer - 发送给使用新版本客户端玩家的警告消息（需启用 warn-players-newer）。
• warn-command-newer - 当使用新版本客户端的玩家加入时，由控制台执行的命令（需启用 warn-players-newer）。

高级设置

• high-priority - 设为 true 时，插件将在登录流程的后期运行。如果 notify-string 中的 %displayname% 不生效，可以尝试启用此项。
• list-supported-protocols - 设为 true 时，启动时会将 ViaVersion/ProtocolSupport 支持的协议版本写入日志。
• block-no-light-data-warnings - 设为 true 时，将屏蔽 ViaVersion 产生的 “No light data found for chunk” 警告信息。这些信息可能在第三方插件（如 Orebfuscator）操作区块数据时产生。除非这些信息造成困扰，否则建议保持默认值 false。
• enable-metrics - 设为 true 时，启用本插件的 bStats 匿名使用数据统计。您可以在全局 bStats 配置中统一设置。
• prism-integration - 设为 true 时，启用与 Prism 日志插件的集成。

关于 %displayname% 的注意事项：显示名称由其他插件设置，因此其可用性取决于其他插件的执行时机。例如，EssentialsX 存在内置延迟，可能导致 OP 通知中无法显示该名称。但该变量可用于发送给玩家的版本警告消息中。

🔧Prism 集成

若您使用 Prism 日志插件，可以让 ViaVersionStatus 在玩家加入时记录其名称和客户端版本。

启用步骤

• 在 ViaVersionStatus 配置文件中，将 prism-integration 设为 true。
• 在 Prism 配置文件的追踪 (tracking) 部分，将 ViaVersionStatus 添加到允许插件列表中：

   api:
     enabled: true
     allowed-plugins:
       - ViaVersionStatus

启用成功后，ViaVersionStatus 会在日志中记录已成功挂钩到 Prism。

查询结果

• 记录的动作 (action) 为：vvs-client-connect
• 在 Prism 查询时，可使用参数：a:connect

❓常见问题

• 有命令吗？ 本插件没有命令。
• 如何查看所有在线玩家的版本？ 可以使用 ViaVersion 自带的命令：/viaversion list。
• 如何禁用数据统计？ 在配置文件中将 enable-metrics 设为 false，或修改 bStats 的全局配置。统计数据页面位于：https://bstats.org/plugin/bukkit/ViaVersionStatus