ClientStats - 玩家统计与版本追踪

本插件目前处于测试阶段。如有任何问题，请在讨论区反馈！

你是否好奇过，自服务器启动以来有多少玩家加入过？最常用的游戏版本是什么？平均游戏时长又是多少？这款插件正是你所需要的答案。

💡前置条件

要启用版本检测功能，你的服务器必须能够接受多个 Minecraft 版本。你可以使用以下任一方式实现：

• 使用 ViaVersion（请使用最新版）
• 使用 ProtocolSupport（请使用最新版）
• 使用 Spigot 协议破解（适用于 1.7/1.8 版本）

请注意，启用多版本支持并非强制要求，但这是使用版本检测功能的前提。

🎮安装与配置

安装非常简单，无需额外配置。

• 将 ClientStats.jar 文件拖放至服务器的 plugins 文件夹。
• 重启服务器后，插件会自动生成配置文件，你可以根据需要编辑其中的所有提示信息。

🔧命令列表

插件的基础命令是 /clientstats，同时提供以下简写别名：/cstats、/cs 或 /scs。

• /cstats stats - 查看今日的统计数据
• /cstats version - 查看所有加入过服务器的玩家版本
• /cstats online - 查看当前在线玩家的版本
• /cstats 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();

// 检查 API 是否可用
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 项目页面。

❓问题与建议

• 请勿在评论中提交 Bug 或功能建议。
• 请前往插件的讨论区发帖，并提供尽可能详细的信息。