玩家统计工具

玩家统计

一个 Minecraft 1.20.6 Fabric 模组，用于追踪每个玩家的统计数据，并提供轻量级的游戏内经济系统。所有持久化数据均交由 自定义玩家数据 框架处理。

---

前置要求

必须安装 custom-player-data-1.0.3 模组。

---

当前可用功能

追踪

• 首次加入 — 在玩家第一次连接服务器时记录一次。
• 最后加入 — 每次连接时刷新。
• 游戏时间 — 以秒为单位累计。会话开始时间保存在内存中，并在断开连接时（或作为安全措施在 SERVER_STOPPING 时）累加到持久化总数中。/info 和 /top play_time 会将进行中的会话时间添加到显示值中，因此数字始终是最新的。

命令

命令	权限	描述
/info	所有人	显示你自己的统计数据。游戏时间格式为 X 天, Y 小时, Z 分钟。
/info <玩家>	管理员（2级）	显示其他玩家的统计数据。
/top <统计项>	所有人	前10名排行榜。基于当前连接的玩家构建（框架不提供离线数据）。

连接计数器 — join_count

• 每次成功登录时递增 join_count。
• 在 /info 中添加一行。

死亡追踪 — death_count

• 监听 ServerLivingEntityEvents.AFTER_DEATH，当 ServerPlayerEntity 死亡时递增 death_count。
• 通过 /top death_count 提供 death_count 排行榜。
• 在 /info 中添加一行。

玩家击杀追踪 — player_kills

• 当一名玩家击杀另一名玩家时，对攻击者递增 player_kills。自杀会被过滤掉。
• 通过 /top player_kills 提供 player_kills 排行榜。
• 在 /info 中添加一行。

敌对生物击杀追踪 — mob_kills_hostile

• 当玩家击杀敌对实体时递增 mob_kills_hostile。
• 通过 /top mob_kills_hostile 提供 mob_kills_hostile 排行榜。
• 在 /info 中添加一行。

被动生物击杀追踪 — mob_kills_passive

• 当玩家击杀被动实体时递增 mob_kills_passive。
• 在 /info 中添加一行“被动生物击杀数”。

经济系统 — balance

整个经济模块由 balance 统计项控制。激活后解锁以下命令：

命令	权限	描述
/balance	所有人	显示你自己的余额。
/balance <玩家>	管理员（2级）	显示其他玩家的余额。
/pay <玩家> <金额>	所有人	转账。如果源余额不足或目标是自己，则拒绝转账。
/money <玩家> give <金额>	管理员（2级）	向玩家余额添加金钱。
/money <玩家> take <金额>	管理员（2级）	扣除金钱 — 最低为零，永不为负。
/money <玩家> set <金额>	管理员（2级）	将玩家余额设置为指定值。

激活 balance 还会在 /info 中添加一条带样式的“余额”行，并在 /top 中添加一个 balance 条目。

---

语言支持

• 英语
• 法语

---

安装

1. 为 Minecraft 1.20.6 安装 Fabric Loader：https://fabricmc.net/use/installer/
2. 下载 1.20.6 版本的 Fabric API，并将 .jar 文件放入你的 mods/ 文件夹。
3. 将 player-statistics.jar 放入同一个 mods/ 文件夹。
4. 启动游戏！