Configuration Overview

Reverie uses a modular configuration system based on HOCON (Human-Optimized Config Object Notation). Each feature area has its own config file, and all files live under config/reverie/.

Config Files

File	Purpose
`config.conf`	Global settings (debug mode)
`contest.conf`	Contest module: positioning, audience, cinematic, effects, rewards
`tournament.conf`	Tournament formats, brackets, registration
`cosmetics.conf`	Pokemon pose and cosmetic settings
`display.conf`	UI and HUD display settings
`seasons.conf`	Seasonal leaderboard system
`achievements.conf`	Achievement definitions and triggers

Hall Configs

Each contest hall has its own directory under config/reverie/halls/:

config/reverie/halls/
  my_arena/
    hall.conf
  grand_stage/
    hall.conf

Contest Type Configs

Custom contest types are defined as HOCON files under config/reverie/contesttypes/:

config/reverie/contesttypes/
  cool.conf
  beauty.conf
  custom_challenge.conf

HOCON Format

HOCON is a superset of JSON that supports comments, unquoted keys, and cleaner syntax:

# Comments with hash
key = "string value"
number = 42
decimal = 3.14
flag = true
list = ["a", "b", "c"]

nested {
  inner-key = "value"
  another = 10
}

Reloading

Reload all configs without restarting:

/reverie reload

Reload specific areas:

/hallbuilder reload    # Reload hall configs
/contesttype reload    # Reload contest types

Global Config

File: config/reverie/config.conf

Field	Type	Default	Description
`debug`	Boolean	`false`	Enable verbose debug logging. Useful for troubleshooting but generates significant log volume.

debug = false

Data Storage

All persisted data lives under config/reverie/:

Directory	Contents	Description
`contest_results/`	`{contestId}.json`	Results from completed contests
`player_stats/`	`{playerId}.json`	Per-player contest statistics
`player_states/`	`{playerId}.json`	Temporary player state for crash recovery
`seasons/`	Season data	Active season, history, per-season player stats
`halls/`	Hall configs	Contest venue configurations
`contesttypes/`	Type configs	Contest type definitions
`music/`	`.nbs` files	NBS music files

To back up all Reverie data, copy the entire config/reverie/ directory. Pokemon contest data (stats, seals, ribbons) is backed up as part of your normal world/Cobblemon backup.

Next Steps

Hall Config — Set up contest venues
Contest Types — Define custom contest rulesets
Contest Config — Global contest settings