✨ Essence Magic Dust

This is an example configuration for a Magic Dust item designed to boost success rates when socketing essences.

---

📁 File Location

plugins/Divinity/modules/magic_dust/items/essence_dust.yml

---

🧪 Example: essence_dust.yml

material: GLOWSTONE_DUST
name: 'Essence Magic Dust'
lore: []
tier: common
enchanted: true
item-flags:
  - '*'
level:
  min: 1
  max: 5
uses-by-level:
  '1': 1
  '3': 2
rate-increasing:
  max-value: 80
  values-by-level:
    '1': 1
    '2': 2
    '3': 3
    '4': 4
    '5': 5
target-requirements:
  type:
    - '*'
  module:
    - essences
  level:
    '1': '1:3'
    '3': '3'

---

🔑 Key Sections

• material: The Minecraft item used to represent the dust (e.g. GLOWSTONE_DUST).
• name: Display name shown in-game.
• tier: Used for categorization and styling.
• enchanted: Whether the item has an enchantment glint.
• uses-by-level: Controls how many uses are consumed per item level.
• rate-increasing:
  • max-value: Maximum bonus the dust can contribute to success rate.
  • values-by-level: Success bonus per level of the dust.
• target-requirements:
  • module: Restricts dust usage to specific socketing types (e.g. essences).
  • type: Item categories this dust can affect.
  • level: Controls eligible item levels per dust level.

---

⬅ Return to Magic Dust Hub