Configuration

Configuration

Reverie uses a server-authoritative NeoForge server config stored per world in serverconfig/reverie-server.toml. Stop the server before editing and restart it afterward. Operators can view active values with /reverie config show and validate registry identifiers with /reverie doctor.

[bed_access]

Key	Default	Allowed	Meaning
maxDreamersPerBed	2	1–100	Maximum simultaneous players linked through one Overworld bed.
ownerAbsenceGraceSeconds	60	0–60	Time guests may remain after the bed owner leaves the Reverie. 0 wakes them immediately.

Bed owners enter their own bed freely. Guests can only join after the owner has entered. If the owner leaves, guests are awakened when the grace period expires unless the owner returns through the same bed first.

[dream_time]

Key	Default	Allowed	Meaning
startingMinutes	90	0–10080	Dream Time granted when a player first uses Reverie.
minutesPerAmethystShard	30	1–10080	Dream Time added by one Amethyst Shard. Starbound doubles it.
maximumStoredMinutes	360	1–10080	Normal Dream Time storage limit.
lowTimeWarningMinutes	15	0–10080	Remaining time that triggers the warning.
maximumOvertimeMinutes	60	0–10080	Drowsiness limit before automatic awakening.
phantomMembraneReductionMinutes	30	1–10080	Drowsiness removed by one Phantom Membrane. Starbound doubles it.
starboundMaximumStoredMinutes	1440	1–10080	Dream Time storage limit for Starbound players.
starboundMaximumOvertimeMinutes	120	0–10080	Drowsiness limit for Starbound players.
display	always	always, warning, hidden	When the Dream Time status bar is shown.

[do_not_disturb]

Key	Default	Allowed	Meaning
abandonAfterSeconds	60	0–3600	Time outside a Do Not Disturb zone before it turns off. 0 disables abandonment.

[reverie_time]

Key	Default	Allowed	Meaning
playerClockControl	true	Boolean	Allow players to change Reverie time by using a Clock.
clockStepTicks	1000	1–24000	Legacy compatibility value. Current Clock use cycles named presets.
clockCooldownTicks	40	1–1200	Cooldown between Clock uses. Twenty ticks are approximately one second.
globalClockCooldownTicks	40	1–1200	Legacy compatibility value. Clock previews are personal.
returnToNoonMinutes	5	0–1440	Minutes before player-selected lighting returns to noon. Set to 0 to disable the timer.

Use a Clock to cycle through the named lighting presets. Sneak-use it to return to the normal Reverie time. The preview is personal and the cooldown prevents rapid changes. Player-selected lighting returns to normal after the configured timeout or when the player leaves.

Noon retains Reverie's original bright white appearance. Darker settings temporarily expose normal block and sky lighting for lighting and spawner tests.

[dream_inventory]

Key	Default	Allowed	Meaning
anchorScopedInventories	true	Boolean	Save a distinct Creative inventory for each player and permanent Dream Anchor.
defaultStartingItems	minecraft:recovery_compass	Comma-separated item IDs with optional *count	Items given when no Dream Inventory or Dream Imprint is available.

Only anchored, authorized project locations persist dream inventories.

[figment_cage]

Key	Default	Allowed	Meaning
maximumCharges	4	0–4	Highest cage charge/radius. Four permits a 9×9-chunk region.
maximumMobs	16	1–128	Maximum mobs sustained by one cage.
chargeItem	minecraft:echo_shard	Registered item ID	Item used to add one charge.

Charge-to-region mapping is 0→1×1, 1→3×3, 2→5×5, 3→7×7, and 4→9×9 chunks.

[illegal_content_purge]

Key	Default	Allowed	Meaning
automaticEnabled	false	Boolean	Run recurring loaded-chunk audits. Immediate placement/item enforcement remains active when false.
batchIntervalTicks	5	1–1200	Delay between incremental audit batches. Twenty ticks are approximately one second.
blocksPerBatch	4096	64–65536	Maximum block positions inspected per batch. Higher values finish sooner but increase tick load.
automaticIntervalMinutes	30	1–10080	Time between recurring audits when automatic auditing is enabled.

Adding a block/item override always starts one incremental pass, even when recurring auditing is disabled.

[safety_and_feedback]

Key	Default	Allowed	Meaning
voidRecoveryMode	awaken	awaken, bed, or disabled	Choose whether the void awakens a player, returns them to their Reverie bed, or receives no special handling.
occupancyNotifications	true	Boolean	Notify bed owners when guests enter or leave their shared dream.
auditLog	true	Boolean	Record important transitions, recovery actions, and administrative bed changes in the server log.
reducedParticles	false	Boolean	Reduce recurring guidance effects while retaining important feedback.
automaticSafetyChecks	true	Boolean	Periodically check active recovery snapshots and warn players when their waking bed becomes unsafe.

Invalid values

Numeric values outside their declared range are rejected by NeoForge's config system. Unknown item/effect identifiers are reported at startup and by /reverie doctor; the affected optional mechanic is disabled safely instead of crashing world creation.