EpicLoot_幸运饰品

幸运护符与强运护符

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

Thunderstore 包名：EpicLoot_LuckTrinket 本地化：English / 简体中文 / 繁體中文

---

功能

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

配方

物品	工作台	材料
幸运护符	工作台	木头×10 + 骨头碎片×10 + 金币×50
强运护符	工作台	幸运护符×1 + 铁锭×10

使用

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

配置

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

配置	默认	说明
Enabled	true	启用掉落品质下限
Range	100	生效半径（米，1-200）：掉落点该范围内的佩戴者护符生效
MaterialTolerance	1	材料允许低于门槛多少级保留（0-5；1 = 低一级也保留，5 = 全部保留）
DebugLog	false	调试日志
WornPool	true	启用穿戴装备注入（仅强运护符）
WornPoolShare	0.2	注入组占掉落池总权重的比例（0.2 ≈ 我们 20%、原版 80%；0 = 关闭）
WornPoolWeight	1	注入组内每件装备的相对权重
WornPoolHeldWeaponWeight	2	注入组内手持武器的相对权重
WornPoolUtilityWeight	0.4	注入组内饰品（Utility）的相对权重（仅 ExtraSlots）

安装

1. 安装 BepInExPack for Valheim。
2. 安装 Jotunn。
3. 安装 EpicLoot。
4. 将 LuckyTrinket.dll 放入 BepInEx/plugins/LuckyTrinket/。
5. 可选：ExtraSlots 以获得额外饰品槽位。

依赖

• BepInExPack Valheim 5.4.2350+
• Jotunn 2.30.0+
• EpicLoot 0.14.5+
• 可选：ExtraSlots

仓库

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

构建

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

输出：BepInEx/plugins/LuckyTrinket/LuckyTrinket.dll（输出路径已预配置）。

备注

• 门槛在掉落生成时判定（怪物掉落与宝箱走相同路径）。EpicLoot 的品质几率完全保留——低品质结果被丢弃而非升级。
• 低品质物品仍会在内存中生成一次再被丢弃。若要在生成阶段直接跳过，需要修改 EpicLoot 内部实现（IL），跨版本更新时较为脆弱。
• 穿戴装备列表通过玩家 ZDO（ltr-worn）广播，因此单人与多人均可用；附近佩戴者的列表会合并。
• 卸载模组后护符物品将失效，角色数据不受影响。

---

简体中文

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

功能

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

配方

物品	工作台	材料
幸运护符	工作台	木头×10 + 骨头碎片×10 + 金币×50
强运护符	工作台	幸运护符×1 + 铁锭×10

使用

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

配置

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

配置	默认	说明
Enabled	true	启用掉落品质下限
Range	100	生效半径（米，1-200）
MaterialTolerance	1	材料允许低于门槛多少级保留（0-5）
DebugLog	false	调试日志
WornPool	true	启用穿戴装备注入（仅强运护符）
WornPoolShare	0.2	注入组占掉落池总权重的比例（0.2 ≈ 我们 20%、原版 80%；0 = 关闭）
WornPoolWeight	1	注入组内每件装备的相对权重
WornPoolHeldWeaponWeight	2	注入组内手持武器的相对权重
WornPoolUtilityWeight	0.4	注入组内饰品（Utility）的相对权重（仅 ExtraSlots）

---

繁體中文

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

功能

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

配方

物品	工作台	材料
幸運護符	工作台	木頭×10 + 骨頭碎片×10 + 金幣×50
強運護符	工作台	幸運護符×1 + 鐵錠×10

使用

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

配置

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

設定	預設	說明
Enabled	true	啟用掉落品質下限
Range	100	生效半徑（公尺，1-200）
MaterialTolerance	1	材料允許低於門檻多少級保留（0-5）
DebugLog	false	除錯日誌
WornPool	true	啟用穿戴裝備注入（僅強運護符）
WornPoolShare	0.2	注入組佔掉落池總權重的比例（0.2 ≈ 我們 20%、原版 80%；0 = 關閉）
WornPoolWeight	1	注入組內每件裝備的相對權重
WornPoolHeldWeaponWeight	2	注入組內手持武器的相對權重
WornPoolUtilityWeight	0.4	注入組內飾品（Utility）的相對權重（僅 ExtraSlots）