🛒 merchant.yml

This file configures the merchant socketing system, where players can combine items and runes through a graphical interface. It controls socketing chances, GUI layout, pricing logic, and visual elements for the rune socketing experience.

---

📁 File Location

plugins/Divinity/modules/runes/merchant.yml

---

🧾 Configuration

socketing:
  chance:
    merchant-bonus:
      amount: 15
      maximal: 80
  silent-rate-bonus:
    enabled: false

price:
  socket-worth-modifier: 1.0
  item-worth-modifier: 1.2

gui:
  title: '&8&m    &9&l Merchant Socketing &8&m    '
  size: 45
  item-slot: 20
  source-slot: 22
  result-slot: 24
  animation:
    tick: 10
    progressive: true
  content:
    filler_1:
      material: BLACK_STAINED_GLASS_PANE
      skull-hash: ''
      enchanted: false
      name: ''
      lore: []
      slots: 2,3,4,5,6,10,11,15,16,19,28,29,25,34,33,38,39,40,41,42,12,21,30,14,23,32
      type: NONE
    filler_2:
      material: CYAN_STAINED_GLASS_PANE
      name: '&7'
      slots: 0,1,9,7,8,17,27,36,37,35,44,43
    filler_4_a1:
      material: PURPLE_STAINED_GLASS_PANE
      name: '&5&lItem Slot'
      lore:
        - '&f» &7Click on item with at least &fone'
        - '&7free socket to put it into the GUI.'
        - ''
        - '&f» &7Click on item in GUI to take it back.'
      slots: 11,29
      animation:
        auto-play: true
        start-frame: 0
      animation-frames:
        '1':
          material: MAGENTA_STAINED_GLASS_PANE
          name: '&d&lItem Slot'
          lore:
            - '&f» &7Click on item with at least &fone'
            - '&7free socket to put it into the GUI.'
            - ''
            - '&f» &7Click on item in GUI to take it back.'
    filler_4_a3:
      material: PURPLE_STAINED_GLASS_PANE
      name: '&5&lRune Slot'
      lore:
        - '&f» &7Click on a &frune &7item in inventory'
        - '&7to put it into the GUI.'
        - ''
        - '&f» &7Click on item in GUI to take it back.'
      slots: 13,31
      animation:
        auto-play: true
        start-frame: 0
      animation-frames:
        '2':
          material: MAGENTA_STAINED_GLASS_PANE
          name: '&d&lRune Slot'
          lore:
            - '&f» &7Click on an &frune &7item in inventory'
            - '&7to put it into the GUI.'
            - ''
            - '&f» &7Click on item in GUI to take it back.'
    filler_4_a5:
      material: PURPLE_STAINED_GLASS_PANE
      name: '&5&lResult Preview'
      slots: 15,33
      animation:
        auto-play: true
        start-frame: 0
      animation-frames:
        '3':
          material: MAGENTA_STAINED_GLASS_PANE
          name: '&d&lResult Preview'
    accept:
      material: LIME_STAINED_GLASS_PANE
      skull-hash: ''
      enchanted: false
      name: '&2« &aAccept &2»'
      lore:
        - '&a» &7Price: &a$%cost%'
        - '&a» &7Balance: &a$%balance%'
        - '&a» &7Success Chance: &a%chance%%'
        - '&7'
        - '&7In case of failure your item will be &cdestroyed&7.'
      slots: 26
      type: ACCEPT
    exit:
      material: RED_STAINED_GLASS_PANE
      skull-hash: ''
      enchanted: false
      name: '&4« &cCancel &4»'
      lore: []
      slots: 18
      type: EXIT

---

🔍 Explanation of Settings

Section	Key	Description
socketing	merchant-bonus	Adds extra socketing chance when using the merchant GUI. amount is the added chance; maximal is the cap.
socketing	silent-rate-bonus.enabled	If true, silent bonuses will be factored into success rates.
price	socket-worth-modifier	Multiplier applied to rune socket value when pricing the socketing attempt.
price	item-worth-modifier	Multiplier applied to base item value in socket pricing.
gui	title, size	Sets the GUI title and inventory size (must be a multiple of 9).
gui	item-slot, source-slot, result-slot	Controls which slots are used for the item, rune, and result.
gui.content	filler_*, accept, exit	GUI layout components and animations for visual interaction. Each section defines material, names, slot targets, and special GUI types (like ACCEPT, EXIT).

---

🔗 Back to Hub

← Return to Runes Module