Lucky Stats

幸运统计

为 Lucky Block 模组（Forge 1.20.1）提供每位玩家的运气统计。

统计数据

每次掉落都会根据被破坏方块自身的掉落分布进行评分，因此即使不同附属模组的等级分布差异很大，结果仍可比较：

• 平均运气百分位数：滚动统计（最近 10 次破坏）和累计统计；50% 表示统计意义上的中性水平
• 传奇 / 诅咒计数（仅统计概率 ≤3% 的等级）
• 按方块类型统计的破坏次数、总破坏次数、游戏时长、击杀生物数、当前天数
• 若检测到以下模组，则自动显示：PureSuffering 入侵次数、Majrusz’s Progressive Difficulty 游戏阶段

统计数据按玩家和世界分别记录，死亡、切换维度及从末地返回后仍会保留。

显示

• 按可重新绑定的按键（默认 L）打开统计界面，也可通过暂停菜单按钮打开
• HUD：可固定任意统计项，并通过拖放编辑器调整布局；支持 9 点锚定、每项单独设置颜色、缩放、阴影和背景。布局保存在客户端本地。

API

其他模组可以通过同一套流程存储并显示自己的统计数据：

• 服务器（com.lwi.luckystats.api.LuckyStatsApi）：使用 incrementCounter / addToLong 添加自定义的玩家计数器，使用 recordDrop(tier, tierProbability, percentile) 记录自定义掉落机制的结果，使用 markBreakDeterministic() 将强制掉落排除在运气统计之外
• 客户端（LuckyStatsClientApi）：使用 registerHudStat(...) 注册 HUD 统计行（可选可见性谓词），使用 registerScreenSection(...) 注册统计界面分区

Lucky Tools 使用此 API 统计其 Wand 数据。可通过 Java.loadClass 在 KubeJS 中使用。

需要 Lucky Block。可选：PureSuffering、Majrusz’s Progressive Difficulty。为 Lucky World Invasion Reloaded 打造。