A BepInEx mod for ASKA that allows you to create custom crafting recipes using simple JSON files.
Always backup your local save game and (if applicable) your server save game before you do anything with any mod
Install BepInEx 6 (IL2CPP) if you haven't already:
ASKA.exe is located)BepInEx/plugins/ folderYour folder structure should look like:
ASKA/
├── ASKA.exe
├── BepInEx/
│ ├── plugins/
│ │ └── Ranensol.BepInEx.Aska.CraftBlueprints/
│ │ ├── Ranensol.BepInEx.Aska.CraftBlueprints.dll
│ │ ├── Recipes/
│ │ └── Reference/
│ └── config/
└── ...
The mod comes with example recipes to get you started. On first launch, you'll find these files in BepInEx/plugins/Ranensol.BepInEx.Aska.CraftBlueprints/:
Recipes folder:
Examples.json - Example recipes you can learn fromCustomRecipes.json - Empty file for your own recipesReference folder:
Items.txt - Game items likely to work for craftingMenuLists.txt - Compatible crafting station menusInteractions.txt - Compatible crafting station interactionsCategories.txt - Relevant blueprint categoriesRules.txt - Unlock conditionsConfig file: BepInEx/config/Ranensol.BepInEx.Aska.CraftBlueprints.cfg
[Files]
CreateExampleFile = true # Create Examples.json on launch
CreateCustomRecipeFile = true # Create CustomRecipes.json on launch
DumpReferenceFiles = true # Create reference files on launch
Set any option to false to disable file creation.
[Filters - Xxx]
These can be ignored unless you specifically want to see things that may not be compatible, or have added another mod whose items you want to include etc. Include is applied first, then Exclude. To see everything for a particular file (which was previously the default setting) simply ensure both IncludePrefixes and ExcludePrefixes have no value after the = sign.
Create or edit CustomRecipes.json:
{
"recipes": [
{
"id": 900000100,
"resultItem": "Item_Materials_Linen",
"name": "My Custom Recipe",
"ingredients": [
{
"item": "Item_Wood_BarkFibres",
"quantity": 10
}
],
"quantity": 1,
"menuLists": ["WeaverBlueprints_T1"],
"rules": ["Weaver_Rule"],
"interaction": "WeaverInteraction",
"category": "Categ_Blueprints_Materials",
"description": "Craft something useful",
"lore": "Optional flavor text"
}
]
}
| Field | Required | Description |
|---|---|---|
id |
✅ Yes | Unique ID for this recipe (use 900000000+) |
resultItem |
✅ Yes | The item you want to craft, use values from Items.txt |
name |
✅ Yes | Display name in crafting menu |
ingredients |
✅ Yes | Items and quantities needed to craft this item, use values from Items.txt |
quantity |
✅ Yes | How many items this recipe produces |
menuLists |
✅ Yes | Which crafting menus show this recipe (from MenuLists.txt) |
rules |
❌ No | Unlock conditions, e.g. Workshop Tier 2 (from Rules.txt). Leave blank for it to always be unlocked/available |
interaction |
✅ Yes | Which crafting station this item can be created in (from Stations.txt) |
category |
✅ Yes | Blueprint category (from Categories.txt) |
description |
❌ No | Short description shown in-game |
lore |
❌ No | Flavor text shown in-game |
| Station | Interaction Name |
|---|---|
| Armorsmith | VirtualCraftingStation |
| Dyer | DyerInteraction |
| Leatherworker | LeatherworkerTableInteraction |
| Player Inventory | VirtualCraftingStation |
| Weaver | WeaverInteraction |
| Workshop | WorkstationInteraction |
Check Interactions.txt for the complete list.
Recipes not appearing in game:
Items.txt exactlyReference files not created:
DumpReferenceFiles = true in the configReference files not filtered:
DumpReferenceFiles = true in the configConfig file not appearing:
BepInEx/config/ folderThese are meant as learning examples - feel free to disable them in the config and delete the Examples.json.
v1.0.2: No functional changes mod wise, simply added filtering for the reference files that get dumped to make it easier for users to see recipe ingredients, compatible workstations etc.
To generate the new files simply delete the existing files in: ASKA\BepInEx\plugins\Ranensol Craft Blueprints\Reference\
And ensure "DumpReferenceFiles = true" in: ASKA\BepInEx\config\Ranensol.BepInEx.Aska.CraftBlueprints.cfg
Then start the game and see a much reduced list of stuff to play with.
v1.0.1: Recompiled against updated interop's
Created by Ranensol