Ranensols Craft Blueprints

Aska - Ranensol's Craft Blueprints

A BepInEx mod for ASKA that allows you to create custom crafting recipes using simple JSON files.

Features

• 🌐 Works in single-player, multiplayer, and with villager task assignments
• ✨ Create custom crafting recipes without coding
• 🔧 Simple JSON configuration
• 📋 Automatic reference file generation for relevant in-game items, now filtered
• 🎮 Works with: Armorsmith, Workshop, Weaver, Leatherworker, Dyer, Player Inventory, and Raven Totem.
• 🔄 Hot-reload support - just edit JSON and restart the game

Installation

IMPORTANT

Always backup your local save game and (if applicable) your server save game before you do anything with any mod

Prerequisites

Install BepInEx 6 (IL2CPP) if you haven't already:

• Download the latest IL2CPP build from BepInEx builds
• Extract the contents to your ASKA game folder (where ASKA.exe is located)
• Launch the game once to initialize BepInEx, then close it

Installing the Mod

• Download this mod from the Releases page
• Extract the mod files to BepInEx/plugins/ folder
• Launch the game - config and recipe files will be generated automatically

Your folder structure should look like:

ASKA/

├── ASKA.exe

├── BepInEx/

│ ├── plugins/

│ │ └── Ranensol.BepInEx.Aska.CraftBlueprints/

│ │ ├── Ranensol.BepInEx.Aska.CraftBlueprints.dll

│ │ ├── Recipes/

│ │ └── Reference/

│ └── config/

└──...

Usage

For Players

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 from
• CustomRecipes.json - Empty file for your own recipes

Reference folder:

• Items.txt - Game items likely to work for crafting
• MenuLists.txt - Compatible crafting station menus
• Interactions.txt - Compatible crafting station interactions
• Categories.txt - Relevant blueprint categories
• Rules.txt - Unlock conditions

Configuration

Config 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.

Creating Custom Recipes

Basic Recipe Structure

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"

}

]

}

Recipe Fields Explained

| 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 | ❌