Lucky Trinket & Great Fortune Trinket

A Valheim mod that adds two Utility-slot charms for EpicLoot: the Lucky Trinket raises the rarity floor of nearby loot, and the Great Fortune Trinket additionally adds your worn equipment to nearby drop pools.

Thunderstore package: EpicLoot_LuckTrinket Localization: English / Simplified Chinese / Traditional Chinese

Features

• Rarity floor for nearby drops: magic gear dropped near the wearer never rolls below the trinket's own rarity.
  • It never upgrades drop quality — low rolls are simply removed (discarded), so EpicLoot's original rarity odds stay untouched.
  • Equipment and unidentified items below the floor are discarded (they never drop).
  • Quality materials (shards, crafting materials, runestones) may still drop up to MaterialTolerance steps below the floor (default 1 = one step below is kept).
  • Plain materials (coins, wood, etc.) are unaffected.
• Great Fortune Trinket - worn equipment pool injection: your enchantable worn gear is added to nearby drop pools, so you can find your own equipment as loot.
  • Injected items take WornPoolShare of the pool's total weight (default 0.2 = about 20% yours / 80% original); the original loot pool is never blocked or removed.
  • Injected items roll the pool's original rarity odds — no clamping, no quality upgrades.
  • Per-item relative weights: held weapon x2, utility items x0.4 (ExtraSlots only), everything else x1.
  • Ammo, stackable and restricted items are skipped (they cannot be enchanted).
• Starts unenchanted: enchant it at the EpicLoot enchanting table to choose its rarity. This mod also keeps the trinket in the enchant list afterwards, so you can re-enchant it later to upgrade.
• No random enchant effects: the trinkets only carry rarity. They never roll "Bloodrage" or other random effects.
• ExtraSlots friendly: registered as Utility (same class as Void Chest). With ExtraSlots you can equip them in extra utility slots, keep several trinkets equipped, and leave the vanilla Trinket slot free for vanilla trinkets.
• Localization: English / Simplified Chinese / Traditional Chinese.

Recipes

Usage

1. Craft a Lucky Trinket (starts unenchanted: no floor yet).
2. Equip it in a Utility slot (ExtraSlots adds extra slots; the vanilla Trinket slot stays free).
3. Enchant it at the EpicLoot enchanting table and pick a target rarity (e.g. Epic / Legendary).
4. That rarity becomes the drop floor: lower-rarity gear no longer drops near you.
5. Want your own gear to drop too? Craft the Great Fortune Trinket (Lucky Trinket + 10 Iron) and equip it.
6. Want more? Re-enchant the trinket to pick a higher rarity (cost scales with the target rarity).

Configuration

File: BepInEx/config/trigger.epicloot.luckytrinket.cfg (ConfigurationManager supported).

Installation

1. Install BepInExPack for Valheim.
2. Install Jotunn.
3. Install EpicLoot.
4. Drop LuckyTrinket.dll into BepInEx/plugins/LuckyTrinket/.
5. Optional: ExtraSlots for extra utility slots.

Dependencies

• BepInExPack Valheim 5.4.2350+
• Jotunn 2.30.0+
• EpicLoot 0.14.5+
• Optional: ExtraSlots

Repository

https://github.com/1264600905/valheim-epicloot-luck-trinket

Build

cd LuckyTrinket
dotnet build .\LuckyTrinket.csproj -c Release

Output: BepInEx/plugins/LuckyTrinket/LuckyTrinket.dll (output path is preconfigured).

Notes

• The floor is evaluated at drop-generation time (monster drops and chests both use the same path). EpicLoot's rarity odds are preserved — low results are discarded rather than upgraded.
• Low-rarity items are still generated in memory once and then discarded. Skipping generation entirely would require patching EpicLoot's internals (IL), which is brittle across updates.
• Worn-equipment lists are broadcast through the player ZDO (ltr-worn), so the feature works in both singleplayer and multiplayer; nearby wearers' lists are unioned.
• Uninstalling the mod leaves the trinket items inert; character data is unaffected.

简体中文

一个 Valheim 模组：为 EpicLoot 增加两枚 Utility（饰品）槽位护符：幸运护符 提升附近掉落的品质下限，强运护符 额外把你身上穿戴的装备加入附近掉落池。

功能

