12. Configuration Files

All config files live under config/rpessentials/ and are generated automatically on first launch, fully commented. Every value can be reloaded at runtime with /rpessentials config reload, no restart needed, except a few structural values you would rarely touch.

File	Contents	Wiki page
rpessentials-core.toml	Obfuscation, staff permissions, world border and zones, Death RP, roles	Identity System, Moderation System, Death RP, World Border & Zones, Staff Tools
rpessentials-chat.toml	Chat formatting, markdown, timestamps, join/leave messages	Chat System
rpessentials-schedule.toml	Per day schedule, Death Hours, HRP Hours, welcome message, auto unwhitelist	Server Schedule, Moderation System
rpessentials-moderation.toml	Silent commands, platforms, last connection, warn system, mute system, staff notes	Moderation System, Staff Tools
rpessentials-professions.toml	Profession definitions and every restriction list	Profession & License System
rpessentials-messages.toml	Every player facing message string in the mod	see below
rpessentials-rp.toml	AFK zone, RP command cooldowns, dice types, self nick, immersive presets	Staff Tools, Identity System, Dice Roller

You can also edit any of these in game, see Config Manager GUI.

Messages file

rpessentials-messages.toml exposes every user facing string as a separate config value, organized into sections: [System], [Private Messaging], [Warn System], [Last Connection], [Death RP], [Whois], [Player List], [RP Commands], [Roles], [Schedule Display], [Licenses], [Mute System], [Staff Notes], [Stats], [Dice], and more.

Every value supports § and & color codes, and reloads live like any other config. This is the file to edit for a full translation of the mod.

Data storage

All persistent data lives in the world save, under world/data/rpessentials/, as human readable JSON. Keys generally use the UUID (McUsername) format for readability, and are safely re parsed even if the username changes later.

File	Contents
nicknames.json	Player nicknames
licenses.json	Player licenses
license-audit.json	License audit log (GIVE/REVOKE/GIVE_RP/REISSUE/EXPIRE_RP)
licenses-temp.json	Temporary RP license registry
warns.json	Player warns
mutes.json	Active mutes
notes/	One JSON file per player with staff notes
lastconnection.json	Connection history and cumulative playtime
deathrp.json	Individual Death RP overrides
deathrp-history.json	Death RP history
autounwhitelist-history.json	Auto unwhitelist removal log

All saves are asynchronous through a single dedicated IO thread, all loads are synchronous at server startup. No file is ever written on the main server thread.