Command Reference
All CraftingBlueprints commands originate from the master /cb command (alias: /craftingblueprints).
Master Command Reference Table
| Command Syntax | Arguments & Parameters | Required Permission | Default | Allowed Senders | Operational Description |
|---|---|---|---|---|---|
/cb menu |
None | craftingblueprints.menu |
true |
Players | Opens your personal unlocked blueprints dashboard (PlayerInfoMenu). |
/cb buy |
<id> [--item] |
craftingblueprints.buy |
true |
Players | Purchases a blueprint using Vault economy (direct unlock or physical item). |
/cb sell |
None | craftingblueprints.sell |
true |
Players | Sells the physical blueprint held in the main hand via Vault economy. |
/cb cani |
<item> |
craftingblueprints.cani |
true |
Players | Checks if you have the blueprint needed to craft an item. |
/cb info |
[blueprint_id] |
craftingblueprints.info |
true |
Players / Console | Opens technical blueprint details and durability inspector. |
/cb owner |
None | craftingblueprints.owner |
true |
Players | Displays the player who unlocked or owns the held blueprint item. |
/cb return |
None | craftingblueprints.return |
false |
Players | Re-opens the previous menu in the navigation history stack. |
/cb item list |
None | craftingblueprints.item.list |
false |
Operators / Staff | Opens the paginated blueprint catalog and item management GUI. |
/cb item edit |
<blueprint_id> |
craftingblueprints.item.edit |
false |
Operators | Opens the visual in-game GUI modifier for a blueprint. |
/cb give |
<player> <id> [amount] |
craftingblueprints.give |
op |
Operators / Console | Gives physical blueprint items to a player with overflow protection. |
/cb reload |
[all\|blueprints\|config\|lang] |
craftingblueprints.reload |
false |
Operators / Console | Hot-reloads configuration files, language strings, or YAML blueprints. |
/cb validate |
None | craftingblueprints.admin |
op |
Operators / Console | Executes a dry-run linting pass over all blueprint files in blueprints/. |
/cb status |
None | craftingblueprints.status |
op |
Operators / Console | Displays system diagnostics, database latency, and health metrics. |
/cb preset |
<list\|apply\|remove\|export\|download> |
craftingblueprints.admin.preset |
op |
Operators / Console | Manages pre-built modality packs in the presets/ repository. |
/cb generate |
<source> [flags] |
craftingblueprints.admin.generate |
op |
Operators / Console | Scans Bukkit recipes or plugins and auto-scaffolds YAML blueprints. |
Detailed Command Explanations & Operational Safety
/cb buy <blueprint_id> [--item]
Purchases a blueprint recipe using the server's Vault economy:
- Direct Profile Unlock (Default): Deducts the configured
price:from the player's balance and unlocks the recipe directly in their profile. The player can immediately craft the recipe. - Physical Item Delivery (
--item): When the--itemflag is specified, the player receives a physical blueprint item in their inventory. Leftover items drop safely at their feet if inventory space is full.
# Unlock directly to player profile
/cb buy ancient_netherite_axe
# Purchase as a tradeable physical item
/cb buy ancient_netherite_axe --item
/cb sell
Sells the physical blueprint currently held in the player's main hand:
- Authenticity Check: The plugin validates the item's internal persistent data container (PDC). Forged or non-blueprint items cannot be sold.
- Vault Deposit: Deducts 1 item from the main hand and deposits the configured
sell_priceinto the player's Vault account balance.
/cb give <player> <blueprint_id> [amount]
Grants physical blueprint items directly to a target player:
- Quantity Bounds: The
amountparameter strictly requires a positive integer between1and2304(the maximum physical capacity of a player inventory: 36 slots x 64 items). Negative numbers,0, non-numeric strings, or exorbitant numbers are rejected immediately with localized error feedback. - Physical Overflow Safety: When giving items to a player whose inventory is full, CraftingBlueprints uses an atomic safe-drop protocol. Instead of dropping items into the void or deleting them, leftover items are dropped safely into the world directly at the player's location (
world.dropItem(...)).
# Give Steve 1 Ancient Netherite Battleaxe blueprint
/cb give Steve ancient_netherite_axe 1
# Give Alex 5 3-use magic scrolls via console
/cb give Alex astral_blade_scroll 5
/cb reload [all|blueprints|config|lang]
Hot-reloads plugin subsystems instantly on live servers without disconnects or lag spikes:
/cb reload all: Full reload ofconfig.yml, language files, and declarative YAML blueprints./cb reload blueprints: Re-reads and recompiles all files inblueprints/, updates the shared database, and emits a network sync signal to worker nodes./cb reload config: Reloadsconfig.yml(groups, restrictions, crafter rules, cache)./cb reload lang: Hot-reloadsmessages_en.ymlandmessages_es.ymltranslations.
/cb validate
Executes an offline dry-run verification across all blueprint files in blueprints/:
- Zero Database Modifications: Performs no database inserts, updates, or prunings.
- Semantic Verification: Verifies that every Bukkit
Material,PotionType, andEnchantmentexists on the current server version. - Visual Key Linting: Recursively validates
map:blocks against valid themes, frames, and badges. - Levenshtein Suggestions: Automatically emits helpful "Did you mean?" suggestions for minor typos (e.g.
roseta->rosette). - Line-Number Error Context: In the event of a syntax error, reports the exact file path, line number, column, and error description.
/cb status
Displays comprehensive system diagnostics:
[CraftingBlueprints] ========== System Status ==========
[CraftingBlueprints] Version: 4.1.0 | Engine: Paper 1.20.4
[CraftingBlueprints] Active Adapter: Adapter_v1_20_R3 (VAL Native)
[CraftingBlueprints] Storage Backend: MySQL (HikariCP Active)
[CraftingBlueprints] Database Latency: 1.42 ms | Pool: 10 total (8 idle, 2 active)
[CraftingBlueprints] Blueprints Registered: 42 (36 singles, 4 packages, 2 mysteries)
[CraftingBlueprints] Node Role: Primary Master Node (sync-from-files: true)
[CraftingBlueprints] Active Profiles: 14 loaded
[CraftingBlueprints] Cached Maps: 42 renders cached
[CraftingBlueprints] ======================================