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.
| Field | What it does |
|---|---|
| Dish name | What players see in the bag. Up to 32 characters, with Other languages underneath. |
| Rarity | Sets the name colour. |
| Icon | The small picture in the bag slot: bread, drumstick, fish, fruit or egg. |
| Main color | The base colour of the dish. |
| Ingredients | What it takes to cook it, one to six kinds. Each row has an Ingredient and an Amount. |
| What it does | Heal 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 learning | Servings 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: looks | Starts 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:
[
{
"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#
| Field | Required? | What it means | Allowed values |
|---|---|---|---|
id | Yes | The dish’s name inside your mod | Starts with a lowercase letter or digit; only lowercase letters, digits and underscores; up to 48 characters |
name, names | At least one | Dish name | Up to 32 characters each |
rarity | No | Rarity | COMMON (default) UNCOMMON RARE |
icon | No | Small inventory icon | bread (default) drumstick fish cherry egg |
color | Yes | Main colour | "#rrggbb" |
modelColor | No | Second colour of the model | "#rrggbb"; same as color if missing |
shape | No | Which base game dish model to reuse | prov_soup (default) prov_rice_ball prov_bread prov_patty prov_pie prov_flatbread prov_layer_cake prov_omelette prov_bento prov_honey_stack |
ingredients | Yes | The materials | 1 to 6 entries, each { "item": item, "count": 1 to 20 } |
count | No | Portions made per cook | Whole number, 1 to 6. Default 1 |
level | No | Recipe level | Whole number, 1 to 200. Default 1 |
difficulty | No | Difficulty, compared with the player’s cooking skill | Whole number, 1 to 10. Default 3 |
learn | No | How 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 |
healPct | No | Percent of health restored | 0 to 30. Default 10 |
healFloor | No | Minimum health restored | Whole number, 0 to 80. Default 20 |
minutes | No | How long the buff and fullness last | 5 to 90. Default 30 |
buff | No | The buff you get from eating it | A base game buff (for example meal_hearty, meal_might, meal_keen), your own buff, or @modid/name. See Buffs |
warm | No | Whether it counts as a hot meal | true or false. Default false |
pot | No | Can also be made in the big pot: triple the materials for 4 portions, needs cooking skill level 5 | true 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. healPctof 50 orminutesof 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
iconthat is not in the list. Onlybread,drumstick,fish,cherry,egg. - More than 6 ingredients, or an ingredient count above 20.
- Writing
learnas the text"region". It has to be an object like{ "region": "FOREST" }. - A misspelled
buff. The game says there is no buff called "something".
Related pages#
- 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.