FoodKnowledge

Description

Food Knowledge adds new foods and recipes through YAML and edits vanilla foods or removes their crafting recipes, using Valheim's native inventory and crafting menus. Customize food stats, healing, temporary skill bonuses and other modifiers, icons and crafting requirements; choose models for new foods. Requires ModifiersFramework for modifier gameplay, food modifier lifetimes, saved modifier snapshots and buff display. Food Knowledge creates the foods and supplies their definitions/icons. During online play, food definitions are synced from the server. Icons sync once when joining unless the server enables Live Reload. Modifier information is always included in food tooltips.

Food Knowledge supports CRUD operations for food definitions and recipes:

• Create: Add new foods and recipes.
• Read: Load food definitions from YAML.
• Update: Edit existing vanilla foods, preserving omitted values.
• Delete: Remove a food's crafting recipes while keeping the item usable.

CRUD means Create, Read, Update and Delete. Deletion keeps native food items registered, including saved inventory copies and already-eaten meals.

Overview

| Feature | Description | | --- | --- | | Food definitions | CRUD operations for food definitions and recipes through YAML, selected automatically by the food name and supplied fields. | | 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. | | Food modifiers | Add vanilla skills, stamina-cost changes, regeneration, damage, resistance, speed, carry capacity, adrenaline, stagger, sailing tailwind and Wet immunity for the full food duration. | | Buff display | Modifier foods show an icon and timer, with automatic or custom text in Active effects. | | Models and icons | Choose a model for new foods and add matching PNG icons; new foods fall back to boar meat, while native edits retain their original appearance. | | 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 | Icons only: server-controlled live synchronization of PNG additions, replacements and deletions. All YAML edits, including vanilla foods and recipes, synchronize during play with either setting. |

Food item YAML

All .yaml and .yml files directly inside BepInEx/config/FoodKnowledge/ are loaded together. No recipes are enabled by default. Add food-name mappings to foods.yaml, or copy the entries from Examples/foods.example.yaml into it, replacing the empty {} (or the older []). Examples are inactive while they remain outside the config folder. The default foods.yaml uses a short setup header and points to ModifiersFramework documentation for modifiers and buffs. Startup replaces its leading comments while preserving food definitions; other YAML files are left unchanged.

dbfk_PerchMeal:
  basics:
    - displayName: "Perch meal"
    - description: "A filling meal: perch and blueberries. Grants temporary swimming knowledge."
    - useModel: FishCooked
    - craftingStation: piece_cauldron
    - stationLevel: 1
    - stackSize: 20
    - weightPerUnit: 0.1
    - amountProduced: 2
  stats:
    - hpGain: 45
    - hpPerTick: 2
    - staminaGain: 15
    - eitrGain: 0
    - modifierGain: jump[100]
    - activeEffectText: ""
    - durationMinutes: 20
  ingredients:
    - 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.