Pre-Built Presets (/cb preset)
New server administrators frequently encounter the "blank-page problem": having to manually write dozens of YAML blueprints, permission groups, and recipe restrictions before seeing how the plugin transforms gameplay.
CraftingBlueprints solves this with a modular Preset Engine (/cb preset) that allows you to preview, deploy, customize, and cleanly uninstall balanced, production-ready progression packs with a single command.
What is a Preset Package?
A Preset is a self-contained archive (.zip) or directory placed inside plugins/CraftingBlueprints/presets/ with a modular structure:
plugins/CraftingBlueprints/presets/<preset_id>/
├── preset.yml # Metadata manifest (id, name, author, version, description)
├── blueprints/ # Blueprint recipes (00_templates.yml, weapons.yml, armor.yml)
├── images/ # Visual map assets (backgrounds/, badges/, frames/)
└── config/ # Modular configuration files (groups.yml, restrictions.yml)
The Inactive Repository vs Deployed Targets
- Inactive Repository (
plugins/CraftingBlueprints/presets/): You can store, download, and organize preset.zipbundles or folders here without triggering live server imports or altering your database. - Active Deployment Targets: Presets only become active in-game when deployed via
/cb preset apply <id> --confirm:- Blueprints deploy to:
plugins/CraftingBlueprints/blueprints/presets/<id>/... - Images deploy to:
plugins/CraftingBlueprints/images/presets/<id>/... - Configurations deploy to:
plugins/CraftingBlueprints/configs/presets/<id>/...
- Blueprints deploy to:
Built-In Modality Presets (PresetCatalog)
CraftingBlueprints ships with 4 built-in, production-balanced presets:
| Preset ID | Display Title | Templates | Blueprints Breakdown | Progression & Gameplay Model |
|---|---|---|---|---|
hardcore_smp |
Hardcore SMP Survival | 4 |
42 total (36 singles, 4 packages, 2 mysteries) |
restricted-only: Basic wood/stone free; iron unlocked via default group; Diamond, Netherite, Mending, and high-tier potions require blueprints with forge and royal map themes. |
rpg_tiers |
RPG Progression Tiers (T1–T5) | 5 |
34 total (28 singles, 4 packages, 2 mysteries) |
restricted-only: T1 apprentice through T5 mythic weapons, armors, runes, and class kits unlocking via tiered blueprints (bracket -> rosette). |
skyblock_coop |
Skyblock Co-op & Automation | 4 |
28 total (22 singles, 4 packages, 2 mysteries) |
restricted-only: Island basics and farming free; diamond/netherite tools, beacons, shulker boxes, and silk touch require blueprints. |
prison_ranks |
OP Prison Ranks & Pickaxes | 4 |
26 total (22 singles, 2 packages, 2 mysteries) |
restricted-only: Progressive ranks (default -> rank_b -> rank_c -> rank_prestigious) unlock tiered drills, efficiency, and fortune pickaxes. |
Preset Command Interface
1. Listing Presets (/cb preset list)
Lists all built-in presets and local packages discovered in presets/:
2. Previewing & Applying Presets (/cb preset apply)
Before modifying your live server, execute a dry-run preview:
The plugin analyzes the preset and displays the exact blueprint counts, target file paths, and collision checks without writing to disk or database.
To deploy the preset permanently, pass --confirm:
Dynamic Modifiers on Install:
You can scale prices, set usage limits, or isolate IDs during deployment:
# Multiply all prices by 1.5 (+50% cost)
/cb preset apply rpg_tiers --price-mult=1.5 --confirm
# Alternatively, use price increase percentage:
/cb preset apply rpg_tiers --price-increase=+25% --confirm
# Force all blueprints to have a finite 5-use craft limit:
/cb preset apply hardcore_smp --uses=5 --confirm
# Scale existing time durations by 2x:
/cb preset apply hardcore_smp --time-scale=2.0 --confirm
# Isolate under a custom prefix folder (prevents ID collisions):
/cb preset apply rpg_tiers --prefix="season2" --confirm
# Filter to selectively import only swords and armor:
/cb preset apply hardcore_smp --filter=".*(sword|armor).*" --confirm
3. Clean Uninstallation (/cb preset remove <id>)
Administrators can completely uninstall an active preset without leaving leftover residues (zero-leftovers):
This command:
- Safely deletes deployed folders across
blueprints/presets/hardcore_smp/,images/presets/hardcore_smp/, andconfigs/presets/hardcore_smp/. - Clears image caches and reloads groups and recipe restrictions.
- Automatically prunes the recipes from the database and broadcasts a sync signal to all worker nodes.
4. Exporting Custom Blueprints (/cb preset export)
To bundle existing blueprints into a shareable preset package:
Creates a distributable my_custom_pack.zip archive inside plugins/CraftingBlueprints/presets/ containing your blueprint YAMLs, images, and config files.
Zero config.yml Mutation Rule
Deploying or removing presets NEVER modifies your config.yml.
- Why? Directly appending or deleting lines from
config.ymloften corrupts custom comments, destroys formatting, and creates merge conflicts in Git. - The Solution: Presets deploy modular configuration files to
configs/presets/<id>/groups.ymlandconfigs/presets/<id>/restrictions.yml. The plugin's engine aggregates these modular files in memory dynamically at runtime.
Master / Worker Safety Guard
In multi-server MySQL networks:
- Preset modifications (
apply,remove,export) are strictly restricted to the Primary Management Node (sync-from-files: true). - Executing
/cb preset applyon a Worker Node (sync-from-files: false) is blocked immediately with a clear localized error redirecting you to execute the command on the master server.