ClientStats 插件可以跟踪并显示服务器的客户端统计信息，例如加入服务器的玩家数量、最常用的 Minecraft 版本和平均游戏时长。该插件还提供了 API，供开发者访问统计数据或获取玩家的协议/版本名称。

📊 ClientStats

📌 简介

想知道自服务器启动以来有多少玩家加入了吗？想了解最常用的版本是什么吗？平均游戏时长是多少？ClientStats 插件可以满足你的需求！

要使用版本检测功能，你的服务器需要接受多个 Minecraft 版本。你可以使用以下插件来实现：

• ViaVersion (使用最新版本)
• ProtocolSupport (使用最新版本)
• Spigot 协议破解 (1.7/1.8)

⚙️ 安装

无需配置，只需将 ClientStats.jar 文件拖放到你的 plugins 文件夹中。插件会自动创建一个配置文件，你可以根据需要编辑该文件以更改消息。

⌨️ 命令

主命令是 /clientstats，但也有更短的别名：/cstats, /cs 或 /scs。

命令列表：

• /cstats stats - 显示当天的统计信息
• /cstats version - 显示加入玩家的版本信息
• /cstats online - 显示当前在线玩家的版本信息
• /cstats player [player] - 显示指定玩家的版本信息
• /cstats reset - 重置统计数据
• /cstats reload - 重新加载配置文件
• /cstats - 显示命令列表

🔑 权限

以下权限可以访问插件的所有命令：clientstats.admin

拥有以下权限的玩家将被排除在统计之外：clientstats.exempt

也可以单独授予部分命令的访问权限：

• clientstats.cmd.stats
• clientstats.cmd.version
• clientstats.cmd.online
• clientstats.cmd.player
• clientstats.cmd.reset
• clientstats.cmd.reload

👨‍💻 开发者 API

可以使用 ClientStats API 访问统计数据或获取玩家的协议/版本名称。将 ClientStats.jar 添加到你的构建路径后，可以这样获取 API：

// 获取 ClientStatsAPI
ClientStatsAPI cstats = ClientStats.getApi();
// 检查是否可用
if (cstats != null && cstats.isVersionDetectionEnabled()) {
    // 获取玩家
    Player p = Bukkit.getPlayer("Notch");
    // 获取其协议版本 (例如：47)
    int protocolVersion = cstats.getProtocol(p.getUniqueId());
    // 获取版本名称 (例如："1.8 - 1.8.9")
    String versionName = cstats.getVersionName(protocolVersion);
}

有关源代码和 API，请参见 Github 项目。

🐛 问题和建议

请勿使用评价来报告错误或提出建议，请在 论坛讨论区 中发布，并提供尽可能多的详细信息。