Configuration

Configuration

The config is a NeoForge COMMON config:

config/betterspawn-common.toml

In a development run this is run/config/betterspawn-common.toml.

Restart the game/server after changing values.

[general]

Key	Default	Meaning
respawnPolicy	COMMAND_OVER_BED	COMMAND_OVER_BED: command slot > bed/anchor. BED_OVER_COMMAND: bed/anchor > command.
noPersonalSpawnBehavior	BACK_TO_OVERWORLD	If the death dimension has no global spawn either: go to the Overworld, or stay in the death dimension / leave it to vanilla.
syncVanillaNbt	true	When /betterspawn spawnpoint set runs, also write the vanilla respawn NBT for compatibility.

[search]

Key	Default	Meaning
fallbackMaxDepth	3	Maximum fallback-chain depth.
searchTimeoutTicks	200	Soft deadline for one resolution.
maxChunkLoads	64	Default chunk-generation budget per resolution.

Each method/template can also override max_chunk_loads.

[debug]

Key	Default	Meaning
enableGotoDim	true	Enables /gotodim and /betterspawn gotodim.
enableDiagnosticLogs	false	Emits detailed [diag] logs for the respawn chain, personal spawns, gotodim, verify, slot recording, and create-screen injection.

[experimental]

Key	Default	Meaning
enableSpawnDimensionSelector	true	Shows the spawn-dimension button in the singleplayer/LAN create-world screen.

Respawn priority

With COMMAND_OVER_BED:

command slot
> bed / anchor slot
> player world spawn for the death dimension
> world spawn for the death dimension
> (fallback) Overworld world spawn if configured

With BED_OVER_COMMAND, the first two swap. Bed/anchor and command slots are global to the player and may point to a different dimension than the death dimension. Each slot is validated on respawn; an invalid slot falls through to the next layer.

Vanilla compatibility

• Vanilla /setworldspawn changes the Overworld level.dat spawn. The mod treats level.dat as authoritative for the Overworld and syncs its stored data on startup.
• Vanilla /spawnpoint and bed/anchor interactions are mirrored into the mod's player slots through PlayerSetSpawnEvent.
• The Overworld global spawn is written through ServerLevel#setDefaultSpawnPos, which updates level.dat, notifies clients, and maintains spawn-chunk tickets.