📊 Stats Plugin by Lolmewn

Stats 是一款全新的统计插件，完全从头构建，专为 Minecraft 服务器设计，能够追踪玩家在游戏中的各种行为和活动。除了提供丰富的统计功能外，Stats 还支持将数据存储到 MySQL 数据库中，方便进一步的分析和展示。

🌐 支持的统计项目

以下统计项目目前被支持并自动追踪：

• 方块破坏（包括位置、类型和时间戳）
• 方块放置（包括位置、类型、工具和时间戳）
• 游戏时长（包括世界）
• 击杀（包括世界、受害者类型、受害者名称和武器）
• 死亡（包括位置和原因）
• 射箭次数（包括世界）
• 进入床次数（包括世界）
• 倒空桶次数（包括世界和类型）
• 执行的命令（包括世界）
• 受到的伤害（包括世界和类型）
• 投掷鸡蛋次数（包括世界）
• 捕获的鱼（包括世界和类型）
• 吃掉的食物（包括世界和类型）
• 制作的物品（包括世界和类型）
• 丢弃的物品（包括世界和类型）
• 捡起的物品（包括世界和类型）
• 被踢次数（包括世界）
• 最后一次加入（包括世界）
• 最后一次退出（包括世界）
• 移动（包括世界和类型）
• PVP（包括世界、受害者类型、受害者名称和武器）
• PVP 连杀（包括世界）
• 剪羊毛次数（包括世界和类型）
• 加入次数（包括世界）
• 工具损坏（包括世界和类型）
• 交易次数（包括世界、物品和价格）
• 说的话（包括世界）
• 获得的经验（包括世界）

如果发现缺少某个统计项或功能异常，请前往 GitLab Issues 提交反馈。

🔧 插件设置

将插件的 JAR 文件放入服务器的 plugins 文件夹中。首次启动时，插件会生成一个 config.yml 文件，你需要在此文件中填写 MySQL 数据库的凭证。然后重启服务器，插件即可正常运行。

🔍 查看统计信息

使用 /stats 命令查看个人统计信息（将鼠标悬停在数值上可查看更详细的信息）。未来，还可以通过网站读取数据库并在网页上显示统计信息。

📜 告示牌功能（从 v5.3.2 开始）

放置一个告示牌，在第一行写上 [Stats]，即可开始配置该告示牌。需要注意的是，放置告示牌需要权限节点 stats.sign.place，移除告示牌需要权限节点 stats.sign.break。

可以在告示牌上显示单个、多个或随机的统计信息。此外，还可以指定单个、多个、随机或所有在线玩家显示在告示牌上。请注意，某些统计信息在使用随机玩家统计时不会显示，例如“最后一次加入”、“最后一次退出”和“PVP 连杀”，因为这些信息在随机显示时意义不大。

⚠️ 免责声明

此版本主要面向 Stats 的新用户。当前版本不会将旧版本（Stats 2 / Stats 3）的数据转换为 Stats 5 数据（尚未支持）。请关注后续更新以了解相关支持情况。此外，所有收集的统计数据将被发送到一个全局服务器，用于在网站上展示统计信息，类似于 Stats 2 的做法。

📜 Stats 3 版本信息（已停止开发）

Stats 3 是插件的旧版本，虽然仍可使用，但已不再更新。插件采用 GPLv3 许可证。开发者正在寻找新的维护者，如果你对此感兴趣，可以通过 Telegram (t.me/lolmewn) 或电子邮件 (lolmewn[at]gmail.com) 联系开发者。

📥 安装步骤

将 Stats.jar 放入服务器的 'plugins' 文件夹中。启动服务器后，插件会自动生成一个 "Stats" 文件夹，其中包含配置文件。关键的配置选项是 "storage"，可以设置为 "flatfile" 或 "mysql"。如果选择 MySQL，还需要在 mysql.yml 文件中填写 MySQL 的详细信息。

🌐 支持的统计项

以下是 Stats 3 支持的所有统计项。请注意，某些插件可能会添加额外的统计项，具体信息请参考相关插件的文档。

| Stat name         | Description                          | Available Metadata                    |
|-------------------|--------------------------------------|---------------------------------------|
| Arrows            | 射箭次数（未命中）                   | world                                 |
| Beds entered      | 进入床次数                           | world                                 |
| Blocks broken     | 破坏的方块                           | world, name, data                     |
| Blocks placed     | 放置的方块                           | world, name, data                     |
| Buckets emptied   | 倒空桶次数                           | 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             | 加入服务器次数                       | None                                  |
| Kill              | 击杀次数                             | world, weapon, entityType             |
| Last join         | 最后一次加入时间                     | world                                 |
| Last seen         | 最后一次离开时间                     | world                                 |
| Move              | 移动距离（块）                       | world, type                           |
| Omnomnom          | 吃掉的食物                           | world                                 |
| PVP               | PVP 击杀                             | world, victim, time, weapon           |
| PVP streak        | 当前 PVP 连杀                        | world                                 |
| Playtime          | 游戏时长（秒）                       | world                                 |
| Shears            | 剪羊毛次数                           | world                                 |
| Teleports         | 传送次数                             | world                                 |
| Times kicked      | 被踢次数                             | world                                 |
| Tools broken      | 工具损坏                             | world, name                           |
| Trades            | 与村民交易次数                       | world                                 |
| Words said        | 说的话                               | world                                 |
| Xp gained         | 获得的经验                           | world                                 |

🐛 问题反馈与源代码

如果发现 Bug 或希望添加新功能，或者想查看插件的源代码，请访问：Bitbucket Repository。