Config & Command

Commands

1. /mmoupgrade admin reload This command reloads the plugin if you've modified the plugin's configuration files.

2. /mmoupgrade upgrade <file name> This command opens the Upgrade GUI that you've created, found in the upgrade folder.

3. /mmoupgrade gem <file name> This command opens the Gem Add Socket GUI that you've created, found in the gem folder.

4. /mmoupgrade repair <file name> This command opens the Repair GUI that you've created, found in the repair folder.

Config

1. Dynamic Configuration

You can configure .yml files as needed to achieve unique GUI functionalities.

Config

---

2. Gui Design

Customize the GUI to your liking, including slot adjustments and support for Custom Model Data.

# GUI customization
gui:
  title: "&bSword Upgrade Station" # GUI title
  rows: 6 # GUI rows (1-6)
  slots:
    item: 13 # Slot for the item to upgrade
    material: 21 # Slot for upgrade material
    protection: 23 # Slot for protection material
    success-stone: 22 # Slot for success rate boost material (if enabled)
    confirm:
      material: GREEN_STAINED_GLASS_PANE # Confirm button material
      name: "&a&lConfirm Upgrade" # Confirm button name
      lore: # Confirm button lore
        - "&7Click to upgrade"
        - "&7Just click it! {rate}"
        - "Material: {material}"
        - "Cost: {cost}"
      slot: 40 # Confirm button slot
      cmd: 1 # Custom Model Data (if any)
    filter:
      name: "&f" # Filter name (not displayed)
      material: BLACK_STAINED_GLASS_PANE # Filter material
      cmd: 1 # Custom Model Data (if any)

---

3. Text And Sound

Customize text and sounds as you desire, with support for RGB Colors and Minecraft Color Codes.

# Sound settings
# https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
sounds:
  upgrade-success: ENTITY_EXPERIENCE_ORB_PICKUP # Sound on successful upgrade
  upgrade-fail: BLOCK_ANVIL_DESTROY # Sound on failed upgrade
  confirm-no-item: BLOCK_NOTE_BLOCK_PLING # Sound when confirming with no item

Supports RGB and standard color codes.
1.RGB = &#ffffff
2.Standard = &f
https://www.birdflop.com/resources/rgb/

messages:
  gui:
    not-enough-money: "need {cost} for upgrade item"
    wrong-item: "Incorrect item!"
    wrong-upgrade-item: "This item cannot be upgraded"
    required-material-item: "Please place {amount} {material_name} in the Material slot."
    place-an-item-in-slot: "Place the item you want to upgrade before pressing Confirm"
    destroy-item-upgrade: "Destroy Item."
  upgrade:
    level-to-zero-upgrade: "Upgrade failed! Reset to level 0"
    level-up-upgrade: "&aUpgrade successful! New level: &e{level}"
    level-down-upgrade: "Upgrade failed! Item level decreased"
    level-fail-upgrade:
      - "&c------------------------"
      - "&cUPGRADE FAILED!"
      - "&7Your item did not upgrade."
      - "&c------------------------"
    level-fail-protection-upgrade: "Upgrade failed, but item was protected"
    error-upgrade-template: "An error occurred during upgrade"
    level-max-upgrade-item: "Upgrade reached maximum level"
    no-upgrade-template-item: "This item has no upgrade template"
    wrong-upgrade-item: "This item cannot be upgraded"
    place-an-item-in-slot: "Place the item you want to upgrade before pressing Confirm"
  gem-add-socket:
    max-reached: "max-reached"
    socket-added: "Successfully added a Gem slot!"
    socket-add-failed: "Failed to add a socket"
    invalid-mmoitem: "This item is not a valid MMOItem!"
    invalid-item-type: "This item type cannot have Gem slots added."
    error-add-socket: "An error occurred while adding a Gem slot: {error}"
    cannot-add-sockets: "This item cannot have Gem slots added. Please check the type."
    invalid-item: "Invalid item"
    no-money: "You don't have Cost: ({cost})"
    required-material-item: "required Steel Ingot 1ea"
  repair:
    invalid-slots: "Invalid item slot(s)."
    insufficient-funds: "You do not have enough money (requires {cost})."
    success: "Item(s) repaired."
    no-items-repaired: "No items were repaired."
    cancel-item: "&cYou can only place items in the repair slot."

---

4. Permissions

You can define permissions for each GUI. If a user doesn't have the necessary permission, they won't be able to open that GUI.

settings:
  permission: nwmmoupgrade.upgrade.sword