Lucky Stats

Per-player luck statistics for the Lucky Block mod (Forge 1.20.1).

Stats

Each drop is scored within the broken block's own drop distribution, so results are comparable across addons with very different tier layouts:

• Average luck percentile, rolling (last 10 breaks) and all-time — 50% is statistically neutral
• Legendary / Cursed counters (only tiers with ≤3% probability count)
• Breaks per block type, total breaks, playtime, mob kills, current day
• Detected automatically if present: PureSuffering invasion count, Majrusz's Progressive Difficulty game stage

Stats are per-player and per-world, and survive death, dimension changes and End return.

Display

• Stats screen on a rebindable key (default L) and a pause-menu button
• HUD: any stat can be pinned, with a drag-and-drop editor, 9-point anchoring, per-stat color, scale, shadow and background. Layout saved client-side.

API

Other mods can store and display their own stats through the same pipeline:

• Server (com.lwi.luckystats.api.LuckyStatsApi): incrementCounter / addToLong for custom per-player counters, recordDrop(tier, tierProbability, percentile) for custom outcome engines, markBreakDeterministic() to exclude forced drops from luck stats
• Client (LuckyStatsClientApi): registerHudStat(...) for HUD lines (with optional visibility predicate), registerScreenSection(...) for stats-screen sections

Lucky Tools uses this API for its Wand statistics. Usable from KubeJS via Java.loadClass.

Requires Lucky Block. Optional: PureSuffering, Majrusz's Progressive Difficulty. Built for Lucky World Invasion Reloaded.