⚙️ gems-settings

This page explains how to configure global behavior for the gems module, including socketing mechanics, failure handling, visual effects, and GUI layout.

---

📁 File Location

Settings for the gems module are defined in:

plugins/Divinity/modules/gems/settings.yml

---

🧾 Example

command-aliases: gems

socketing:
  allow-duplicated-items: true

  animated-bar:
    enabled: true
    bar-title: '&e&lSocketing...'
    bar-char: â—¼
    bar-size: 20
    bar-format: '&a&l%success%%&r %bar%&r &c&l%failure%%'
    color-neutral: DARK_GRAY
    color-success: GREEN
    color-failure: RED
    fill-interval: 1
    fill-amount: 1
    min-success: 50

  merchant:
    enabled: true

  actions-complete:
    default:
      conditions:
        list: []
        actions-on-fail: 'null'
      action-executors:
        - '[PARTICLE_SIMPLE] ~name: SPELL_WITCH; ~offset: 0.25,0.4,0.25; ~speed: 0.2; ~amount: 50; ~target: self;'
        - '[SOUND] ~name: BLOCK_NOTE_BLOCK_BELL; ~target: self;'
        - '[TITLES] ~title: &a&lSocketing; ~subtitle: &7You successfully socketed item!; ~fadeIn: 10; ~stay: 40; ~fadeOut: 10; ~target: self;'
      target-selectors:
        - '[SELF] ~name: self;'

  actions-error:
    default:
      conditions:
        list: []
        actions-on-fail: 'null'
      action-executors:
        - '[SOUND] ~name: ENTITY_VILLAGER_NO; ~target: self;'
        - '[TITLES] ~title: &c&lSocketing; ~subtitle: &7You could not socket item!; ~fadeIn: 10; ~stay: 40; ~fadeOut: 10; ~target: self;'
      target-selectors:
        - '[SELF] ~name: self;'

  failure:
    destroy-target: false
    destroy-source: false
    wipe-filled-sockets: false

    silent-rate-bonus:
      max-bonus: 20
      by-item-sockets:
        '0': 7
        '1': 5
        '2': 3
        '3': 1

  merchantenabled: true

item-format:
  name: '%TIER_COLOR%%ITEM_NAME% %ITEM_LEVEL_ROMAN%'
  lore:
    - '%TARGET_TYPE%'
    - '%TARGET_LEVEL%'
    - '%TARGET_SOCKET%'
    - '&8--------------------'
    - '%ITEM_LORE%'

gui:
  title: '&0« Socketing »'
  size: 9
  item-slot: 3
  source-slot: 4
  result-slot: 5
  content:
    filler:
      material: BLACK_STAINED_GLASS_PANE
      name: ''
      lore: []
      slots: 1,2,6,7
      type: NONE

    accept:
      material: LIME_STAINED_GLASS_PANE
      name: '&2« &aAccept &2»'
      lore:
        - '&7Attempt to socket gem into the item.'
        - '&7In case of failure your item will be &cdestroyed&7.'
        - ''
        - '&f[Click to Confirm]'
      slots: '8'
      type: ACCEPT

    exit:
      material: RED_STAINED_GLASS_PANE
      name: '&4« &cCancel &4»'
      lore: []
      slots: '0'
      type: EXIT

---

🔍 Key Sections

Section	Description
command-aliases	Defines aliases for the gem socketing command
socketing.allow-duplicated-items	Allows socketing duplicate gems into the same item
animated-bar	Displays a progress bar for socketing success/failure rate
actions-complete	Visual/sound/title effects when socketing succeeds
actions-error	Visual/sound/title effects when socketing fails
failure	Determines what happens on failure (destroy items, wipe so