In this guide we'll provide and explain basic modding examples, for those who want to know how to change or to add a specific thing to the game. The intermediate and advanced guides cover more complex modding. If you're new to modding Stonehearth, it's recommended that you start by doing something simple to learn the structure of the game and the different tools that the modding API offers before starting to delve into more advanced topics.
You can check the art related guides here.
Please read the essentials guide before attempting any modding.
Table of Contents
- How to create new items : how to create new placeable items.
- The catalog : what is the catalog service and how to define data for it.
- Generic resources : how to create generic resources for crafting.
- Adding recipes : how to add crafting recipes.
- Adding equipment : how to create equipment pieces that inject buffs, commands or AI.
- Storage items : how to create storage items and patrollable items. How filters work.
- Color maps : what are color maps and material maps and how to use them.
- Adding customization : how to add custom hairstyles, custom eye/hair/skin and building colors.
- Adding crops : how to add new farming crops and food items to the game.
- Renewable resources : how to create your own resources, renewable resources and seeds.
- Plants and trees : how to add your own plants and trees to the world generation. Seasonal variants.
- Static scenarios : what are static scenarios and how to create custom scenario types and categories.
- Miscellaneous JSON : how time expressions, loot tables and weighted sets work.
- Loadouts and shops : how to add new loadouts and shops.
- Translating mods : how to create a localization mod for the base game or for other mods.