World Lock

A freshly regenerated world has no pre-generated chunks. If players pour in right away, they generate terrain as they go, which is laggy and can drop them into half-loaded areas. World lock keeps them out until you are ready.

What a lock does

While a world is locked:

  • Players cannot teleport or portal into it. Entry is blocked with a message.

  • Anyone already inside is evacuated when the lock is applied.

  • Players with zresetmap.lock.bypass can still get in.

The lock clears itself after a set duration, or you can lift it by hand.

Lock after a reset

Set this up per world under lock-after-reset:

lock-after-reset:
  enabled: true
  duration: "30m"

When a reset finishes, the world locks for duration. Pair it with post-reset commands that run a chunk pre-generator, and the world opens back up once generation has had time to run.

Duration accepts s, m, h, d and combinations: 90s, 30m, 1h, 2h30m. A plain number is read as minutes.

Manual lock and unlock

Lock or unlock any loaded world on demand:

/zrm lock nether 1h
/zrm lock nether
/zrm unlock nether

/zrm lock with no duration locks until you unlock it. Both commands need zresetmap.admin.

Edge case

A player who logs out inside a world that later gets locked is not kicked on their next login. They were evacuated when the lock was applied, so this only matters if they were offline the whole time. Rare, but worth knowing.