gems sockets - magemonkeystudio/divinity GitHub Wiki

🧩 gems-sockets

This page explains how to customize how socket placeholders appear on items, including formatting for empty and filled sockets. Each socket type (GEM, RUNE, ESSENCE) has customizable categories and visual formats.

📁 File Location

Socket display formatting is controlled via:

plugins/Divinity/item_stats/sockets.yml

🧾 Example Configuration

GEM:
  categories:
    common:
      tier: common
      name: '%TIER_NAME% Slot]'
      format:
        main: '%value%'
        value:
          empty: ' %TIER_COLOR%%name%'
          filled: ' %TIER_COLOR%%value%'
    uncommon:
      tier: uncommon
      name: '%TIER_NAME% Slot]'
      format:
        main: '%value%'
        value:
          empty: ' %TIER_COLOR%%name%'
          filled: ' %TIER_COLOR%%value%'
    rare:
      tier: rare
      name: '%TIER_NAME% Slot]'
      format:
        main: '%value%'
        value:
          empty: ' %TIER_COLOR%%name%'
          filled: ' %TIER_COLOR%%value%'
    veryrare:
      tier: veryrare
      name: '%TIER_NAME% Slot]'
      format:
        main: '%value%'
        value:
          empty: ' %TIER_COLOR%%name%'
          filled: ' %TIER_COLOR%%value%'
    legendary:
      tier: legendary
      name: '%TIER_NAME% Slot]'
      format:
        main: '%value%'
        value:
          empty: ' %TIER_COLOR%%name%'
          filled: ' %TIER_COLOR%%value%'

RUNE:
  categories:
    default:
      tier: common
      name: '%TIER_COLOR%Rune Socket'
      format:
        main: '%value%'
        value:
          empty: '%TIER_COLOR%▢ <%name%>'
          filled: '%TIER_COLOR%▣ &7%value%'

ESSENCE:
  categories:
    default:
      tier: common
      name: '%TIER_COLOR%Essence Socket'
      format:
        main: '%value%'
        value:
          empty: '%TIER_COLOR%▢ <%name%>'
          filled: '%TIER_COLOR%▣ &7%value%'

🔍 Key Concepts

Section Description
GEM, RUNE, ESSENCE Main socket types, each with their own category list
categories Defines the visual format per socket tier or type
tier Matches the item's internal tier
name Displayed name of the socket slot
format.main Format string for socket line on the item lore
format.value.empty How an empty socket is shown (usually just the slot placeholder)
format.value.filled How a filled socket looks, often showing the inserted gem’s value

Let me know when you’re ready to link this into the main gems hub or proceed with another section.

⚠️ **GitHub.com Fallback** ⚠️