Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
Epic Loot Luck Finds
Progression-aware Epic Loot equipment, rare bounty upgrades, and lucky vendor offers with a one-time discovery chime. Local-host beta.
| Date uploaded | 2 weeks ago |
| Version | 1.4.0 |
| Download link | OctoberJemini-Epic_Loot_Luck_Finds-1.4.0.zip |
| Downloads | 73 |
| Dependency string | OctoberJemini-Epic_Loot_Luck_Finds-1.4.0 |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2351RandyKnapp-EpicLoot
Adds loot drops, magic items, and enchanting to Valheim.
Preferred version: 0.15.1README
Epic Loot: Luck Finds
Make every adventure—and every visit to the trader—a chance to find something special.
Luck Finds adds progression-aware equipment drops and rare upgrades to Epic Loot. Face tougher creatures for a chance at their regional equipment, hunt bounties for rewards beyond your normal progression, and discover special vendor offers with a one-time musical alert.
Version 1.4.0 — initial public beta. Requires Epic Loot 0.15.4 exactly. Designed for single-player and the local player hosting a world. Dedicated servers and remote clients are not supported.
Features
- Creature equipment matches the creature's region, capped at your next undefeated boss's region. A 0.5% lucky roll bypasses that cap to reach the creature's own region, never above it.
- Accepted main bounty targets use their contract region, with a 0.5% chance to upgrade equipment to the next region.
- Each new eligible gambling offer has a 0.5% chance to feature equipment one region above current boss progression. The upgraded equipment is visible before purchase.
- Opening the trader with new, unseen lucky stock plays a short rising chime and displays a Lucky Find message. Reopening or relogging neither repeats the announcement nor rerolls stock.
- Rarity, enchantments, equipment quantities, coins, and material drops remain controlled by Epic Loot. Lucky chances are configurable.
Boss progression and vendor gambling
Boss progression follows world boss defeats in order. Skipping a boss does not skip the progression cap.
| Next undefeated boss | Normal equipment cap | Lucky vendor equipment (0.5%) |
|---|---|---|
| Eikthyr | Meadows | Black Forest |
| The Elder | Black Forest | Swamp |
| Bonemass | Swamp | Mountains |
| Moder | Mountains | Plains |
| Yagluth | Plains | Mistlands |
| The Queen | Mistlands | Ashlands |
| Fader | Ashlands | Deep North* |
| Final configured region | Final region | No further upgrade |
The cap does not upgrade weaker creatures. Meadows creatures still yield Meadows equipment after Moder is defeated. Ordinary gambling equipment is limited by progression; its offer pool is still controlled by Epic Loot.
Creature equipment progression
| Creature's assigned region | Normal equipment | Lucky equipment (0.5%) |
|---|---|---|
| Meadows | Meadows | Meadows |
| Black Forest | Black Forest, capped by progression | Black Forest |
| Swamp | Swamp, capped by progression | Swamp |
| Mountains | Mountains, capped by progression | Mountains |
| Plains | Plains, capped by progression | Plains |
| Mistlands | Mistlands, capped by progression | Mistlands |
| Ashlands | Ashlands, capped by progression | Ashlands |
| Deep North* | Deep North, capped by progression | Deep North* |
For example, with Bonemass undefeated, a Plains creature normally yields Swamp equipment, with a 0.5% chance of Plains equipment. It cannot yield Mistlands equipment through this rule. The creature's region comes from Epic Loot's creature classification, not the player's position.
Bounty equipment progression
Accepted main bounty targets bypass the boss cap. Accompanying creatures, unaccepted targets, and abandoned quests do not receive this exception.
| Bounty region | Normal equipment | Lucky equipment (0.5%) |
|---|---|---|
| Meadows | Meadows | Black Forest |
| Black Forest | Black Forest | Swamp |
| Swamp | Swamp | Mountains |
| Mountains | Mountains | Plains |
| Plains | Plains | Mistlands |
| Mistlands | Mistlands | Ashlands |
| Ashlands | Ashlands | Deep North* |
| Deep North* | Deep North | Deep North (final tier) |
These rules apply to eligible equipment rolls. They do not guarantee that every kill drops equipment. A 0.5% chance is approximately 1 in 200 eligible rolls, not a guaranteed result every 200 attempts.
Deep North requires eligible equipment from your installed content. Progression follows Epic Loot's configured biome order. Vendor upgrades require an eligible item in the same equipment category; otherwise the original offer remains. Creature and bounty selection preserves category where possible, then falls back to the same equipment slot/type, then another eligible item in the target region. Empty region pools retain Epic Loot's boss-gated result with a warning.
Vendor details
Regular and token equipment gambles can qualify; ordinary shop sales do not. Lucky offers retain their original price and guaranteed-rarity options. Rarity and enchantments still roll when purchased. There is no second lucky upgrade roll at purchase.
Both successful and unsuccessful stock rolls are saved per world, player, stock refresh, and original offer. Existing offers keep their outcomes even if progression or settings change during that refresh interval. New stock can produce new lucky finds and a new announcement.
Installation and settings
Install with a Thunderstore-compatible mod manager and the listed dependencies. For manual installation, copy the included plugins folder into BepInEx, with Epic Loot and its dependencies already installed. Restart Valheim.
If you previously installed a private build, keep only one copy of EpicLootLuckyFinds.dll. The internal plugin identifier remains local.epicloot.luckyfinds so existing settings and saved stock remain compatible.
Settings are generated in BepInEx/config/local.epicloot.luckyfinds.cfg:
| Setting | Default | Purpose |
|---|---|---|
| General / Enabled | true | Enable Luck Finds |
| General / Chance Percent | 0.5 | Creature and bounty lucky equipment chance |
| General / Log Lucky Finds | true | Log equipment selection decisions |
| Vendor / Lucky Chance Percent | 0.5 | Lucky upgrade chance for new gambling offers |
Keep BepInEx/config/LuckyFindsStock to preserve saved vendor outcomes and announcements. Corrupt history is preserved and reported; persistence failures disable new lucky stock rather than allowing repeated rerolls.
Compatibility and beta status
While active, Luck Finds uses boss-based Epic Loot equipment gating instead of recipe-knowledge gating. Non-creature loot retains that base boss-gated behavior; existing equipment is unchanged. Unknown creature classifications also retain base gating.
This build intentionally disables itself on Epic Loot versions other than 0.15.4. Other mods that change Epic Loot gating, creature drops, or gambling may conflict. Install it on a separate test profile before adopting it in an established world.
Automated progression and stock tests passed (5,215 checks). Full in-game vendor rendering, purchase, and sound validation is still pending for this beta.
This is an independent add-on for Epic Loot, not an official Epic Loot release.
CHANGELOG
Changelog
1.5.3
- Added prominent bug-report, feature-request and source links to the main mod description.
- Documentation-only package update; mod binaries are unchanged.
1.5.2
- Added the public source repository and issue-reporting link.
- Clarified descriptions and tables: creature gear 1%, bounty gear 5%, vendor offers 5%, triple-coin bounties 20%.
- No gameplay changes from 1.5.1.
1.5.1
- Creature lucky equipment chance: 1%.
- Bounty next-region equipment chance: 5%.
- New vendor lucky equipment offer chance: 5%.
- Split the shared equipment chance into separate settings.
- Triple-coin bounties remain at 20%. Saved vendor offers retain their outcomes until refresh.
1.5.0
- Added a fixed 20% chance for newly evaluated bounty offers to pay triple coins.
- Added a gold Lucky Bounty label and tooltip; the increased reward is displayed before acceptance.
- Saved offer outcomes per world/player/bounty so browsing, relogging, and abandoning cannot reroll or multiply rewards again.
- Preserved accepted contracts, tokens, equipment rewards, target difficulty, and the existing 0.5% lucky equipment chance.
- Expanded compatibility checks to 84 requirements; API/build checks pass for Epic Loot 0.15.1–0.15.4.
- Added 100,217 automated bounty reward checks. Live in-game verification remains pending.
1.4.1
- Replaced the Epic Loot 0.15.4 exact-version restriction with startup API compatibility checks.
- Verified API and compilation compatibility with Epic Loot 0.15.1 through 0.15.4.
- Newer Epic Loot releases may load if required APIs and patch patterns remain compatible.
- Added an isolated bootstrap so compatibility checks run before the Epic Loot-dependent engine is loaded.
- Keep gameplay changes inactive until all patches install successfully; remove this mod's patches if installation fails.
- Preserve existing settings and vendor stock history.
- Updated compatibility documentation. In-game verification remains pending.
1.4.0
- Initial public beta package: progression-capped creature equipment, regional bounty rewards, persistent lucky vendor stock, and a one-time discovery chime.
- Chest, clover, and OCT icon; full progression tables.