Ranensol's Craft Blueprints

Create custom crafting recipes for ASKA using simple JSON files - no coding required!

Features

• 🌐 Works in single-player, multiplayer, and with villager task assignments
• ✨ Easy JSON-based recipe creation
• 📋 Automatic reference files generated with all game items and stations
• 🎮 Supports most crafting stations (Workshop, Weaver, Leatherworker, Player Inventory, etc.)
• 🔄 Just edit JSON and restart the game to see changes

Installation

Automatic (Recommended)

Use a mod manager like r2modman or Thunderstore Mod Manager - it handles everything for you!

Manual

1. Install BepInEx 6 (IL2CPP)
2. Extract this mod to BepInEx/plugins/ folder
3. Launch the game - config and example recipes will be created automatically

Quick Start

After first launch, check BepInEx/plugins/Ranensol.BepInEx.Aska.CraftBlueprints/Recipes/:

• Examples.json - 5 example recipes to learn from
• CustomRecipes.json - Empty file ready for your recipes

Reference files in the Reference/ folder show all available items, stations, and unlock conditions.

Creating Your First Recipe

Edit CustomRecipes.json:

{
  "recipes": [
    {
      "id": 900000100,
      "resultItem": "Item_Materials_Linen",
      "name": "Quick Linen",
      "ingredients": [
        {
          "item": "Item_Wood_BarkFibres",
          "quantity": 5
        }
      ],
      "quantity": 1,
      "menuLists": ["WeaverBlueprints_T1"],
      "rules": ["Weaver_Rule"],
      "interaction": "WeaverInteraction",
      "category": "Categ_Blueprints_Materials",
      "description": "Fast linen recipe",
      "lore": "Made with fewer materials"
    }
  ]
}

Important Rules

• Each recipe needs a unique ID - start from 900000001 and go up
• All item/station names must match exactly - check the Reference files
• In multiplayer, everyone needs the same recipes

Where to Find Values

Open these files in Reference/ folder:

• Items.txt - All craftable items
• Stations.txt - Crafting stations (Workshop, Weaver, etc.)
• MenuLists.txt - Where recipes appear in menus
• Categories.txt - Blueprint categories
• Rules.txt - Unlock requirements

Common Crafting Stations

• Player Inventory: VirtualCraftingStation
• Workshop: WorkstationInteraction
• Weaver: WeaverInteraction
• Leatherworker: LeatherworkerTableInteraction

Configuration

Config file: BepInEx/config/com.ranensol.aska.craftblueprints.cfg

CreateExampleFile = true      # Create Examples.json on launch
CreateCustomRecipeFile = true # Create CustomRecipes.json on launch
DumpReferenceFiles = true     # Create reference files on launch

Set to false to prevent file recreation.

Troubleshooting

Recipes not showing up?

• Check BepInEx console for error messages
• Verify item names match Reference files exactly
• Make sure your recipe ID is unique
• Check that you meet unlock requirements

Want to disable example recipes?

• Set CreateExampleFile = false in config
• Delete Examples.json

Example Recipes Included

1. Linen Cloth - Weaver recipe
2. Linen Thread - Weaver recipe
3. Leather Hide - Leatherworker recipe
4. Simple Torch (Fish Oil) - Workshop recipe
5. Simple Bow - Player inventory recipe

Support

• Report bugs: GitHub Issues
• View source: GitHub Repository

Credits

Created by Ranensol