FoodKnowledge

Description

Food Knowledge adds new foods and recipes through YAML, using Valheim's native inventory and crafting menus. Customize food stats, healing, temporary skill bonuses, models, icons and crafting requirements.

During online play, food definitions are synced from the server. Icons sync once when joining unless the server enables Live Reload; tooltip visibility stays local.

Overview

| Feature | Description |

| --- | --- |

| New food recipes | Define new items without changing existing vanilla foods or recipes. |

| Native crafting | Use inventory crafting or one or more specified crafting stations, with ingredient discovery and station-level requirements. |

| Food customization | Set health, stamina, eitr, healing, duration, weight, stack size and crafting output. |

| Temporary skill bonuses | Add vanilla skill levels for the full food duration, including foods with no health, stamina or eitr. |

| Buff display | Modifier foods show an icon and timer, with automatic or custom text in Active effects. |

| Models and icons | Choose an existing item's 3D model and add a matching PNG icon; missing assets use boar meat. |

| Multiplayer | The server controls food definitions and icon synchronization; matching versions are required. |

Configuration and values

Edit BepInEx/config/dannanboi.foodknowledge.cfg. Food definitions are stored separately in BepInEx/config/FoodKnowledge. Offline play uses local files; multiplayer uses the server's definitions and icons without overwriting the client's files.

| Section / option | Default | Meaning |

| --- | --- | --- |

| [General] Enabled | true | Local startup switch. Changing it requires restarting the game or server. |

| [Settings] Live Reload | false | Server-controlled live synchronization of PNG additions, replacements and deletions. YAML updates always synchronize independently. |

| [UI] Show skill bonuses | true | Show temporary skill bonuses in item tooltips. Local and editable during multiplayer. |

Food item YAML

All.yaml and.yml files directly inside BepInEx/config/FoodKnowledge/ are loaded together. No recipes are enabled by default. Add a flat list to foods.yaml, or copy the entries from Examples/foods.example.yaml into it, replacing the empty. Examples are inactive while they remain outside the config folder.

• itemName: dbfk_PerchMeal

displayName: "Perch meal"

description: "A filling meal: perch and blueberries. Grants temporary swimming knowledge."

useModel: FishCooked

craftingStation: piece_cauldron

stationLevel: 1

hpGain: 45

hpPerTick: 2

staminaGain: 15

eitrGain: 0

modifierGain: jump

modifierValues: 100

buffText: ""

stackSize: 20

weightPerUnit: 0.1

durationMinutes: 20

amountProduced: 2

ingredientList: Fish1[1],Blueberries[1]

Use console spawn names for items, ingredients, models and stations. Prefab names and field names are case-sensitive. Fish1 is perch, Blueberries is blueberries and FishCooked is cooked fish.

| Field | Meaning | Missing/empty value |

| --- | --- | --- |

| itemName | New item's console prefab name; must not match an existing prefab. | Required. |

| displayName | Title in inventory and crafting menus. | Use itemName. |

| description | Item tooltip description. | Empty description. |

| useModel | Existing item supplying the 3D appearance and physical model setup; food stats and recipes are independent. | Boar meat (RawMeat). Invalid or unavailable models also use this fallback. |

| craftingStation | Comma-separated crafting-station prefab names. | Inventory crafting only. |

| stationLevel | Positive whole-number minimum level for every listed station. | 1; unused without a station. |

| hpGain | Maximum-health contribution when eaten. | 0. |

| hpPerTick | HP restored per normal 10-second healing tick, before vanilla regeneration modifiers. | 2 with positive hpGain, otherwise 0. |

| staminaGain | Maximum-stamina contribution when eaten. | 0. |

| eitrGain | Maximum-eitr contribution when eaten. | 0. |

| modifierGain | Comma-sep