ViaVersionStatus 插件用于报告玩家加入服务器时使用的 Minecraft 版本。报告会发送到服务器日志文件，并发送给具有 viaversionstatus.notify 权限的在线玩家。如果玩家使用的客户端版本与服务器版本不同，插件可以选择发送警告。

🎉 插件介绍

🎉 插件介绍

📍 插件描述

• ViaVersionStatus 会在玩家加入服务器时报告他们使用的 Minecraft 版本。
• 报告会发送到服务器日志文件和具有 viaversionstatus.notify 权限的在线玩家。
• 如果玩家使用的客户端版本与服务器版本不同，插件可以选择向玩家发送警告消息。
• 插件还可以根据客户端版本执行控制台命令。
• 插件需要 ViaVersion 或 ProtocolSupport (或两者)，请确保已安装至少其中一个插件。

📍 注意事项

• ViaVersion 提供了一个命令来显示所有当前在线玩家的版本：/viaversion list
• ProtocolSupport 具有类似的命令：/ps list

📍 权限说明

ViaVersionStatus 具有一些权限，可以用来微调其行为。最基本的使用是授予管理员 viaversionstatus.notify 权限，以便他们在其他玩家加入时收到游戏内的版本通知。

📍 管理员权限

以下权限通常只授予管理员，因为它们控制着玩家加入服务器时收到的游戏内通知。

• 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 将在登录过程的后期运行。如果 notify-string 中的 %displayname% 未按预期工作，这将非常有用。
• list-supported-protocols - 如果为 true，则 ViaVersion 和/或 ProtocolSupport 支持的协议（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 日志记录插件，则可以让 ViaVersionStatus 在每个玩家加入服务器时记录他们的姓名和客户端版本。该事件使用操作 vvs-client-connect 记录。您可以在查找期间使用参数 a:connect 指定此操作。

为了启用 Prism 集成，您需要在 ViaVersionStatus 配置文件中将 prism-integration 设置为 true，并且需要将 ViaVersionStatus 添加到 Prism 配置文件的跟踪部分的允许插件列表中：

api:
  enabled: true
  allowed-plugins:
  - ViaVersionStatus

如果 ViaVersionStatus 成功连接到 Prism，它将写入日志文件。

以下是 Prism 查找结果的示例：

📍 命令

无。

📍 其他

• 此插件与 ViaVersion、ViaBackwards、ViaRewind 和 ProtocolSupport 兼容。ViaVersionStatus 将与这四个插件的任何有效组合一起使用。
• 此插件使用 bStats 指标系统来提供匿名使用数据。您可以通过更改 ViaVersionStatus 配置文件中的 enable-metrics 来选择退出。这些指标可在 https://bstats.org/plugin/bukkit/ViaVersionStatus 上获得。

📍 默认配置文件

#
# ViaVersionStatus configuration file
#
# Strings in this file can use four variables:
#    %player% is replaced with the player's name
#    %displayname% is replaced with the player's "display name"
#    %version% is replaced with the version of the player's client
#    %server% is replaced with the detected server version
# You can also use the standard Minecraft color codes.
# Strings should be enclosed in double quotes ("...")
#
# notify-ops - If true, ops will be notified of the client's version when any player joins the server
# notify-string - This message is sent to players with the viaversionstatus.notify permission when any player joins the server
# notify-command - This command is issued by the console when a player joins the server (defaults to none)
# warn-players - If true, players joining with a client that is older than the server version will be warned with the warn-string message
# warn-string - This message is set to players joining with a client that is older than the server version, if enabled. Note that warn-players must be true to use this.
# warn-command - This command is issued by the console when a player joins with a client that is older than the server version (defaults to none).  Note that warn-players must be true to use this.
# warn-players-newer - If true, players joining with a client that is newer than the server version will be warned with the warn-string message
# warn-string-newer - This message is set to players joining with a client that is newer than the server version, if enabled. Note that warn-players-newer must be true to use this.
# warn-command-newer - This command is issued by the console when a player joins with a client that is newer than the server version (defaults to none).  Note that warn-players-newer must be true to use this.
# high-priority - When set to true, ViaVersionStatus will run later in the login process. This can be useful if %displayname% in notify-string is not working as expected.
# list-supported-protocols - If true, the protocols (Minecraft versions) supported by ViaVersion and/or ProtocolSupport will be written to the log file at startup
# block-no-light-data-warnings - If true, the "No light data found for chunk" warning messages produced by ViaVersion will be blocked.
# enable-metrics - If true, bStats metrics will be enabled by this plugin, subject to the bStats global config entry
# prism-integration - If true, ViaVersionStatus will send an event to the Prism logging plugin, with the player's name and client version.
#
notify-ops: true
notify-string: "&e%displayname%&6 joined with &a%version%&6 on &2%server%"
notify-command: ""
warn-players: true
warn-string: "&cYou are using an older version of Minecraft. Please update to &e%server%&c!"
warn-command: ""
warn-players-newer: false
warn-string-newer: "&cYou are using a newer version of Minecraft. Please use version &e%server%&c!"
warn-command-newer: ""
high-priority: false
list-supported-protocols: false
block-no-light-data-warnings: false
enable-metrics: true
prism-integration: false