• 掉落品质下限：佩戴者附近掉落的魔法装备品质不会低于护符自身品质。
  • 不会提升掉落物品品质——低品质结果被直接取消（丢弃），EpicLoot 原有品质几率完全保留；
  • 低于门槛的装备与未鉴定装备不再掉落；
  • 带品质的材料（碎片石/魔法材料/符文）允许低于门槛 MaterialTolerance 级保留（默认 1 = 低一级也保留）；
  • 普通材料（金币、木材等）不受影响。
• 强运护符·穿戴装备注入：把你身上可附魔的穿戴装备加入附近掉落池，可以掉到自己穿的装备。
  • 注入组占掉落池总权重的 WornPoolShare（默认 0.2 ≈ 你的装备 20%、原版池 80%）；原掉落池条目不受影响、不被屏蔽；
  • 注入装备按原池品质几率 roll，不钳制、不提升品质；
  • 组内相对权重：手持武器 ×2、饰品 ×0.4（仅安装 ExtraSlots 时）、其余 ×1；
  • 弹药、可堆叠、受限物品会被跳过（它们不能附魔）。
• 初始未附魔：在附魔台附魔时自选品质；本模组会把护符保留在附魔列表中，之后可随时重新附魔升级。
• 不带随机词条：护符只有品质，不会出现"血怒"之类的随机效果。
• ExtraSlots 兼容：注册为 Utility 类（与虚空宝箱同类）。装了 ExtraSlots 可放进额外槽位、多枚共存，不占用游戏原版「护符」槽。
• 本地化：English / 简体中文 / 繁體中文。

配方

使用

1. 制作幸运护符（初始未附魔：暂无门槛）。
2. 装备到 Utility 槽（装 ExtraSlots 后额外槽位可用，原版「护符」槽保持空闲）。
3. 去 EpicLoot 附魔台附魔，选择目标品质（如 Epic / Legendary）。
4. 该品质即门槛：低于它的装备不再在附近掉落。
5. 想让自己的装备也能掉？制作强运护符（幸运护符 + 铁锭×10）并装备。
6. 想继续提升？重新附魔选更高品质即可（消耗按目标品质计算）。

配置

文件：BepInEx/config/trigger.epicloot.luckytrinket.cfg（支持 ConfigurationManager）。

繁體中文

一個 Valheim 模組：為 EpicLoot 增加兩枚 Utility（飾品）槽位護符：幸運護符 提升附近掉落的品質下限，強運護符 額外把你身上穿戴的裝備加入附近掉落池。

功能

• 掉落品質下限：佩戴者附近掉落的魔法裝備品質不會低於護符自身品質。
  • 不會提升掉落物品品質——低品質結果被直接取消（丟棄），EpicLoot 原有品質機率完全保留；
  • 低於門檻的裝備與未鑑定裝備不再掉落；
  • 帶品質的材料（碎片石/魔法材料/符文）允許低於門檻 MaterialTolerance 級保留（預設 1 = 低一級也保留）；
  • 普通材料（金幣、木材等）不受影響。
• 強運護符·穿戴裝備注入：把你身上可附魔的穿戴裝備加入附近掉落池，可以掉到自己穿的裝備。
  • 注入組佔掉落池總權重的 WornPoolShare（預設 0.2 ≈ 你的裝備 20%、原版池 80%）；原掉落池條目不受影響、不被屏蔽；
  • 注入裝備按原池品質機率 roll，不鉗制、不提升品質；
  • 組內相對權重：手持武器 ×2、飾品 ×0.4（僅安裝 ExtraSlots 時）、其餘 ×1；
  • 彈藥、可堆疊、受限物品會被跳過（它們不能附魔）。
• 初始未附魔：在附魔台附魔時自選品質；本模組會把護符保留在附魔列表中，之後可隨時重新附魔升級。
• 不帶隨機詞條：護符只有品質，不會出現「血怒」之類的隨機效果。
• ExtraSlots 相容：註冊為 Utility 類（與虛空寶箱同類）。裝了 ExtraSlots 可放進額外槽位、多枚共存，不佔用遊戲原版「護符」槽。
• 本地化：English / 简体中文 / 繁體中文。

配方

使用

1. 製作幸運護符（初始未附魔：暫無門檻）。
2. 裝備到 Utility 槽（裝 ExtraSlots 後額外槽位可用，原版「護符」槽保持空閒）。
3. 去 EpicLoot 附魔台附魔，選擇目標品質（如 Epic / Legendary）。
4. 該品質即門檻：低於它的裝備不再在附近掉落。
5. 想讓自己的裝備也能掉？製作強運護符（幸運護符 + 鐵錠×10）並裝備。
6. 想繼續提升？重新附魔選更高品質即可（消耗按目標品質計算）。

