Lucky Trinket

A Valheim mod that adds a Lucky Trinket for EpicLoot — a Utility-slot charm that raises the rarity floor of nearby loot.

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

Features

• Innate +25 Luck while equipped (configurable). Applied through the game's Luck value, not as an enchantment — it never takes an effect slot and cannot be re-rolled or removed by enchanting.
• Rarity floor for nearby drops: magic gear dropped near the wearer never rolls below the trinket's own rarity.
  • 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.
  • EpicLoot's original rarity odds are untouched — low rolls are simply discarded, never upgraded.
• 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 trinket only carries rarity (plus its innate Luck). It never rolls "Bloodrage" or other random effects.
• ExtraSlots friendly: registered as Utility (same class as Void Chest). With ExtraSlots you can equip it in an extra utility slot, keep several trinkets equipped, and leave the vanilla Trinket slot free for vanilla trinkets.
• Localization: English / Simplified Chinese / Traditional Chinese.

Recipe

Usage

1. Craft a Lucky Trinket (starts unenchanted: no floor, +25 Luck only).
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 more? Re-enchant it 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.4+
• 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.
• Uninstalling the mod leaves the trinket item inert; character data is unaffected.

简体中文

一个 Valheim 模组：为 EpicLoot 增加一枚 幸运护符——Utility 槽位饰品，提升附近掉落的品质下限。

功能

• 固有幸运 +25：佩戴时生效（可配置）。走游戏幸运值链路，不是附魔词条——不占效果槽，附魔/重铸都无法移除或覆盖。
• 掉落品质下限：佩戴者附近掉落的魔法装备品质不会低于护符自身品质。
  • 低于门槛的装备与未鉴定装备直接不掉落；
  • 带品质的材料（碎片石/魔法材料/符文）允许低于门槛 MaterialTolerance 级保留（默认 1 = 低一级也保留）；
  • 普通材料（金币、木材等）不受影响；
  • EpicLoot 原有品质几率完全保留——低品质结果被丢弃，而不是升级。
• 初始未附魔：在附魔台附魔时自选品质；本模组会把护符保留在附魔列表中，之后可随时重新附魔升级。
• 不带随机词条：护符只有品质（和固有幸运），不会出现"血怒"之类的随机效果。
• ExtraSlots 兼容：注册为 Utility 类（与虚空宝箱同类）。装了 ExtraSlots 可放进额外槽位、多枚共存，不占用游戏原版「护符」槽。
• 本地化：English / 简体中文 / 繁體中文。

配方

使用

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

配置

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

繁體中文

一個 Valheim 模組：為 EpicLoot 增加一枚 幸運護符——Utility 槽位飾品，提升附近掉落的品質下限。

功能

• 固有幸運 +25：佩戴時生效（可設定）。走遊戲幸運值鏈路，不是附魔詞條——不佔效果槽，附魔/重鑄都無法移除或覆蓋。
• 掉落品質下限：佩戴者附近掉落的魔法裝備品質不會低於護符自身品質。
  • 低於門檻的裝備與未鑑定裝備直接不掉落；
  • 帶品質的材料（碎片石/魔法材料/符文）允許低於門檻 MaterialTolerance 級保留（預設 1 = 低一級也保留）；
  • 普通材料（金幣、木材等）不受影響；
  • EpicLoot 原有品質機率完全保留——低品質結果被丟棄，而不是升級。
• 初始未附魔：在附魔台附魔時自選品質；本模組會把護符保留在附魔列表中，之後可隨時重新附魔升級。
• 不帶隨機詞條：護符只有品質（和固有幸運），不會出現「血怒」之類的隨機效果。
• ExtraSlots 相容：註冊為 Utility 類（與虛空寶箱同類）。裝了 ExtraSlots 可放進額外槽位、多枚共存，不佔用遊戲原版「護符」槽。
• 本地化：English / 简体中文 / 繁體中文。

配方

使用

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

更新日志

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。