Skip to content

World Configuration

Representing the [world] section in server.toml.

Dimension

Default spawn dimension for new players.

toml
[world]
dimension = "overworld"

Possible values:

overworld
nether
end

Spawn Position

Customize where players spawn using [x, y, z] coordinates. Supports floating point numbers.

toml
[world]
spawn_position = [0.5, 320.0, 0.5]

World Boundaries

Control player movement by setting a minimum Y coordinate. When players fall below this level, they'll be teleported back to spawn and receive a configurable message.

Minimum Y Position

Set the lowest Y coordinate players can reach before being teleported back to spawn. Defaults to -64 (Minecraft's default world bottom).

toml
[world.boundaries]
enabled = true
min_y_pos = -64

Minimum Y Message

Customize the message players receive when they fall below the minimum Y position and are teleported back to spawn. Supports MiniMessage formatting for colors and styling.

toml
[world.boundaries]
teleport_message = "<red>You have reached the bottom of the world.</red>"

The message can be disabled by setting an empty string:

toml
[world.boundaries]
teleport_message = ""

Time

Sets the time in the world.

toml
[world]
time = "midnight"

Possible values:

day
noon
night
midnight
a specific time in ticks (0-24000)

Lock Time 1.21.5+

Set to false to prevent the client from ticking the time.

toml
[world.experimental]
lock_time = false

Released under the MIT License.