Skip to content

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 --item flag 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_price into the player's Vault account balance.
# Sell held blueprint
/cb sell

/cb give <player> <blueprint_id> [amount]

Grants physical blueprint items directly to a target player:

  • Quantity Bounds: The amount parameter strictly requires a positive integer between 1 and 2304 (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 of config.yml, language files, and declarative YAML blueprints.
  • /cb reload blueprints: Re-reads and recompiles all files in blueprints/, updates the shared database, and emits a network sync signal to worker nodes.
  • /cb reload config: Reloads config.yml (groups, restrictions, crafter rules, cache).
  • /cb reload lang: Hot-reloads messages_en.yml and messages_es.yml translations.

/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, and Enchantment exists 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] ======================================