Configuration

Everything lives in plugins/zResetMap/config.yml. This page covers the keys worth knowing. Run /zrm reload after editing to apply changes without a restart.

Leave config-version alone. The plugin uses it to migrate your file when you update. Editing it by hand breaks the updater.

Top-level settings

language

Message language: en, fr, or es. See Messages & Language.

timezone

Time zone for weekly resets. system uses the server machine’s zone; an IANA id like Europe/Paris pins schedules to that zone.

countdown.broadcast-radius

How far reset warnings reach, in blocks. -1 sends to everyone online.

missed-reset

What to do if a reset was missed while the server was down: immediate, skip, or delay.

missed-reset-delay-minutes

For delay mode, how long after startup to wait.

Worlds

Each entry under worlds: is one world zResetMap manages. The key (nether, end, …) is just a label. It does not have to match the world name. Copy a block to add another world.

worlds:
  nether:
    enabled: true
    world-name: "world_nether"
    reset-interval-days: 3
    reset-schedule:
      mode: interval        # interval or weekly
      weekly:
        day: FRIDAY
        time: "21:00"

enabled

Set false to pause resets for this world without deleting its config.

world-name

The exact world folder name on disk. Default server: world, world_nether, world_the_end.

reset-interval-days

Days between resets when mode is interval.

reset-schedule.mode

interval (rolling) or weekly (fixed day and time).

reset-schedule.weekly

The day (MONDAY..SUNDAY) and HH:mm time for weekly mode.

Fallback location

Where players go before a reset. This must be a loaded world that is not being reset.

    fallback-world: "world"
    fallback-location:
      x: 0.5
      y: 64.0
      z: 0.5
      yaw: 0.0
      pitch: 0.0

Spawn region

The build that survives resets. Full detail on Spawn Protection.

    spawn-region:
      enabled: true
      save-path: "plugins/zResetMap/spawn_schematics/nether.schem"
      corner1: { x: -25, y: 60, z: -25 }
      corner2: { x: 25, y: 90, z: 25 }
      paste-at-corner1: true
      paste-offset: { x: -25, y: 60, z: -25 }

Set the corners in-game with /zrm setspawncorner1 and /zrm setspawncorner2 rather than by hand.

Spawn point

A named point players can teleport to. See Teleport & Random Teleport.

    spawn-point:
      set: false
      x: 0.5
      y: 64.0
      z: 0.5
      yaw: 0.0
      pitch: 0.0
      auto-teleport-on-entry: false

set flips to true the first time you run /zrm setspawn.

Random teleport

    random-teleport:
      enabled: true
      min-radius: 100
      max-radius: 2000
      center-x: 0
      center-z: 0
      cooldown-seconds: 30
      max-attempts: 25

Each key is explained on the Teleport page.

Post-reset commands

Console commands that run automatically after this world resets. Handy for kicking off chunk pre-generation with another plugin.

    post-reset:
      delay-seconds: 5
      commands:
        - "chunky world {worldname}"
        - "chunky radius 500"
        - "chunky start"

{worldname} is the world folder name, {world} is the config key. delay-seconds waits after the reset before running them.

Lock after reset

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

See World Lock.

Countdown warnings

Minute marks to broadcast a warning before this world resets. Descending order.

    countdown-warnings:
      - 60
      - 30
      - 10
      - 5
      - 1

Managed blocks

next-reset at the bottom holds the next reset timestamp per world. The plugin writes these itself. Do not edit them, they get overwritten.