ClientStats [Bungee] - ClientStats - 玩家统计

本插件目前处于测试阶段。如发现任何问题，请在讨论区提交报告！

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

要使用版本检测功能，你的服务器需要能够接受多个 Minecraft 版本，但这并非强制要求。要支持多版本，你可以选择以下方案之一：

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

✨安装与配置

无需任何配置，只需将 ClientStats.jar 文件拖入服务器的 plugins 文件夹即可。插件会自动生成配置文件，你可以根据需要编辑其中的所有提示信息。

🎮命令列表

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

命令详情

• /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();

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

请访问 GitHub 项目页面以获取源代码和完整的 API 文档。

❓问题与建议

请勿在评论中提交错误报告或功能建议。请务必在讨论区发帖说明，并提供尽可能详细的信息。