配置與指令

指令列表

1. /mmoupgrade admin reload 此指令會重新載入插件，當你修改了插件的設定檔案時請使用

2. /mmoupgrade upgrade <檔案名稱> 此指令會開啟你所建立的升級介面（Upgrade GUI），設定檔需放在 upgrade 資料夾中

3. /mmoupgrade gem <檔案名稱> 此指令會開啟你所建立的增加插槽介面（Gem Add Socket GUI），設定檔需放在 gem 資料夾中

4. /mmoupgrade repair <檔案名稱> 此指令會開啟你所建立的修復介面（Repair GUI），設定檔需放在 repair 資料夾中

配置說明

1. 動態配置

你可以根據需要設定 .yml 檔案，以實現獨特的 GUI 功能

Config

---

2. GUI 設計

可自由自訂 GUI，包括格子(slot)位置調整，並支援 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. 文字與音效

你可以依照需求自訂文字與音效，支援 RGB 色碼與 Minecraft 顏色代碼

# 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. 權限設定

你可以為每個 GUI 定義對應的權限。如果玩家沒有相應的權限，將無法開啟該 GUI

settings:
  permission: nwmmoupgrade.upgrade.sword