Mods are a feature of the full game, not the demo. They open when the full game launches, and details may change before then.

Dishes

Add a dish that can be cooked, eaten, and gives a buff.

The dishes table is a shortcut that makes a whole dish in one entry. You write a name, the ingredients and the effect, and the game builds the edible item, a campfire recipe, and, for dishes that must be learned, a recipe page. You do not need to write an item or a recipe separately.

Dish numbers are deliberately kept close to the base game’s own dishes (weak effect, long duration), so the ranges are narrower than for other tables.

In the editor#

Open the Dishes tab under Food & gathering in the left column. Press Add to start a new dish, or Copy from game to start from a base game dish. You do not need to make a separate item or recipe: the dish builds both for you.

FieldWhat it does
Dish nameWhat players see in the bag. Up to 32 characters, with Other languages underneath.
RaritySets the name colour.
IconThe small picture in the bag slot: bread, drumstick, fish, fruit or egg.
Main colorThe base colour of the dish.
IngredientsWhat it takes to cook it, one to six kinds. Each row has an Ingredient and an Amount.
What it doesHeal amount (a share of max health restored over a few seconds, at most 30%), Heal at least, Lasts (how long the buff and fullness last), Buff (optional extra effect) and Served hot (a better wake-up bonus if eaten hot before bed).
Cooking and learningServings per cook, Level needed, Difficulty (1 easiest, 10 hardest), How to learn it (Known from the start, Recipe page, or a recipe page found in one region) and Can be made in a big pot.
Advanced: looksStarts collapsed. Plate color and Shape, which borrows the 3D look of a base game dish.

The right column shows a Dish summary card: what it restores, how long it lasts, what it needs and how it is learned. It is a simplified view; the real tooltip shows when you test.

To test, press the top-bar Test. If a dish must be learned, find or learn its recipe page first.

Advanced: writing the JSON by hand#

Below is the same content as it looks in the file. The editor saves exactly this format. You can also press Open folder at the top of the editor and edit the file in an outside text editor; when you save, the editor picks up the change. Fields the form does not show are kept as they are. Where the file goes and how it is listed: Mod folder and mod.json.

Put the path under content.dishes in mod.json.

Smallest working example#

Grilled fish rice: cooks 2 portions from base game fish, grain and salt, known from the start. It heals a little, gives the base game "Hearty" buff for 40 minutes, and can also be made in the big pot:

data/dishes.json
[
  {
    "id": "grilled_fish_rice",
    "name": "Grilled fish rice",
    "names": { "zh-TW": "烤魚飯" },
    "rarity": "UNCOMMON",
    "icon": "bread",
    "color": "#f1d9a8",
    "modelColor": "#c98b4a",
    "shape": "prov_rice_ball",
    "ingredients": [
      { "item": "food_fish", "count": 2 },
      { "item": "grain", "count": 2 },
      { "item": "salt", "count": 1 }
    ],
    "count": 2,
    "level": 1,
    "difficulty": 3,
    "learn": "start",
    "healPct": 15,
    "healFloor": 30,
    "minutes": 40,
    "buff": "meal_hearty",
    "warm": true,
    "pot": true
  }
]

Fields#

FieldRequired?What it meansAllowed values
idYesThe dish’s name inside your modStarts with a lowercase letter or digit; only lowercase letters, digits and underscores; up to 48 characters
name, namesAt least oneDish nameUp to 32 characters each
rarityNoRarityCOMMON (default) UNCOMMON RARE
iconNoSmall inventory iconbread (default) drumstick fish cherry egg
colorYesMain colour"#rrggbb"
modelColorNoSecond colour of the model"#rrggbb"; same as color if missing
shapeNoWhich base game dish model to reuseprov_soup (default) prov_rice_ball prov_bread prov_patty prov_pie prov_flatbread prov_layer_cake prov_omelette prov_bento prov_honey_stack
ingredientsYesThe materials1 to 6 entries, each { "item": item, "count": 1 to 20 }
countNoPortions made per cookWhole number, 1 to 6. Default 1
levelNoRecipe levelWhole number, 1 to 200. Default 1
difficultyNoDifficulty, compared with the player’s cooking skillWhole number, 1 to 10. Default 3
learnNoHow the player learns the dish"start" (known from the beginning), "scrap" (find a recipe page; the default), or { "region": region } (bought at an inn in that region). Regions: GRASSLAND FOREST DESERT MESA TUNDRA
healPctNoPercent of health restored0 to 30. Default 10
healFloorNoMinimum health restoredWhole number, 0 to 80. Default 20
minutesNoHow long the buff and fullness last5 to 90. Default 30
buffNoThe buff you get from eating itA base game buff (for example meal_hearty, meal_might, meal_keen), your own buff, or @modid/name. See Buffs
warmNoWhether it counts as a hot mealtrue or false. Default false
potNoCan also be made in the big pot: triple the materials for 4 portions, needs cooking skill level 5true or false. Default false

How it points at other things#

  • An ingredient’s item: a base game item id (food_fish, grain, salt), a local id from your own items table, or @modid/name.
  • buff: a base game buff id, a local id from your own buffs table, or @modid/name.
  • The finished dish is itself an item, so you can let enemies drop it in Loot.

Common mistakes#

  • Leaving out color. The game says: "color" is missing.
  • healPct of 50 or minutes of 120. Out of range, so the entry is skipped and the game says the field should be between 0 and 30 (or 5 and 90).
  • An icon that is not in the list. Only bread, drumstick, fish, cherry, egg.
  • More than 6 ingredients, or an ingredient count above 20.
  • Writing learn as the text "region". It has to be an object like { "region": "FOREST" }.
  • A misspelled buff. The game says there is no buff called "something".
  • Buffs: make an effect that only your dish gives.
  • Items: your own ingredients.
  • Crops and Fish: ingredients players can grow or catch.
  • The mod editor: build this kind of content with forms and test it in the game.