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: <PrefabName>
  amount: <int>
```
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.

Details

Categories