# 描述
ViaVersionStatus 会报告玩家使用的 Minecraft 版本，当他们加入你的服务器时。报告会发送到你的服务器日志文件，并且向拥有 viaversionstatus.notify 权限的在线玩家发送通知。如果玩家加入时使用的客户端版本与你的服务器版本不同，插件可以选择性地向该玩家发送警告，告知他们使用的不是匹配的客户端版本。插件还可以根据客户端版本发布控制台命令。
配置文件中提供了合理的默认值，因此你可以直接将插件放入 plugins 文件夹并重启服务器。该插件需要 [ViaVersion](https://modrinth.com/plugin/viaversion) 和 Java 17+。
请注意，ViaVersion 提供了命令来显示所有当前在线玩家的版本：/viaversion list
# 权限
ViaVersionStatus 具有许多权限，可以微调其行为。但是，你真正需要做的只是向你想要接收其他玩家加入时版本通知的管理员授予 **viaversionstatus.notify** 权限。如果你授予自己 '\*' 权限，你可能还希望将 **viaversionstatus.notify.ignoresame** 设置为 false。
以下是所有 ViaVersionStatus 权限的详细信息：
## 权限详情
以下权限通常仅授予管理员，因为它们控制了玩家加入服务器时提供的游戏内通知。
**viaversionstatus.notify** - 具有此权限的玩家，当玩家加入服务器时，会收到带有玩家客户端版本的消息 (如上所示)。默认为 op。
**viaversionstatus.notify.ignoresame** - 具有此权限的玩家，如果客户端版本与服务器版本匹配，则不会收到带有玩家客户端版本的消息。默认为 false。
以下权限适用于加入你的服务器的玩家，可以用来控制何时触发 ViaVersionStatus 的哪些功能。所有以下权限默认为 false，因此只需授予玩家一个权限即可使他们免受相应的处理。大多数这些功能也可以在配置文件中禁用，以对所有玩家执行此操作。
**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-string** - 如果启用，此消息将设置为加入时客户端版本低于服务器版本的玩家。注意，要使用此功能，warn-players 必须为 true。
**warn-command** - 当玩家加入时客户端版本低于服务器版本时，控制台将执行此命令 (默认为无)。注意，要使用此功能，warn-players 必须为 true。
**warn-players-newer** - 如果为 true，则加入时客户端版本高于服务器版本的玩家将被警告，并显示 warn-string 消息。
**warn-string-newer** - 如果启用，此消息将设置为加入时客户端版本高于服务器版本的玩家。注意，要使用此功能，warn-players-newer 必须为 true。
**warn-command-newer** - 当玩家加入时客户端版本高于服务器版本时，控制台将执行此命令 (默认为无)。注意，要使用此功能，warn-players-newer 必须为 true。
**high-priority** - 当设置为 true 时，ViaVersionStatus 将在登录过程的后期运行。这在 %displayname% 在 notify-string 中无法正常工作时非常有用。
**list-supported-protocols** - 如果为 true，ViaVersion 兼容的协议(Minecraft 版本)将写入启动时的日志文件。
**block-no-light-data-warnings** - 如果为 true，ViaVersion 产生的“未找到单元格的光照数据”警告消息将被阻止。当第三方插件操纵发送给客户端的单元格数据时，可能会产生这些消息。Orebfuscator 是其中一种插件。除非这些消息困扰你，否则应保持此选项为默认的 false。
**enable-metrics** - 如果为 true，此插件将启用 bStats 统计数据，受 bStats 全局配置项的约束。
**prism-integration** - 如果为 true，ViaVersionStatus 将向 Prism 日志插件发送事件，其中包含玩家的名称和客户端版本。有关更多详细信息，请参阅以下部分。
关于 %displayname% 的说明：显示名称由其他插件设置，因此取决于其他插件的计时。特别是，EssentialsX 具有内置的时间延迟，这可能会阻止显示名称出现在发送给 op 的通知中。但是，可以使用显示名称在发送给玩家的版本警告中。
默认配置会产生上述消息。
# Prism 集成
如果你使用 [Prism](https://www.spigotmc.org/resources/prism.99397/) 日志插件，你可以让 ViaVersionStatus 在玩家加入服务器时记录每个玩家的名称和客户端版本。事件使用 vvs-client-connect 操作进行记录。你可以在查找时使用参数 a:connect 指定此操作。
为了启用 Prism 集成，你需要将 ViaVersionStatus 配置文件中的 prism-integration 设置为 true，并在 Prism 配置的允许插件列表中添加 ViaVersionStatus，位于 Prism 的跟踪部分：
```yaml
api:
enabled: true
allowed-plugins:
- ViaVersionStatus
```
如果 ViaVersionStatus 成功连接到 Prism，它将写入日志文件。
这是 Prism 查找结果的示例：
# 命令
无。
# 杂项
此插件与 ViaVersion、ViaBackwards 和 ViaRewind 兼容。
此插件使用 bStats 统计系统来提供 _匿名_ 用法数据。你可以通过更改 ViaVersionStatus 配置文件中的 **enable-metrics** 来选择退出。统计数据可在 [https://bstats.org/plugin/bukkit/ViaVersionStatus](https://bstats.org/plugin/bukkit/ViaVersionStatus) 上找到。
