DataForge

DataForge

Edit Valheim recipes, items, build pieces, and status effects with YAML files. Find an entry in the generated references, copy it, and change only what you need. DataForge reads vanilla content and content registered by your installed mods.

Small qol of showing comfort values and related comfort-group hints in the hammer menu.

Global settings

| Setting | Default | What it does | | --- | --- | --- | | Stackable Stack Multiplier | 1 | Multiply stack sizes by 1–10. An item's explicit maxStackSize takes priority. | | Item Weight Multiplier | 1 | Multiply item weights by 0–2. An item's explicit weight takes priority. | | Upgrade Material Scaling | Vanilla | For a base cost of 10, qualities 2/3/4 cost 10/20/30. Flat gives 10/10/10; Reduced gives 10/15/20. Exact-quality costs stay as written. | | Show Comfort In Hammer | On | Show comfort values and related comfort-group hints in the hammer menu. Client setting. | | Highlight Station Extensions In Hammer | On | Highlight related stations and extensions on hover. Client setting. | | Ignore Station Extension Spacing | On | Allow extensions to be placed close together. Other placement rules still apply. | | Fireplace Fuel Multiplier | 10 | Multiply every finite, refillable fireplace's original fuel capacity, including the displayed maximum. 1 restores the original capacity. Existing fuel and burn speed stay unchanged. |

Fireplace Fuel Multiplier accepts whole numbers from 1 to 9999. At the default 10, a wood torch holds 40 fuel and a hearth holds 200. Changes always use each fireplace's original capacity, so multipliers do not compound. Lowering the setting does not delete stored fuel: it must burn below the new limit before you can add more. This setting does not change smelters or cooking stations. AzuCraftyBoxes uses the same capacity for nearby-container refuelling; DataForge also guards its reviewed 1.8.27 fill-all calculations against negative amounts when excess fuel remains. The former maxStoredFuel and Fireplace Fuel Capacity settings are not read or migrated. Set the new multiplier explicitly if you want a value other than 10.

Vanilla fireplaces return building materials on dismantling, but not their stored fuel. With a multiplier above 1, DataForge also returns whole fuel units remaining after subtracting the fireplace's starting fuel. For example, 50 fuel remaining with 3 starting fuel returns 47. This also applies at multiplier 1 while stored fuel still exceeds the restored capacity. Destruction with blocked drops returns none.

Start here

1. Install DataForge and BepInExPack Valheim 5.4.2351. For multiplayer, install the same DataForge version on the server and every client.
2. Start a world, or start your dedicated server and let its game data load.
3. Open BepInEx/config/DataForge/ in that installation. If you use a mod manager, open the active profile's config folder.
4. Find the entry you want in a reference file. Copy it into the matching edit file below.
5. Keep the entry name, set override: true, and keep only the fields you want to change. Save the file. DataForge reloads supported changes automatically after a short delay.

In multiplayer, edit the host or dedicated server's files. Connected clients use the server's settings, not their own local YAML.

| I want to change… | Read this generated file | Edit this file | Guide | | --- | --- | --- | --- | | Ingredients, output, or crafting station | recipes.reference.yml | recipes.yml | Recipes | | Weight, damage, armor, food, or item visuals | items.reference.yml | items.yml | Items | | Build costs, health, comfort, or production | pieces.reference.yml | pieces.yml | Pieces | | Buffs, debuffs, or effect visuals | effects.reference.yml | effects.yml | Effects | | Build-tool categories | pieceCategory.reference.yml | pieceCategory.yml | Categories |

For a first edit, put this in items.yml to make Wood lighter and stack to 100:

- item: Wood
  override: true
  weight: 1
  maxStackSize: 100

A few YAML rules

• Use spaces, not tabs. Each entry starts with - item:, - recipe:, - piece:, or - effect:.
• Dots in tables mean nested keys: visual.icon means icon inside a visual block, not a literal field name.
• Use the internal names from the references, such as SwordIron, not the translated in-game name.
• Omit fields you do not want to override. override: false disables that entry.
• A list such as resources or conversions replaces the whole list. Include every entry you want to keep. [] clears a list where supported.
• Comma-separated values have different meanings for different fields. Follow the examples below; do not assume that leaving out a number always preserves it.
• Use None only for fields that support it. A blank value is not a general reset command.

You can split your edits into files such as items_balance.yml, recipes_food.yml, or effects_magic.yml. Keep these files directly inside DataForge/, not in subfolders. Files load in alphabetical order; keeping each target in one file makes edits easier to track.

Find a field that is missing from a reference

References hide many default values. Generate a full file to see the supported fields and their baseline values. Enter these commands in the game's console. If needed, enable it with the -console launch option.

dataforge:full item
dataforge:full recipe
dataforge:full piece
dataforge:full effect
dataforge:full all

For example, dataforge:full item writes items.full.yml. Copy the fields you need into items.yml; reference and full files are generated guides, not active edit files. They can be overwritten when regenerated.

To refresh references after loading or changing your modpack: