PowerBelts
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 外掛
- 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
- 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時,主機與所有用戶端需要安裝一致的模組。
下面這些內容需要先安裝,否則該模組不會生效: