Gems are special items that can be socketed into equipment to provide powerful stat bonuses, passive effects, or skills. They are a core part of item customization in Divinity and allow players to enhance their gear in flexible and scalable ways.

---

• Socket into armor, weapons, and other items using essence slots
• Apply stat boosts, skill effects, or lore-based enhancements
• Define level-based success rates and usage limits
• Compatible with merchant interfaces and socketing GUI
• Support for custom skills using the Fabled plugin
• Support for stat scaling based on gem level

---

All gem functionality is driven by several configuration files. Each file has its own dedicated documentation page:

• gems-items — Define custom gem items and their bonuses
• gems-merchants — Configure merchant GUIs and success modifiers
• gems-settings — Set socketing behavior, success animations, and fail effects
• gems-sockets — Control how gem sockets appear in item lore

---

1. Create gem files in plugins/Divinity/modules/gems/items/
2. Configure merchants and socket behavior as needed
3. Socket gems into gear using in-game mechanics or commands

---

Command	Description
/gems	Opens the main socketing GUI
/gems help	Displays help information for gem commands
/gems get <id> [level] [amount]	Get a gem item with the specified ID
/gems give <player> <id> [level] [amount]	Give a gem item to a player
/gems drop <world> <x> <y> <z> <id> [level] [amount]	Drop a gem item at world coordinates
/gems list [page]	List all available gem item IDs
/gems reload	Reload the gems module and its configurations
/gems merchant [player] [force:true/false]	Open the merchant GUI for a player

---

Permission Node	Grants Access To
divinity.gems	/gems base command
divinity.gems.help	/gems help
divinity.gems.get	/gems get
divinity.gems.give	/gems give
divinity.gems.drop	/gems drop
divinity.gems.list	/gems list
divinity.gems.reload	/gems reload
divinity.gems.merchant	/gems merchant