Core Configuration

Database (`database`)

Key	Default	Description
`file`	`ascension.db`	SQLite filename
`pool-size`	`4`	Connection pool
`wal`	`true`	WAL mode
`backup-before-migrate`	`true`	Backup before schema upgrade
`backup-retention`	`10`	Kept backup copies

Ranks (`ranks.*`)

Per rank (E → MONARCH):

display-name, color, chat-prefix
required-xp, max-mana, shadow-capacity
mana-regen-multiplier

Mana (`mana`)

Key	Default	Description
`regen-per-tick`	`0.5`	Mana per pulse
`regen-interval-ticks`	`20`	Pulse interval

Hunter abilities (`hunter-abilities`)

Invisibility and flight limits per rank tier. Permissions: ascension.ability.invisibility.*, ascension.ability.flight.* — see Core permissions.

Skills (`skills`)

Skill tree defaults, /skillshop entries (skills.shop.entries), points per rank-up. Used by AscensionSkills.

Achievements (`achievements`)

Achievement definitions for /achievements GUI. Progress stored in SQLite.

Economy (`economy`)

Shop items (economy.shops), gate entry fees (gate-entry-fees), sell prices, craft recipes, shadow-capacity upgrades. Used by AscensionEconomy even though keys live in Core config.

Staff (`staff`)

Section	Description
`staff.roles`	Helper/Mod/Owner labels + `ascension.staff.*` permissions
`staff.chat.rank-prefixes`	Per-rank chat tags
`staff-mode`	Staff visibility options

Permissions (`permissions`)

Key	Description
`provider`	`auto`, `luckperms`, `yaml`, `bukkit`
`mappings`	Permission aliases
`yaml-fallback.groups`	Default groups when no LuckPerms

Action bar (`action-bar`)

Key	Default	Description
`enabled`	`true`	Master switch
`show-stats`	`false`	Rank/mana/XP on action bar
`format`	…	`{rank}`, `{mana}`, `{xp_pct}`, etc.

Built-in scoreboard when enabled: true. Default enabled: false — use SimpleScore.

Resource pack (`resource-pack`)

Key	Description
`enabled`	Build pack on enable
`merge-modelengine-pack`	Include ModelEngine assets (required for shadow models)
`public-host` / `host-port`	Pack download URL
`apply-on-join`	Send pack on join
`redownload-command-enabled`	Allow `/resourcepack`

Chat (`chat`)

channels.enabled — /ch system
channels.prefixes — ! guild, @ party, # staff
use-renderer — Paper display name + rank colors (Essentials integration)

Guide books

Key	Description
`guide-book`	Player handbook (`/asc guide`)
`admin-guide-book`	Staff handbook (`/asc admin guide`)

Leave pages: [] to use built-in JAR content.

Messages (`messages`)

Key	Description
`rank-up`	Template with `{rank_colored}`
`not-enough-mana`	Skill mana error