Configuration

Main Options

config.yml controls language, compatibility preservation, socketing, perforation, slot limits, and tool items.

Option	Description
config-version	Internal configuration version used by the auto-updater.
language	Message language.
global.preserve-nbt-tags	NBT tags preserved during item operations.
gem-socket.disable-native-socketing	Disables MMOItems native socketing and forces the plugin GUI.
gem-socket.cost	Vault money cost for socketing.
gem-socket.exp-cost	Experience cost for socketing.

Supported language values:

Value	Language
en_US	English
zh_CN	Simplified Chinese
zh_TW	Traditional Chinese
ru_RU	Russian
de_DE	German

Preserved NBT

global:
  preserve-nbt-tags:
    - "MMOitemsUpgrade"
    - "MMOITEMS_PGEM_SLOTS"

Only add tags that MMOItems does not already handle automatically. The default configuration intentionally avoids preserving native ability or permanent effect tags because MMOItems LiveMMOItem handles those.

Socketing

gem-socket:
  disable-native-socketing: true
  cost: 500
  exp-cost: 100

When disable-native-socketing is true, players should use /mmogemslot socket to open the socketing GUI. When it is false, this command is disabled and MMOItems native socketing remains available.

Perforation

perforation:
  max-slots: 5
  cost: 1000
  success-rates:
    - 80
    - 60
    - 40
    - 20
    - 10

success-rates is ordered by the slot being added. If the slot number exceeds the list length, the last configured value is used.

Allowed Item Types

perforation:
  allowed-weapon-types:
    - SWORD
    - DAGGER
    - AXE
    - STAFF
    - BOW

Only matching MMOItems types can be perforated unless you expand this list.

Gem Slot Types

perforation:
  gem-slot-types:
    - name: "Red"
      display-name: "&cRed Gem Slot"
      material: RED_STAINED_GLASS_PANE
      custom-model-data: 0

The name value must match the MMOITEMS_GEM_COLOR value on your gems.

Slot Limits

Per-type and per-item color limits are configured under perforation.slot-limits.

perforation:
  slot-limits:
    by-type:
      SWORD:
        Red: 2
        Sapphire: 3
    by-id:
      "SWORD:FIRE_SWORD":
        Red: 1
        Sapphire: 4

Item ID rules take priority over type rules. When an item matches a rule, any slot color not listed in that rule is treated as 0 and cannot be added.

Tools

The perforator and gem remover are configured under:

perforation:
  perforator:
    material: DIAMOND_PICKAXE
    name: "&bGem Perforator"
    custom-model-data: 1001
    consume: true
  gem-remover:
    enabled: true
    material: DIAMOND_PICKAXE
    name: "&cGem Remover"
    custom-model-data: 1002
    consume: true

Both tools support exact name matching, optional lore checks, custom model data, and consumption settings.