配置

檔案：BepInEx/config/trigger.epicloot.luckytrinket.cfg（支援 ConfigurationManager）。

更新日志

0.3.0

• 新增物品「强运护符」（GreatLuckTrinket）：
  • 工作台配方：幸运护符 ×1 + 铁锭 ×10（紫色模型/图标）。
  • 拥有幸运护符的全部效果：附近掉落品质下限（附魔选择品质，可重新附魔升级）。
  • 两枚护符移除固有幸运加成（原 +25 Luck），幸运只保留 EpicLoot 原生词条来源。
  • 两枚护符描述补充说明：不会提升掉落物品品质，而是取消低品质物品掉落。
  • 新增穿戴装备注入：佩戴后，你身上可附魔的穿戴装备会按比例追加进附近掉落池， 可以掉到自己穿的装备；原掉落池条目不受影响（不屏蔽任何掉落）。
  • 穿戴注入跳过不能附魔的物品（弹药、可堆叠物、受限物品等），避免普通物品频繁掉落。
  • 穿戴名单经玩家 ZDO（ltr-worn）广播，联机/单机均生效；多佩戴者取并集（同名取最大权重）。
  • 注入占比：注入组总权重 = 原池总权重 × WornPoolShare/(1-Share)，默认 0.2 → 我们的装备约 20%、原版池约 80%。
  • 注入组内相对权重：默认 1/件；手持武器 2（GetCurrentWeapon 判定）； 饰品（Utility 类型）0.4（仅在安装 ExtraSlots 时生效，未安装则用默认权重）。
  • 注入装备品质完全沿用原池分布（不钳制、不提升），EpicLoot 原始品质几率保持不变； 低于门槛的注入装备与其它掉落一样被门槛剔除（丢弃而非升级）。
  • 新增配置 WornPool（默认 true）、WornPoolShare（默认 0.2）、WornPoolWeight（默认 1）、 WornPoolHeldWeaponWeight（默认 2）、WornPoolUtilityWeight（默认 0.4）。
  • 掉落诊断日志（DebugLog=true 时）：敌人掉落数量几率、四类掉落权重、每件实际分类（含穿戴注入标注与权重）、注入占比与过滤明细。

0.2.2

• 模组名称统一为 EpicLoot_LuckTrinket（体现与 EpicLoot 的强关联），游戏内显示名 "EpicLoot Luck Trinket"。
• 仓库更名为 valheim-epicloot-luck-trinket。

0.2.1

• 模组图标（icon.png）更换为游戏内护符的真实物品图标。

0.2.0

• 包名（GUID）统一为 trigger.epicloot.luckytrinket（旧配置自动迁移）。
• 物品描述与 README 改为英文优先（三语保留）。
• 护符注册为 Utility 类：可放入 ExtraSlots「饰品」槽、多份共存，不占游戏原版「护符」位。
• 材料过滤改为可调范围 MaterialTolerance（默认 1 = 低一级材料保留）。
• 固有幸运显示在 tooltip；护符不再带 EpicLoot 随机词条。
• DebugLog 默认关闭。

0.1.0

• 初版：
  • 新增物品「幸运护符」（Trinket 饰品槽，工作台配方，金色模型/图标）。
  • 护符初始未附魔：在 EpicLoot 附魔台附魔并选择品质； 本 mod 将已附魔护符补入附魔列表，支持随时重新附魔升级品质。
  • 护符不带 EpicLoot 随机词条/装饰名（附魔只改变品质）， tooltip 显示固有幸运行；自动清理旧数据中的随机词条。
  • 佩戴时提供固有幸运 +25（写入 el-luk，非词条，不占效果槽、不受附魔影响）。
  • 掉落生成结束时，品质低于门槛的物品被排除： 装备与未鉴定装备始终过滤；带品质的材料（碎片石/魔法材料/符文） 允许低于门槛 MaterialTolerance 级保留（默认 1 = 低一级的材料也保留）； 普通无品质材料不受影响。
  • 门槛经玩家 ZDO 广播（装备/卸下/魔法数据变化/周期兜底时刷新）。
  • ExtraSlots「饰品」槽兼容：护符注册为 Utility 类（与虚空宝箱同类）， 可放入额外「饰品」槽、多份共存，不占用游戏原版「护符」（Trinket）位； 门槛与幸运对任意「饰品」槽中的护符照常生效。不再注册自开专属槽。
  • 配置：Enabled / Range / LuckBonus / MaterialTolerance / DebugLog。