💠 Gem Un Socket

The Gem Add Item feature allows the Main Item to have gems inserted into it, provided that the item has empty sockets available for placing the gems.

🛠️ How Gem Un Socket Works

When you place an item with socketed gems into the item slot, the display gems will appear on the GUI, allowing the player to select and remove the gems as desired.

🔑 Permission

Each station has its own permission requirement in order to be used. Of course, you can customize or change the permission to suit your needs.

settings:
  permission: nwmmoupgrade.gemunsocket.sword

🌟 Features

1. Material Item

If enabled, this means the operation of the station will require the specified materials in order to function as intended. You can define one or more material items, and the station will only execute if the player provides the required materials.

materials:
  enabled: false
  items:
    - type: MATERIAL
      id: STEEL_INGOT
      amount: 5
      slot: 30
      #match-item-type: SWORD #filter option
      #match-tier-type: RARE #filter option
      #match-item:
      # - SWORD:KATANA

Note:

type is the type of the MMOItem.
id is the ID of the MMOItem.
amount is the quantity of the material required.
slot is the GUI slot where the material must be placed.

Options

These are additional conditions that enhance material requirements:

match-item-type
match-item-tier
match-item

2. Chance Item

If enabled and used in conjunction with chance-based mechanics, the Chance Item provides an additional success rate boost on top of the existing base chance. This item acts as a support to increase the overall likelihood of success during actions such as upgrading.

chance-item:
  enabled: false
  items:
    - type: MATERIAL
      id: RARE_DIAMOND
      amount: 5
      slot: 32
      chance: 50
      #match-item-type: SWORD #filter option
      #match-tier-type: RARE #filter option
      #match-item:
      # - SWORD:KATANA
    - type: MATERIAL
      id: SILVER_INGOT
      amount: 1
      slot: 32
      chance: 50
      #match-item-type: ARMOR #filter option
      #match-tier-type: RARE #filter option
      #match-item:
      # - SWORD:KATANA

Note:

type is the type of the MMOItem.
id is the ID of the MMOItem.
amount is the quantity of the material required.
slot is the GUI slot where the material must be placed.
chance This sets the success chance for the Chance Item.

Options

Same conditions apply:

match-item-type
match-item-tier
match-item

3. Material Formula

The Material Formula feature provides a highly flexible way to dynamically calculate the cost and material requirements for item.

Material Increase

When this feature is enabled (enabled: true), the quantity of material items required for an gem add socket will increase as the item's level rises. This ensures that higher-level upgrades demand a greater investment from players.

In Short: Level Up = Material Requirements.

Formula Configuration

material-formula:
  enabled: true
  formula: "1"

4. Cost

This feature allows you to use currencies such as PlayerPoints, CoinsEngine, or Vault.

cost:
    enabled: true
    currency: pp
    amount: 5000

cost:
    enabled: true
    currency: ce;nwcoin
    amount: "{global_custom_advance_cost_item}"

cost:
    enabled: true
    amount: 100

5. Default Chance

This feature allows you to set the success chance of this station yourself, in cases where Tier is not enabled.

options:
    ....
    default-chance: 0

6. Tiers

This feature allows you to set the success chance based on the tiers of the item placed in the item slot.

options:
    ....
    tiers:
      enabled: false
      no-tier-chance: 10
      tier-list:
        - tier: COMMON
          chance: 2
        - tier: RARE
          chance: 15

Example Full Config

##########################################################################
#
#                         nwMMOUpgrade - Gem Un Socket
#      Created By Discord NN#7999 (Newworld Server)
#
#      Supports RGB and standard color codes.
#      1.RGB = &#ffffff
#      2.Standard = &f
#      3. MiniMessage = <red>
#      4. Legacy Hex = &x
#      https://www.birdflop.com/resources/rgb/
#
##########################################################################

#Contact&Support: https://discord.gg/gwXcr7c6Gq

#MMOItems Type
applies-to:
  - SWORD

# Sound settings
#https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
sounds:
  confirm-success: ENTITY_EXPERIENCE_ORB_PICKUP
  confirm-fail: BLOCK_ANVIL_DESTROY
  confirm-no-item: BLOCK_NOTE_BLOCK_PLING

