好运属性

Lucky Stats

为 幸运方块 Mod（Forge 1.20.1）提供的每位玩家运气统计。

统计

每次掉落都会在被破坏方块的自身掉落分布中进行评分，因此结果可以跨不同层级布局的 Addon 进行比较：

• 平均运气百分位数，包括滚动（最近 10 次破坏）和全部时间——50% 表示统计中立
• 传奇 / 诅咒计数器（仅计算概率 ≤3% 的层级）
• 每种方块类型的破坏次数、总破坏次数、游戏时间、怪物击杀数、当前天数
• 如果存在则自动检测：PureSuffering 入侵计数、Majrusz 的渐进难度游戏阶段

统计数据按每位玩家和每个世界分别记录，在死亡、维度变更和返回末地后仍然保留。

显示

• 可通过可重新绑定的按键（默认为 L）和暂停菜单按钮打开统计界面
• HUD：支持任意统计数据的固定显示，带有拖放编辑器、9 点锚定、每项统计颜色、缩放、阴影和背景。布局保存在客户端。

API

其他 Mod 可以通过相同的流程存储和显示自己的统计数据：

• 服务端（com.lwi.luckystats.api.LuckyStatsApi）：incrementCounter / addToLong 用于自定义每玩家计数器，recordDrop(tier, tierProbability, percentile) 用于自定义结果引擎，markBreakDeterministic() 用于排除强制掉落的运气统计
• 客户端（LuckyStatsClientApi）：registerHudStat(...) 用于 HUD 行（附带可选的可见性判断条件），registerScreenSection(...) 用于统计界面分区

Lucky Tools 使用此 API 实现其魔杖的统计数据。可通过 KubeJS 使用 Java.loadClass 调用。

---

需要幸运方块。可选：PureSuffering、Majrusz 的渐进难度。专为 Lucky World Invasion Reloaded 构建。