Commands and Permissions All commands can be used with the labels /deluxeupgrade, /du
/forge/upgrade - deluxeupgrade.use - Open the upgrades menu. (Editable)
/deluxeupgrade create <name id> - deluxeupgrade.admin - The gui will open where you will define the items you want to be used.
/deluxeupgrade list - deluxeupgrade.admin - It will open a gui with the list of created items, some such as itemsadder may not be displayed correctly, you can delete the upgrade by clicking on the upgrade.
/deluxeupgrade delete <name id> - deluxeupgrade.admin - Delete a specific upgrade, this cannot be undone.
/deluxeupgrade help - deluxeupgrade.admin - Displays a list of available commands.
/deluxeupgrade npc create- deluxeupgrade.admin - Place the npc.
/deluxeupgrade npc delete- deluxeupgrade.admin - Delete the npc.
/deluxeupgrade reload - deluxeupgrade.admin - Reload the config and messages
# Commands Configuration
# Configure which commands open the forge GUI
# You can add multiple commands that will all open the same forge GUI
commands:
# Main forge command (default: /forge)
forge:
enabled: true
aliases: [] # Additional aliases for /forge command
# Additional commands that open the forge GUI
# You can add as many as you want
upgrade:
enabled: true
aliases: ["up", "upgrades"]
# Example of a disabled command
# workshop:
# enabled: false
# aliases: ["craft"]
# ------------------------------------------------------------------------------------------#
# Requirements
# These are optional conditions for allowing an upgrade to happen.
# Each upgrade ID (e.g., "upgrade1") has its own requirement configuration.
# You can require:
# - MONEY (via Vault-compatible economy)
# - EXPERIENCE (vanilla XP levels)
# - ITEM (basic Material or custom items with Oraxen/ItemsAdder support)
# - ITEMSADDER (custom items from ItemsAdder plugin)
# - ORAXEN (custom items from Oraxen plugin)
requirements:
example1: # Here you will place the id of the upgrade you created.
enable: true
material: BOOKSHELF # Material to display as the requirement icon
name: "&c&lREQUIREMENT" # Display name
requirement: money # Options: money, experience, ITEM_ID
amount: 1000 # Amount required (e.g., $1000 or 1000 XP or 1000 items)
slot: 22 # Slot where this item appears in the forge GUI
error_message: "&cYou don't have enough money!" # Message shown if player fails the requirement
lore:
- "&7"
- "&cMoney requirement: &a$1.000"
commands: # Commands to run when requirement is successfully met
- "say %player_name% Your money was consumed!"
# ItemsAdder requirement example
itemsadder_upgrade:
enable: true
material: DIAMOND_SWORD # Material to display as the requirement icon (fallback)
name: "&6&lMAGIC CRYSTAL REQUIREMENT" # Display name
requirement: ITEMSADDER # Requirement type for ItemsAdder items
itemsadder_item_id: "magic_crystal" # ItemsAdder item ID (without IA: prefix)
amount: 5 # Amount required (5 magic crystals)
slot: 23 # Slot where this item appears in the forge GUI
error_message: "&cYou need 5 Magic Crystals!" # Message shown if player fails the requirement
lore:
- "&7"
- "&6Magic Crystal requirement: &a5x"
- "&7"
- "&e&lItemsAdder Item"
commands: # Commands to run when requirement is successfully met
- "say %player_name% Your magic crystals were consumed!"
- "tellraw %player_name% {\"text\":\"Magic crystals consumed!\",\"color\":\"gold\"}"
# Another ItemsAdder example with namespace
legendary_weapon_upgrade:
enable: true
material: NETHERITE_SWORD
name: "&5&lLEGENDARY WEAPON REQUIREMENT"
requirement: ITEMSADDER
itemsadder_item_id: "weapons:legendary_sword" # ItemsAdder item with namespace
amount: 1
slot: 24
error_message: "&cYou need a Legendary Sword!"
lore:
- "&7"
- "&5Legendary Weapon required: &a1x"
- "&7"
- "&d&lItemsAdder Weapon"
commands:
- "say %player_name% Legendary sword consumed!"
# ------------------------------------------------------------------------------------------#
# Sounds Configuration
# Configure the sounds that play when upgrade succeeds or fails
# You can use vanilla Minecraft sounds or custom sounds
# Examples of available sound types: BLOCK_ANVIL_USE, ENTITY_PLAYER_LEVELUP, ENTITY_VILLAGER_NO, UI_BUTTON_CLICK
sounds: # Sound that plays when upgrade succeeds
success:
type: "BLOCK_ANVIL_USE" # Vanilla sound enum
volume: 1.0
pitch: 1.0[/LEFT]
[CENTER]
[/CENTER]
Code (Text):
no_permission: "&cYou don't have permission to use this command!"[/B][/LEFT]
[B]
[LEFT]player_only: "&cThis command can only be used by players!"
upgrade_not_found: "&cUpgrade not found!"
upgrade_created: "&aUpgrade created successfully!"
upgrade_deleted: "&aUpgrade deleted successfully!"
config_reloaded: "&aConfiguration reloaded!"
invalid_args: "&cInvalid arguments! Use /deluxeupgrade help"
help_header: "&6=== DeluxeUpgrade Help ==="
help_create: "&e/deluxeupgrade create <id> &7- Create a new upgrade"
help_list: "&e/deluxeupgrade list &7- List all upgrades"
help_delete: "&e/deluxeupgrade delete <id> &7- Delete an upgrade"
help_reload: "&e/deluxeupgrade reload &7- Reload configuration"
help_forge: "&e/forge &7- Open the forge menu"
click_to_edit: "&eLeft click to edit"
click_to_delete: "&cRight click to delete"
forge_button: "&a&lFORGE"
save_button: "&a&lSAVE &a✓"
add_item_button: "&e&lAdd base slot +"
no_item_to_upgrade: "&c✗ You must place an item to upgrade."
no_upgrade_found: "&c✗ No valid upgrade found for the selected items."