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.