LuckyBreak

LuckyBreak

AI-assisted mod — built with Claude AI and verified through in-game testing.

Adds a visible Luck stat to Magicraft that grows with your gold and rewards you for playing well. Find the Prospector's Pickaxe and watch your wealth start working for you.

🐛 Found a bug or have a feature idea? Submit it here

How Luck Works

Luck is a value ranging from -100 to +100. It starts at 0 each run and shifts based on your playstyle and what relics you hold. Higher luck bends the game in your favor — cheaper shops, better spells. Let it go negative and things get harder.

Building Luck

The Prospector's Pickaxe (Money is Power relic)

This is your primary luck engine. Equip it and your current gold balance passively contributes to luck every second — you don't spend the gold, you simply hold it. The richer you are, the luckier you feel.

• Default: +0.10 luck per coin (configurable)
• 50 gold → +5 luck | 100 gold → +10 luck | 200 gold → +20 luck

Win Streaks

Consecutive successful runs build momentum. Each unbroken streak adds bonus luck at the start of your next run, giving skilled players an early advantage.

Mercy Bonus

If you've been losing repeatedly, the system notices. A small mercy bonus at run start keeps you from spiraling into permanent bad luck.

Cheats Mode (optional)

Set Enabled = true under [Cheats] in the config file to unlock luck adjustment keys during runs:

• ] — add +0.5 luck
• [ — subtract 0.5 luck

What Luck Affects

Shop Prices

Luck scales every item price in the shop. This affects everything sold — relics, potions, and spells.

• +100 luck → prices drop to ×0.70 (30% cheaper)
• 0 luck → prices unchanged
• -100 luck → prices rise to ×1.20 (20% more expensive)

Since Magicraft's shop prices scale with floor depth and rarity, this effect compounds across a full run. At high luck, late-game items that would normally be out of reach become attainable. At negative luck, even early items can strain your budget.

Spell Level Drops

Luck biases the quality of spell drops throughout each run.

• +75 luck and above → all spell drops are forced to level 3 (maximum quality)
• +35 to +74 luck → spell levels are upgraded by one tier
• -50 luck and below → spell levels are downgraded by one tier
• Neutral → no change to spell drops

Gold Bonus (Pickaxe Relic Only)

When the Prospector's Pickaxe is equipped, your gold actively contributes to your luck stat. This creates a self-reinforcing loop: more gold → more luck → cheaper shops → easier to accumulate more gold. Protect your purse.

The HUD

When the Prospector's Pickaxe is active, a small overlay appears showing your current luck value. It's color-coded — green when luck is positive, red when negative, white when neutral. Win and loss streaks of 2 or higher also appear alongside the number.

The HUD is invisible until you obtain the relic, and won't clutter runs where it isn't relevant.

Controls

| Key | Action |

|-----|--------|

| P | Hide or show the luck overlay (works any time during a run) |

| ] | Add +0.5 luck (requires Cheats mode — see config) |

| [ | Subtract 0.5 luck (requires Cheats mode — see config) |

Configuration

A config file is generated at BepInEx/config/com.effcoding.LuckyBreak.cfg — open it in any text editor to adjust the gold-luck rate, reposition the HUD, or enable the cheat keys for testing.

[Pickaxe Relic — Gold Luck] — LuckPerCoin

Controls how much luck each coin contributes while holding the Pickaxe.

| LuckPerCoin | 50g | 100g | 200g | 500g | Gold to cap |

|-------------|-----|------|------|------|-------------|

| 0.05 | +2.5 | +5 | +10 | +25 | ~2000 (subtle) |

| 0.08 | +4 | +8 | +16 | +40 | ~1250 (noticeable) |

| 0.10 | +5 | +10 | +20 | +50 | ~1000 (default) |

| 0.15 | +7.5 | +15 | +30 | +75 | ~666 (strong) |

| 0.20 | +10 | +20 | +40 | cap | ~500 (dominant) |

At +100 luck, shop prices are 30% cheaper and spells drop at maximum level.

[HUD] — HUDOffsetFromRight

Shifts the HUD left from the right edge of the screen. Default: 8. Raise to move further