0 Overview

Overview

What this page is for

Use this page to understand how Divinity's configuration files fit together before changing a specific system.

What Divinity provides

Divinity is the shared RPG layer used to create custom equipment and combat systems on a Minecraft server. Its main building blocks are:

• Tiers — rarity/name colors such as Common, Rare, Superior, Fabled, Eternal, and Mythic.
• Item types and groups — classify vanilla materials as swords, armor, weapons, tools, and similar categories.
• Item stats — add damage, defense, utility, requirements, durability, sockets, and other attributes to items.
• Modules — optional systems such as refining, runes, loot, and parties.
• Profiles — let a player keep separate character-like configurations and class progress.

Important files

File or folder	Purpose
config.yml	Main plugin settings, tiers, item sub-types/groups, and enabled modules.
engine.yml	Low-level engine, combat, compatibility, performance, and lore settings.
worth.yml	Base values used by the worth system.
item_stats/	Definitions for general, damage, defense, hand, ammo, and socket stats.
profiles/	Player profile limits, settings, and GUI layouts.
modules/	Settings and content for each optional module.
lang/	Player-facing messages.

Recommended setup order

1. Set the language, storage, tiers, and module switches in config.yml.
2. Review compatibility and combat behavior in engine.yml.
3. Define only the item stats your server actually uses.
4. Enable modules one at a time and test their commands and items.
5. Add custom items and loot after the base rules are stable.