💎 Gemic Magic Dust

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

---

📁 File Location

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

---

🧪 Example: gemic_dust.yml

material: GLOWSTONE_DUST
name: 'Gemic 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:
    - gems
  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: Number of uses consumed at a given level.
• rate-increasing:
  • max-value: The highest possible success bonus this dust can give.
  • values-by-level: Maps item level to success bonus amount.
• target-requirements:
  • module: Restricts usage to gems socketing.
  • type: Target item categories.
  • level: Level ranges or thresholds per dust level.

---

⬅ Return to Magic Dust Hub