World Reset

World Reset

Reset the server world without closing the server, using command, timer or custom predicate.
The timer can be stopped using /worldreset stop or a stop predicate.

Make world spawn be set near a specific biome or structure, fine-tune player state resets, and change world pool size.

Integrates with Fabric Permissions API (used by LuckPerms, PlayerRoles), and Predicate API for custom predicates.

Commands and permissions

| Command | Permission | Description |
|—|—|————————————————————————–|
| /worldreset reset [seed] | worldreset.reset | Immediately resets the world (optional seed, “random” supported) |
| /worldreset reload | worldreset.reload | Reloads configuration |
| /worldreset timer | worldreset.timer | Sets the reset timer (e.g. “5m”, “300s”) |
| /worldreset stop | worldreset.stop | Stops the timer |
| /worldreset seed | worldreset.seed | Sets the seed (supports “random”) |
| /worldreset spawn none | worldreset.spawn | Disables spawn near |
| /worldreset spawn structure | worldreset.spawn | Spawns near a structure (e.g. “minecraft:stronghold”) |
| /worldreset spawn biome | worldreset.spawn | Spawns near a biome (e.g. “minecraft:plains”) |
| /worldreset spawn offset | worldreset.spawn | Block offset from the target location |
| /worldreset spawn require_surface | worldreset.spawn | Requires a surface block for spawning |
| /worldreset triggers list [stop\|reset] | worldreset.triggers | Lists triggers (default: both) |
| /worldreset triggers clear [stop\|reset] | worldreset.triggers | Clears triggers (default: both) |
| /worldreset triggers remove | worldreset.triggers | Removes a trigger by index |
| /worldreset triggers add portal [origin_dimension] [require_all_players] | worldreset.triggers | Adds a portal enter trigger (origin_dimension: e.g. minecraft:overworld) |
| /worldreset triggers add death | worldreset.triggers | Adds an entity death trigger |
| /worldreset triggers add advancement [require_all_players] | worldreset.triggers | Adds an advancement trigger |
| /reset [seed] | worldreset.reset | Alias for /worldreset reset |

/wr is an alias for /worldreset. All permissions default to operator level 2.

Durations support seconds (15/15s), minutes (3m), hours (2h), days (7d), and combinations (1h30m).

Configuration

{
  // Don't touch!
  "config_version": 8,
  // Number of worlds kept preloaded for instant resets, if 0 players need to be teleported to worldreset:lobby
  "pool_size": 1,
  // Chunk radius to preload per world (number, or percentage of view distance e.g. "50%")
  "preload_distance": "4",
  // Spoofs custom worldreset:dimension id to show vanilla minecraft:dimension id
  // This is useful for compatibility with shaders which rely on vanilla dimensions ids
  // If enabled players are teleported to worldreset:lobby to avoid chunks bleeding into eachother
  // If disabled players are immediately teleported to next pooled world which is slightly faster
  "spoof_dimension": true,
  // Enable timer countdown sounds
  "countdown_sounds": true,
  // Enable restart chat message
  "restart_message": true,
  // Triggers that stop the countdown timer early
  "stop_triggers": [
    {
      "type": "worldreset:portal_enter",
      "block": "minecraft:end_portal",
      "origin_dimension": "minecraft:the_end",
      "require_all_players": false
    },
    {
      "type": "worldreset:advancement",
      "advancement": "minecraft:nether/uneasy_alliance",
      "require_all_players": false
    }
  ],
  // Triggers that immediately reset the world
  "reset_triggers": [
    {
      "type": "worldreset:entity_death",
      "entity": "minecraft:player",
      "filter": {
        "type": "entity",
        "value": {
          "type_specific": {
            "type": "player",
            "gamemode": ["survival"]
          }
        }
      }
    }
  ],
  // Supports long, string, or "random" seed
  "seed": "random",
  // Configure spawn location
  "spawn_near": {
    // Type of spawn: "none", "structure", or "biome"
    "type": "none",
    // Target structure or biome (e.g. "minecraft:stronghold", "minecraft:plains")
    "target": "",
    // Block offset from the target location
    "offset": 0,
    // Whether to require a surface block for spawning
    "require_surface": false
  },
  // Reset player state on world reset
  "reset_on_load": {
    // Remove all potion effects
    "effects": false,
    // Reset health, air supply, fire, and velocity
    "health": false,
    // Reset food level and saturation
    "hunger": false,
    // Reset all game statistics
    "statistics": false,
    // Reset all advancements
    "advancements": false,
    // Reset XP levels, points, and score
    "experience": false,
    // Clear inventory and ender chest contents
    "inventory": false,
    // Reset recipe knowledge
    "recipes": false,
    // Reset player attributes (health boost, speed, etc.)
    "attributes": false,
    // Gamemode applied to each player after reset (overrides hardcore spectator lock); "none" to skip
    "gamemode": "survival",
    // Set time of day in game ticks (0-24000, -1 to disable)
    "time_of_day": -1,
    // Reset weather to clear
    "clear_weather": false
  }
}

Trigger types (used in both stop_triggers and reset_triggers):

• worldreset:portal_enter – triggers when a player enters a portal block
• block: the portal block identifier (e.g. minecraft:end_portal)
• origin_dimension: optional, the dimension the player must be in (e.g. minecraft:overworld for stronghold portal, minecraft:the_end for exit portal)
• require_all_players: if true, all players must enter; if false, any player (default: false)
• filter: optional Predicate API predicate for player-level matching
• worldreset:entity_death – triggers when an entity dies
• entity: the entity type identifier (e.g. minecraft:ender_dragon)
• filter: optional Predicate API predicate for entity-level matching
• worldreset:advancement – triggers when a player earns an advancement
• advancement: the advancement identifier (e.g. minecraft:end/kill_dragon)
• require_all_players: if true, all players must earn it; if false, any player (default: false)
• filter: optional Predicate API predicate for player-level matching

Example with a filter (only counts survival players entering the end portal):

{
  "type": "worldreset:portal_enter",
  "block": "minecraft:end_portal",
  "require_all_players": true,
  "filter": {
    "type": "entity",
    "value": {
      "condition": "minecraft:entity_properties",
      "predicate": { "gamemode": "survival" }
    }
  }
}

Credits

• The World Resets every 5 Minutes, Can we beat it? [inspiration]
• WorldReset (Bukkit plugin) [inspiration]