Stats - 玩家数据统计

💡Stats 插件简介

Stats 是一款高级的统计数据收集插件，专注于追踪玩家的各类游戏行为。从破坏方块、游戏时长到 PVP 击杀等，信息详尽。数据可存储为文件或 MySQL 数据库，后者便于将玩家数据展示在网站上。当前版本为完全重写的 Stats 5，包含诸多新特性。

🎮支持的统计项

当前版本追踪并支持以下统计信息（均包含详细元数据）：

• 方块破坏（包含位置、类型与时间戳）
• 方块放置（包含位置、类型、工具与时间戳）
• 游戏时长（包含所在世界）
• 击杀（包含世界、受害者类型、受害者名称与武器）
• 死亡（包含位置与原因）
• 射出的箭（包含世界）
• 进入床的次数（包含世界）
• 清空的桶（包含世界与类型）
• 执行的命令（包含世界）
• 受到的伤害（包含世界与类型）
• 扔出的鸡蛋（包含世界）
• 钓到的鱼（包含世界与类型）
• 消耗的食物（包含世界与类型）
• 合成的物品（包含世界与类型）
• 丢弃的物品（包含世界与类型）
• 拾取的物品（包含世界与类型）
• 被踢出的次数（包含世界）
• 最后加入时间（包含世界）
• 最后退出时间（包含世界）
• 移动（包含世界与移动类型）
• PVP 击杀（包含世界、受害者类型、受害者名称与武器）
• PVP 连杀（包含世界）
• 剪羊毛次数（包含世界与类型）
• 加入次数（包含世界）
• 工具损坏（包含世界与类型）
• 村民交易（包含世界、物品与价格）
• 说出的话语（包含世界）
• 获得的经验（包含世界）

> 如果发现任何统计项缺失或工作异常，请在此提交问题：https://gitlab.com/lolmewn/stats-plugin/issues

🔧插件安装与设置

快速安装

• 将 Stats 的 JAR 文件放入服务器的 plugins 文件夹。
• 首次启动服务器时，插件会生成 config.yml 配置文件。
• 在配置文件中填入你的 MySQL 数据库凭据。
• 重启服务器，插件即可正常运行。

查看个人数据

• 玩家可以使用 /stats 命令查看自己的统计数据。
• 将鼠标悬停在数值上可以查看更详细的信息。

未来功能

未来将支持构建网站来读取数据库，并在网页上展示统计信息。

✨告示牌功能（自 v5.3.2 起）

Stats 支持使用告示牌动态显示统计数据。

设置方法

• 放置一个告示牌，在第一行输入 [Stats]。
• 系统将自动开始引导你配置该告示牌。

权限节点

• 放置 Stats 告示牌需要权限：stats.sign.place
• 破坏 Stats 告示牌需要权限：stats.sign.break

显示选项

• 统计项：可以显示单个、多个或随机一项统计。
• 玩家：可以指定单个、多个、随机或所有在线玩家的数据。

> 注意：当为所有在线玩家显示随机统计时，部分统计项（如“最后加入”、“最后退出”、“PVP 连杀”）不会显示，因为这些数据在此情境下意义不大。

❓重要说明与免责声明

数据迁移

• 此版本主要面向 Stats 的新用户。
• 当前版本暂不支持将旧版 Stats 2 / Stats 3 的数据迁移到 Stats 5 的数据库中。请关注后续更新。

数据收集

• 所有收集的统计数据会被发送到一个全局服务器，用于在未来网站上展示统计信息（类似于 Stats 2 的做法）。

插件状态

• 本插件采用 GPLv3 许可证。
• 开发者正在为插件寻找新的维护者。如果你有兴趣，可以通过 Telegram (t.me/lolmewn) 或电子邮件 (lolmewn[at]gmail.com) 联系。

---

⭐Stats 3（旧版）信息

以下为上一代插件 Stats 3 的详细信息。该版本仍可使用，但已停止开发。

插件描述

Stats 3 是一个高级的统计数据收集插件，专注于玩家统计。支持将数据存储为简单文件或 MySQL 数据库。使用数据库的优点是，你可以利用任何兼容的网页前端将玩家数据展示在你的网站上。

如何安装

• 将 Stats.jar 拖放至服务器的 plugins 文件夹。
• 启动服务器，会在插件目录下生成 Stats 文件夹及配置文件。
• 配置文件中最关键的选项是 storage，可设置为 flatfile（文件存储）或 mysql（数据库存储）。
• 如果选择 MySQL，还需配置 mysql.yml 文件中的数据库连接信息。

兼容的网页前端

• BlueStats

可用的统计项列表

以下是所有可用的统计项。请注意，其他插件可能会向 Stats 添加自定义统计项，具体请参考相关插件的文档。

• Arrows：射出的箭数（未命中也算） | 元数据：world
• Beds entered：进入床的次数 | 元数据：world
• Blocks broken：破坏的方块数 | 元数据：world, name, data
• Blocks placed：放置的方块数 | 元数据：world, name, data
• Buckets emptied：清空的桶数 | 元数据：world
• Buckets filled：装满的桶数 | 元数据：world
• Commands done：执行的命令数 | 元数据：world
• Damage taken：受到的伤害 | 元数据：world, cause
• Death：死亡次数 | 元数据：world, cause
• Eggs thrown：扔出的鸡蛋数 | 元数据：world
• Fish caught：钓到的鱼数 | 元数据：world
• Items crafted：合成的物品数 | 元数据：world, name
• Items dropped：丢弃的物品数 | 元数据：world, name
• Items picked up：拾取的物品数 | 元数据：world, name
• Joins：加入服务器的次数 | 元数据：无
• Kill：击杀数 | 元数据：world, weapon, entityType
• Last join：最后加入时间（毫秒级纪元时间） | 元数据：world
• Last seen：最后离开时间（毫秒级纪元时间） | 元数据：world
• Money：功能尚未实现 | 元数据：world
• Move：移动的方块数 | 元数据：world, type（0=行走，1=船，2=矿车，3=猪，4=矿车中的猪，5=马，6=飞行）
• Omnomnom：吃掉的食物数 | 元数据：world
• PVP：PVP 击杀数 | 元数据：world, victim, time, weapon
• PVP streak：当前连杀数（死亡后重置） | 元数据：world
• PVP top streak：历史最高连杀数 | 元数据：world
• Playtime：游戏时长（秒） | 元数据：world
• Shears：剪羊毛次数 | 元数据：world
• Teleports：传送次数 | 元数据：world
• Times kicked：被踢出次数 | 元数据：world
• Tools broken：工具损坏次数 | 元数据：world, name
• Trades：与村民交易次数 | 元数据：world
• Votes：仅当 Votifier 启用时工作 | 元数据：无
• Words said：说话字数 | 元数据：world
• Times changed world：切换世界次数 | 元数据：无
• Xp gained：获得的总经验值 | 元数据：world

问题反馈与源代码

发现漏洞？需要新功能？想了解 Stats 的构建方式？

请访问：https://bitbucket.org/Lolmewn/stats/overview