4.2. Custom Crops

Warning

This page is from before the July 7th 2026 update in which Fields of Mistria migrated game engines. Information here is likely outdated and/or depricated.

To add new crops to the game, we'll need to create both a new item and object for the seed, both with the same ID, and a new item for the crop once harvested. For more information, refer to the page for adding new items and adding new objects.

You may also need to add new sprites for your seed and crop, so reading the page on Sprites may be useful.

Seed Item

The first item you will need to make is the item that will act as the seed, this should go inside a JSON file inside the items/ folder.

{
 "example_seed_id": {
   "overwrites_other_mod": false,
   "name": "Example Seed",
   "description": "A seed.",
   "crop_object": "example_crop",
   "icon_sprite": "spr_ui_item_bagseed_basil_icon",
   "mini_sprite": "spr_ui_tool_tip_icon_basil",
   "sow_sprite": "spr_ui_item_bagseed_basil_mini",
   "tags": ["seed"],
   "value": {"store": 100}
   }
}

This is just a simple item that will exist for the purpose of planting the seed.

• name The display name of the item.
• description The items description.
• crop_object This will be the ID of the object we create below.
• icon_sprite The sprite of the item shown in inventories.
• mini_sprite The sprite shown next to the harvestable items cost in the tooltip.
• sow_sprite The sprite of the item in use when sowing the seeds.
• tags The tag shown here makes the seed item display when obtained in the almanac.
• value The cost of the seed when buying from a store.

Seed Object

This represents the object for the seed that will be planted into the ground and should be placed in the objects/ folder. The ID for this object must be the same as the ID of the item added above for the seed to be plantable.

{
 "example_seed_id": {
   "overwrites_other_mod": false,
   "category": "crop",
   "data": {
      "currency": 3,
      "day_to_stage": [0, 1, 1, 1, 2],
      "harvest": "example_crop",
      "regrow_days": 4,
      "seasons": ["spring", "summer", "fall", "winter"],
      "sprites": ["spr_forage_basil_seed", "spr_forage_basil_stage3", "spr_forage_basil_stage4"]
      }
   }
}

• currency I am currently unsure what this does???
• day_to_stage Refers to the sprites during the crops growth as well as how many days it takes for its initial growth.
  In this example the seed sprite will show for day 1, partial growth for days 2-4, and the harvestable sprite for day 5.
• harvest This is the ID of the item that will be harvested from the fully grown crop.
• regrow_days (Optional) This is how many days it takes for the crop to regrow from stage 1.
• seasons Which seasons the crop can be planted and grown in. You need at least 1 season listed for the seed to be plantable.
• sprites The sprites used for each of the growth stages of the crop.

Crop Item

This is the item of the crop that will be harvested once the seed is grown and should go inside the items/ folder. The crop item ID must match the seed objects harvest ID.

{
 "example_crop": {
   "overwrites_other_mod": false,
   "name": "Apple of Example",
   "description": "A fruity description",
   "icon_sprite": "spr_ui_item_apple",
   "restore": 5,
   "mana_modifier": 4,
   "edible": true,
   "tags": ["forageable", "consumable"],
   "value": {"bin": 300}
   }
}

• name The display name of the item
• description The items description
• icon_sprite The sprite of the harvested crop.
• restore (Optional) This parameter makes it so when the crop is consumed it will restore that amount stamina and health.
• mana_modifier (Optional) This parameter makes is so when the crop is consumed it will restore some mana.
• edible (Optional) This parameter makes it so you can consume the crop.
• tags These example tags will place the item in the forageable section of the almanac and count the item as a consumable for game events.
• value The sell price of the crop.