⚙️ settings.yml

This file controls global behavior for the runes module, including socketing logic, GUI appearance, formatting, failure handling, and user feedback settings.

---

📁 File Location

plugins/Divinity/modules/runes/settings.yml

---

🧾 Configuration

command-aliases: runes

general:
  stack-levels: false

socketing:
  allow-duplicated-items: false

  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: true
    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:
    - '&8&m               &f  「 INFO 」  &8&m               '
    - '&7Enchant Chance: &a&l%ITEM_SUCCESS_RATE%%'
    - '&7Tier: %TIER_NAME%'
    - '%ITEM_CHARGES%'
    - '%ITEM_LORE%'
    - '&8&m         &f  「 REQUIREMENTS 」  &8&m        '
    - '%TARGET_LEVEL%'
    - '%TARGET_TYPE%'
    - '%TARGET_MODULE%'
    - '%TARGET_SOCKET%'
    - '%TARGET_TIER%'
    - '&8&m               &f 「 USAGE 」 &8&m               '
    - '&7Drag & Drop onto item to start socketing.'

gui:
  title: '&3&l<&3&nRune Socketing&3&l>'
  size: 9
  item-slot: 3
  source-slot: 4
  result-slot: 5
  content:
    filler:
      material: BLACK_STAINED_GLASS_PANE
      skull-hash: ''
      enchanted: false
      name: ''
      lore: []
      slots: 0,1,2,3,4,5,6,7,8
      type: NONE
    accept:
      material: LIME_STAINED_GLASS_PANE
      skull-hash: ''
      enchanted: false
      name: '&2« &aAccept &2»'
      lore:
        - '&7You will try to socket the rune'
        - '&7into your item.'
        - ''
        - '&7In case of failure your item'
        - '&7will be &cdestroyed&7.'
      slots: '8'
      type: ACCEPT
    exit:
      material: RED_STAINED_GLASS_PANE
      skull-hash: ''
      enchanted: false
      name: '&4« &cCancel &4»'
      lore: []
      slots: '0'
      type: EXIT

---

🔍 Explanation of Settings

Section	Key	Description
command-aliases	runes	Command alias used for this module.
general.stack-levels	false	Prevents merging rune levels when stacking items.
socketing.allow-duplicated-items	Controls whether players can socket runes into identical items multiple times.
animated-bar	Custom action bar progress UI for socket attempts.
merchant.enabled	Enables or disables merchant GUI for socketing.
actions-complete / actions-error	Particle, sound, and title effects for success/failure events.
failure.destroy-target	Destroys item on fail.
failure.silent-rate-bonus	Applies bonuses based on empty sockets in item.
item-format.name/lore	Default display name and lore for rune items.
gui	Controls GUI layout and behavior for the standalone socketing menu.

---

🔗 Back to Hub

← Return to Runes Module