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

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.

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 left, lower to push right. Press P during a run to hide or show the overlay instantly.

[HUD] — PositionY

Distance from the top of the screen in pixels. Default: 8. Increase to move the HUD down.

[Cheats] — Enabled

Set to true to unlock luck adjustment keys (] and [) during runs. Default: false.

Requirements

• Magicraft (current version)
• BepInEx 6.0.0-be.755 IL2CPP — install via Thunderstore Mod Manager

Recommended

• GrabYaRelics — lets you equip the Prospector's Pickaxe before a run so the luck system activates from the first floor

Compatibility

• Compatible with GrabYaRelics
• No known conflicts with other Magicraft mods

Changelog

v1.0.0 — Initial Release

• Luck stat system: -100 to +100 range, resets each run
• Prospector's Pickaxe integration: gold passively contributes luck while held (default 0.10/coin, configurable)
• Win streak bonus and mercy system for losing streaks
• Shop price scaling: up to 30% cheaper at max luck, 20% more expensive at minimum
• Spell level biasing: forced tier-3 drops at +75, upgrade at +35, downgrade at -50
• HUD overlay: color-coded luck display, visible only when Pickaxe is active. Press P to hide/show
• Full BepInEx config support: LuckPerCoin, HUD position, optional cheat keys
• Compatible with GrabYaRelics