Permissions & LuckPerms Guide
This guide provides the complete permission nodes reference for CraftingBlueprints, explains recipe group permission mechanics, and provides copy-paste LuckPerms configurations for production server ranks.
Master Permissions Table
| Permission Node | Default Assignment | Description & Access Scope |
|---|---|---|
craftingblueprints.* |
Server Operators (op) |
Grants unrestricted access to all commands, editors, and administrative tools. |
craftingblueprints.menu |
true (All Players) |
Allows opening the personal progression dashboard (/cb menu). |
craftingblueprints.buy |
true (All Players) |
Allows purchasing blueprints using Vault economy (/cb buy <id> [--item]). |
craftingblueprints.sell |
true (All Players) |
Allows selling the blueprint held in hand using Vault economy (/cb sell). |
craftingblueprints.cani |
true (All Players) |
Allows checking recipe craftability via /cb cani <item>. |
craftingblueprints.info |
true (All Players) |
Allows viewing detailed recipe specifications and lore via /cb info. |
craftingblueprints.owner |
true (All Players) |
Allows checking who unlocked or owns the held blueprint via /cb owner. |
craftingblueprints.return |
false |
Allows navigating back through previous menus using /cb return. |
craftingblueprints.item.list |
false |
Allows opening the administrative blueprint catalog GUI (/cb item list). |
craftingblueprints.item.edit |
Server Operators (op) |
Allows opening the visual in-game GUI blueprint editor (/cb item edit). |
craftingblueprints.give |
Server Operators (op) |
Allows distributing physical blueprints to players via /cb give. |
craftingblueprints.reload |
Server Operators (op) |
Allows hot-reloading configurations, translations, and blueprints (/cb reload). |
craftingblueprints.admin |
Server Operators (op) |
Allows executing dry-run syntax validation passes (/cb validate). |
craftingblueprints.status |
Server Operators (op) |
Allows viewing system metrics, database health, and latency (/cb status). |
craftingblueprints.admin.preset |
Server Operators (op) |
Allows installing, previewing, and removing modality presets (/cb preset). |
craftingblueprints.admin.generate |
Server Operators (op) |
Allows auto-scaffolding blueprint YAML files from recipes (/cb generate). |
craftingblueprints.bypass |
Server Operators (op) |
Bypasses all recipe restrictions, allowing free crafting, brewing, and smithing. |
craftingblueprints.group.<id> |
None | Unlocks all recipes configured within the specified permission group in config.yml. |
Recipe Group Permissions (craftingblueprints.group.<id>)
In plugins/CraftingBlueprints/config.yml, you define permission groups (e.g., default, vip, pro, alchemist):
To grant all recipes in the vip group to your VIP rank, assign the node:
Because vip inherits default, players with this permission automatically unlock all recipes in default as well.
Production LuckPerms Configurations
Below are ready-to-use configurations for standard server ranks:
Run these commands in your server console or in-game as an administrator:
# --------------------------------------------------
# 1. Default Players (default rank)
# --------------------------------------------------
lp group default permission set craftingblueprints.menu true
lp group default permission set craftingblueprints.buy true
lp group default permission set craftingblueprints.sell true
lp group default permission set craftingblueprints.cani true
lp group default permission set craftingblueprints.info true
lp group default permission set craftingblueprints.owner true
lp group default permission set craftingblueprints.group.default true
# Optional: Allow players to browse the server catalog
# lp group default permission set craftingblueprints.item.list true
# --------------------------------------------------
# 2. VIP Players (vip rank)
# --------------------------------------------------
lp group vip permission set craftingblueprints.group.vip true
# --------------------------------------------------
# 3. Moderators & Staff (moderator rank)
# --------------------------------------------------
lp group moderator permission set craftingblueprints.item.list true
lp group moderator permission set craftingblueprints.return true
lp group moderator permission set craftingblueprints.status true
# --------------------------------------------------
# 4. Server Administrators (admin rank)
# --------------------------------------------------
lp group admin permission set craftingblueprints.* true
If you manage LuckPerms via file storage (plugins/LuckPerms/yaml-storage/groups.yml):
default:
permissions:
- craftingblueprints.menu:
value: true
- craftingblueprints.buy:
value: true
- craftingblueprints.sell:
value: true
- craftingblueprints.cani:
value: true
- craftingblueprints.info:
value: true
- craftingblueprints.owner:
value: true
- craftingblueprints.group.default:
value: true
vip:
parents:
- default
permissions:
- craftingblueprints.group.vip:
value: true
moderator:
parents:
- default
permissions:
- craftingblueprints.item.list:
value: true
- craftingblueprints.return:
value: true
- craftingblueprints.status:
value: true
admin:
permissions:
- craftingblueprints.*:
value: true
Network & World-Specific Permissions
On multi-server networks or multi-world servers where crafting progression differs between worlds (e.g. Survival vs Creative):