Skip to content

The world and players

xLimbo creates its own world on startup, named xlimbo by default. It’s a void with one shared floor layer, unbreakable, and nothing else: no terrain, caves, structures or mobs. Every chunk costs the same, however far players go.

world:
name: "xlimbo"
floor-block: "purple_stained_glass"
floor-y: 64
auto-save: false
reset-on-startup: false
border:
size: 10000
spawn-radius: 64
view-distance: 4
simulation-distance: 4
  • name is the world’s folder name: letters, digits, _, - and .. xLimbo marks every world it makes, and only ever deletes or rebuilds a marked one. If a folder by that name exists but isn’t loaded and xLimbo didn’t make it, xLimbo refuses to touch it and says so in the console: pick another name. A world by that name that’s already loaded, such as the server’s main world, becomes the limbo as it is: xLimbo configures it but never deletes or rebuilds it.
  • floor-block is a solid block that doesn’t fall, as Minecraft names it, such as purple_stained_glass (the default, easy to see against the void) or glass.
  • auto-save: false keeps the world off disk: it’s deleted and made fresh on every startup, which is what you want for a fallback. Set it to true only if builds there should survive a restart. A saved world is still made fresh if its floor changes, so it never has two floors.
  • reset-on-startup: true makes a saved world fresh on startup too.
  • border.size is the width of the square world border, in blocks. It caps how much world can ever be generated.
  • border.spawn-radius spreads arriving players up to this many blocks from the centre. xLimbo keeps the land in this area loaded, up to about 130 blocks from the centre, so arrivals never wait for it to generate; the console says when it’s ready. Keep it small: 64 blocks is about 120 chunks however many players land, where xLimbo 1.x’s 4000 meant fresh land for nearly every player. Beyond about 130 blocks, arrivals further out wait for their land like anywhere else.
  • view-distance and simulation-distance apply to this world, from 2 to 32. -1 keeps the server’s default.

The world stays clear and quiet: no weather, and no advancement messages.

Changing floor-block or floor-y and running /xlimbo reload rebuilds the world: players in it are moved out for a moment, the world is made fresh, and they’re put back. Changing name switches to the world with the new name, made if it doesn’t exist yet: players move there, and the old world is unloaded if xLimbo made it. Everything else applies in place.

To make the server’s default world the limbo (a single-world server), set world.name to it (usually world, as in level-name in server.properties) and give it xLimbo’s generator in bukkit.yml:

worlds:
world:
generator: xLimbo

floor-y and floor-block still apply when the world is first made. They can’t change on reload, because the server’s main world can’t be rebuilt while the server runs: restart instead. reset-on-startup doesn’t apply, because the server loads its main world before xLimbo can delete it.

Joining players are placed at a random spot inside spawn-radius before they’re in the world, on land that’s already loaded, so there’s no teleport after they join and no waiting for chunks.

player:
set-creative: true
enable-flight: true
hide-others: true
join:
suppress-join-message: true
custom-join-message: "<prefix>The server is unavailable right now, so you're waiting here. Type <highlight>/join</highlight> to go back."
clear-chat-on-join: false
quit:
suppress-quit-message: true
death:
suppress-death-message: true
action-bar:
enabled: true
interval-ticks: 40
message: "<white>Type <highlight><bold>/join</bold></highlight> to go back to the server"
  • Players are put in creative with flight, which stays on so nobody falls.
  • With hide-others, players can’t see each other, in the world or the tab list. Hundreds of players arriving in one spot, each tracking every other one, is the biggest load a limbo has; hidden, it’s gone. Turn it off if players should see each other while they wait.
  • The usual join, quit and death broadcasts are hidden, so a crash doesn’t flood chat.
  • The action bar repeats a hint every interval-ticks (20 ticks is one second). While a player waits in the return queue, it shows their place in line instead.