#GUI customization
gui:
  #GUI title, should support images normally.
  title: "&#F2C6DEM&#F3C9E0e&#F3CCE2n&#F4D0E4u&#F5D3E5: &#F6D9E9G&#F7DCEBe&#F8DFEDm &#F9E6F0U&#FAE9F2n &#FBEFF6S&#FCF2F8o&#FDF6FAc&#FEF9FBk&#FEFCFDe&#FFFFFFt"
  rows: 6 #GUI slots
  display-slots:
    item:
      material: LIME_STAINED_GLASS_PANE
      name: "<color:#00FF4F>Place the item to upgrade<color:#57E342>"
      lore:
        - "&7Drag and drop your item here"
      cmd: 1
    material:
      material: YELLOW_STAINED_GLASS_PANE
      name: "<color:#E7FF00>Place the materials<color:#F2FF08>"
      lore:
        - "&7Drag and drop the required materials here"
      cmd: 1
    chance:
      material: PINK_STAINED_GLASS_PANE
      name: "<color:#FF00F8>Place a chance-enhancing stone (if any)<color:#E68DFF>"
      lore:
        - "&7Drag and drop the chance-enhancing stone here"
      cmd: 1
    display-gem-un-socket:
      material: PURPLE_STAINED_GLASS_PANE
      name: "&f"
      lore:
        - "&f"
      cmd: 1
      slot: [28, 29, 30, 31, 32, 33, 34]
  slots:
    item: 13
    confirm:
      material: BRICK
      name: "&a&lConfirm" #Button name
      lore: #Add your messages here.
        - "&7Click to add a un socket slot"
        # - ""
        # - "&fCost: &a{cost}"
        # - "&fSuccess Chance: &6{chance}%"
        # - "&fMaterials:"
        # - "{material}" # edit custom line -> missing-material-line: "- &4<gray>{material} <red>{amount}"
      slot:
        - 48-50
      #Supports custom model data.
      cmd: 2600
    filter:
      name: "&f" #Name
      material: BLACK_STAINED_GLASS_PANE
      cmd: 1

materials:
  enabled: false
  items:
    - type: MATERIAL
      id: STEEL_INGOT
      amount: 1
      slot: 11
      #match-item-type: SWORD #จะใส่หรือไม่ใส่ก็ได้
      #match-gem-type: GEM_STONE #จะใส่หรือไม่ใส่ก็ได้
      #match-tier-type: RARE

#พังอยุ่ ปิดไว้
chance-item:
  enabled: false
  items:
    - type: MATERIAL
      id: RARE_DIAMOND
      amount: 5
      slot: 15
      chance: 50
      #match-item-type: SWORD #จะใส่หรือไม่ใส่ก็ได้
      #match-gem-type: GEM_STONE #จะใส่หรือไม่ใส่ก็ได้
      #match-tier-type: RARE #จะใส่หรือไม่ใส่ก็ได้

settings:
  permission: nwmmoupgrade.gem.default
  cost:
    enabled: false #Cost
    amount: 5000
  options:
    material-formula:
      enabled: false
      formula: 1
    default-chance: 100
    tiers:
      enabled: false
      no-tier-chance: 10
      tier-list:
        - tier: COMMON
          chance: 2
        - tier: RARE
          chance: 15

Previous💎 Gem Add Item Next🔗 Merge

Last updated 4 months ago

hashtag🛠️ How Gem Un Socket Works

hashtag🔑 Permission

hashtag🌟 Features

hashtag1. Material Item

hashtagNote:

hashtagOptions

hashtag2. Chance Item

hashtagNote:

hashtagOptions

hashtag3. Material Formula

hashtagMaterial Increase

hashtagFormula Configuration

hashtag4. Cost

hashtag5. Default Chance

hashtag6. Tiers

🛠️ How Gem Un Socket Works

🔑 Permission

🌟 Features

1. Material Item

Note:

Options

2. Chance Item

Note:

Options

3. Material Formula

Material Increase

Formula Configuration

4. Cost

5. Default Chance

6. Tiers