Recipe Auto-Scaffolder (/cb generate)
Authoring dozens of blueprint YAML files by hand for existing crafting recipes can take hours. CraftingBlueprints includes a high-performance Recipe Auto-Scaffolder (/cb generate) that inspects your server's registered Bukkit recipes and external item plugins, automatically generating schema-valid blueprint YAML files with calibrated map aesthetics and scaled economy prices in seconds.
Command Syntax & Parameters
Permission Required: craftingblueprints.admin.generate (Default: op).
Supported Recipe Sources (<source>)
The scaffolder can target specific categories, namespaces, or external plugins:
| Source Identifier | Source Scope & Content |
|---|---|
weapons |
Swords, axes, bows, crossbows, tridents, shields, and arrows. |
armor |
Helmets, chestplates, leggings, boots, horse armor, and turtle shells. |
tools |
Pickaxes, shovels, axes, hoes, shears, fishing rods, flint and steel, compasses, and brushes. |
potions |
All registered brewing PotionType variants. |
enchantments |
All registered vanilla enchantments. |
redstone |
Pistons, observers, hoppers, dispensers, droppers, repeaters, comparators, crafters, and TNT. |
food |
Craftable food items, golden carrots, and enchanted golden apples. |
building |
Stairs, slabs, walls, fences, gates, doors, bricks, terracotta, and concrete. |
all |
Every craftable recipe registered in Bukkit.recipeIterator() plus potions and enchantments. |
minecraft:<category> |
Scoped vanilla namespace filtering (e.g. minecraft:weapons). |
itemsadder |
Scans all custom items registered in the ItemsAdder registry (ia:<namespace:id>). |
oraxen |
Scans all custom items registered in the Oraxen registry (oraxen:<id>). |
nexo |
Scans all custom items registered in the Nexo registry (nexo:<id>). |
Scaffolder Flags Reference
| Flag | Parameter Type | Description |
|---|---|---|
--mode |
single | package |
Generates individual blueprints (single, default) or bundles items into packaged sets (package, chunked at up to 24 items per pack). |
--price-scale |
Decimal factor | Multiplies base heuristic prices (Common: 250, Uncommon: 800, Rare: 2500, Legendary: 15000). Default: 1.0. |
--filter |
Regex pattern | Selectively includes only recipes matching the regex (e.g. .*_sword$). |
--template |
Template ID | Applies a reusable template mixin to all generated blueprints without hardcoding repeated fields. |
--out |
Relative path | Destination file inside blueprints/ (e.g. --out weapons/swords.yml). Auto-appends .yml. |
--theme / --background |
Theme ID | Sets the map background theme (forge, royal, technical_slate, dwarven_magma). |
--frame / --tier |
Frame ID / Tier | Sets corner frame geometry (bracket, chamfer, diamond, runic, rosette, star). |
--prefix |
String | Prefixes all generated blueprint IDs (e.g. --prefix smp_ generates smp_diamond_sword). |
--dry-run |
Flag | Simulates generation and displays matched item counts without writing to disk or database. |
--force |
Flag | Overwrites destination files and bypasses first-win ID collision warnings. |
--no-reload |
Flag | Generates the YAML file on disk without immediately hot-reloading it into memory. |
Production Scaffolding Examples
1. Scaffold All Swords into a Dedicated File
Scans all vanilla weapon recipes, filters for swords, applies a 1.5x price multiplier, and sets the dwarven forge map theme:
/cb generate minecraft:weapons --filter=".*_sword$" --price-scale=1.5 --theme=forge --frame=rosette --out="weapons/swords.yml"
2. Scaffold a Packaged Armor Set
Bundles all armor recipes into multi-item package portfolios:
3. Scaffold Custom Weapons from ItemsAdder
Scans custom weapons registered in ItemsAdder, preserving custom model data and names:
Automatic Schema Header Injection
Every file generated by /cb generate automatically includes the relative language server schema directive at the top:
# yaml-language-server: $schema=../blueprint.schema.json
singles:
diamond_sword:
blueprint: DIAMOND_SWORD
name: "<aqua>Diamond Sword Blueprint</aqua>"
permanent: true
price: 3750.0
sell_price: 937.5
item:
material: FILLED_MAP
map:
theme: technical_slate
frame: bracket
badge: crafting
This guarantees that as soon as you open the generated file in your code editor, full IntelliSense and schema validation are active immediately!