World Management

World Management

Server-side administration: world storage, access control, and maintenance tools. See Configuration for the matching server.yml keys and Commands for the command syntax.

World storage

• Disk mode (world_storage: disk) persists to Anvil region files, one folder per dimension:

  world/          ← Overworld
  world_nether/
  world_end/
  

• Memory mode (world_storage: memory) keeps everything in RAM — ephemeral, ideal for testing.
• Autosave runs every 30 seconds and on clean shutdown, using atomic writes. Control it at runtime with /save-all, /save-on, /save-off.
• The legacy world/DIM-1 and world/DIM1 layout is migrated automatically on first startup.
• Changing world_seed only affects newly generated chunks — use a fresh world_dir when changing seeds to avoid terrain seams.
• Chunk caching is bounded by max_cached_chunks; streaming radius by view_distance, with background warm-up up to pregenerate_radius.

Access control

Whitelist

Shared across Java and Bedrock. Toggle and edit in-game; runtime changes persist to whitelist.json:

/whitelist on | off
/whitelist add <player>
/whitelist remove <player>
/whitelist list

Configure the default state in server.yml under whitelist.

Operators

Operators bypass all permission checks. Set them in server.yml (operators) or at runtime:

/op <player>
/deop <player>

Bans

Player and IP bans, persisted server-side:

/ban <player> [reason]
/ban-ip <address> [reason]
/pardon <player>
/pardon-ip <address>
/banlist

Maintenance & performance tools

ClearLag

Periodically removes old entities to keep tick times healthy. Fully configurable in server.yml (clear_lag): interval, minimum entity age, per-category toggles (dropped items, XP orbs, projectiles, primed TNT, falling blocks, boats, passive/hostile mobs), and countdown warning messages with {seconds}/{count} placeholders.

Idle timeout

Automatically disconnects inactive players to free slots and resources.

Performance monitoring

• /tps — current ticks per second
• /mspt — milliseconds per tick
• timings — tick-time profiling

Enable fine-grained debug.* categories in server.yml when diagnosing startup, world-loading, spawning, autosave, or Bedrock issues — and disable them in production.

Time, weather & difficulty

/time set <value> | /time add <value>
/weather clear | rain | thunder
/difficulty peaceful | easy | normal | hard

Resource packs

• Java: push a pack during the configuration phase (resource_pack.java), or let the Custom Items system auto-generate and serve one.
• Bedrock: push .mcpack / .zip / .mcaddon files (resource_pack.bedrock.paths); .mcaddon archives are auto-extracted into their sub-packs. See Bedrock and Cross-Play.

World editing commands

/setblock, /fill, /clone, /setspawn / /setworldspawn, /spawnpoint, /locate, and /seed — see Commands.