PowerBelts

版本 v1.1.0·更新於 2025-08-14

put status effects on equipable items

模組介紹 作者原文

Power Belts Mod for Valheim

Overview

Power Belts lets you add boss-style status effects to equipable items (e.g., clone BeltStrength and grant a Moder-like wind power).

Item setup is driven by a simple YAML file.

Development & Contribution

  • Built with BepInEx, Harmony, and Jötunn.
  • Built in support of ValheimRoleplay — come make-believe with us!
  • Enjoy immersive roleplay with RPChatter! 🎭🔥

Configuration (YAML)

Location:

BepInEx/config/Arielle.VRPBelts.Belts.yml

Format:

Top-level list (no belts: wrapper). Use spaces (no tabs).

Minimal example

  • sourceSe: GP_Moder

startMessage: "You feel the wind at your back"

basePrefabName: BeltStrength

newPrefabName: BeltModer

name: "Sailor Belt"

description: "belt of a seasoned sailor"

craftingStation: piece_workbench

minStationLevel: 1

requirements:

  • item: Coins

amount: 950

Add more belts by appending additional list items with the same fields.

Field reference (per belt)

sourceSe (string)*

Internal name of the StatusEffect to clone (e.g., GP_Moder).

startMessage (string)*

Message shown when the effect activates (use "" to suppress).

basePrefabName (string)*

Vanilla item prefab to clone (commonly BeltStrength).

newPrefabName (string, unique)*

Internal prefab name for the new belt (e.g., BeltModer). Must be unique.

name (string)*

In-game display name. You can also use a localization key (e.g., $item_sailorbelt).

description (string)*

In-game description (or a localization key).

craftingStation (string)*

Crafting station prefab name, e.g.:

  • piece_workbench (Workbench)
  • forge (Forge)
  • piece_magetable (Galdr Table)
  • piece_blackforge (Black Forge)

minStationLevel (int)*

Minimum station level required.

requirements (list)*

Each entry:

  • item:

amount:

Example items: Coins, Silver, WolfPelt, etc.

What the mod does under the hood

  • Clones basePrefabName into newPrefabName.
  • Clones sourceSe into a belt-specific StatusEffect that’s permanent while equipped and quiet (no VFX spam by default), then assigns it as the belt’s m_equipStatusEffect.
  • Registers a crafting recipe using your station, level, and requirements.
  • Vanilla guardian powers remain unchanged (the belt uses a separate cloned effect).

Tips

  • Keep the first - at column 1 in the YAML file (top-level list).
  • Use straight quotes ("like this") and spaces, not tabs.
  • Prefer localization keys for name/description if you support multiple languages.
  • Ensure sourceSe and basePrefabName are valid internal names present in ObjectDB.

Troubleshooting

  • YAML parse error (plain scalar / invalid mapping):

Usually indentation or smart quotes. Replace tabs with spaces and curly quotes with straight quotes, or copy the minimal example above as a template.

  • “Source status effect not found”:

Double-check sourceSe spelling and that it exists (e.g., GP_Moder, GP_Bonemass, etc.).

  • Recipe not showing up:

Verify the craftingStation prefab name, station level, and that requirement item prefabs are valid.

安裝與使用 安裝:BepInEx 外掛

  1. 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
  2. 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
  3. 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
  4. 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。

帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時,主機與所有用戶端需要安裝一致的模組。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

denikson-BepInExPack_ValheimValheimModding-Jotunn

檔案與校驗

檔案名稱
PowerBelts-1.1.0.zip
檔案大小
135.4 KiB