1 Global Configuration

Global Configuration

Main file: plugins/Divinity/config.yml

What this page is for

This page covers server-wide defaults: storage, tiers, item classification, language, aliases, and the global module switch. It does not replace the module-specific settings.yml files.

Configuration files

• config.yml — global settings and module overrides.
• lang/messages_en.yml and other language files — player-facing messages.
• modules/<module>/settings.yml — behavior belonging only to one module.

Settings worth changing first

Section	What it controls
divinity	Language, command aliases, and the display prefix.
data	Auto-save interval and SQLite/MySQL storage settings.
tiers	Tier IDs, colors, and displayed names.
modules	Global module enable/disable overrides.
item-sub-types	Custom item types mapped to Minecraft materials.
item-groups	Broad groups such as WEAPON, TOOL, and ARMOR.

Storage

SQLite is the default and requires no database service. Use the storage fields under data.storage when connecting to MySQL. Keep data.auto-save enabled so player data is written regularly.

Tiers and item classification

Tier IDs are referenced by items and modules, so changing an ID can invalidate existing configuration. Add new tiers instead of renaming an ID that is already in use.

Item sub-types are specific classifications such as sword, helmet, or bow. Item groups are broader material collections used when an item should apply to a family of materials.

Module switches

Module-specific settings live under modules/<module>/settings.yml. Use config.yml for the global decision to load a module and the module file for its behavior.