DGuard

Minecraft server wipe: resetting the world for a new season

A wipe resets the world and players' progress. Anarchy and economy survival servers run it in seasons: newcomers start on equal terms and an inflated economy goes back to zero. Here's what to reset and what you must keep, where the files live on 1.21.x and 26.x, and how to prepare the launch so day one doesn't drown in lag and cheaters.

The DGuard team7 min read

In short: announce the date in advance, stop the server, make a full backup and set the world folders aside — world, world_nether and world_the_end on Paper 1.21.x, just world from 26.1. Players' inventories, statistics and advancements go with the world. Reset plugin progress data — economy, homes, claims — separately, and keep permissions, bans, the whitelist and donor perks. Pre-generate the new world before opening and greet the launch with an anticheat that's already set up.

When and why to wipe

  • An inflated economy. Veterans sit on piles of resources and money, shop prices mean nothing, and newcomers have nothing to strive for.
  • A seasonal game mode. On anarchy and competitive survival servers, seasons are part of the genre: the map, leaderboards and clans start over.
  • A new game version. An update is a convenient moment to start a season on a fresh map. Updating itself is covered in updating the Minecraft version.
  • The fallout of a dupe or cheating. If the damage can no longer be undone selectively — with CoreProtect and item removal — a wipe is the last resort. Closing dupes is covered in exploits and dupes.

A wipe is a strong measure: some players leave along with their progress. A predictable season schedule announced in advance goes down better than a sudden reset.

Where things live: 1.21.x and 26.x

WhatPaper 1.21.xPaper 26.1 and newer
The overworldworld/ (chunks in world/region/)world/dimensions/minecraft/overworld/
Nether and Endworld_nether/, world_the_end/world/dimensions/minecraft/the_nether/, .../the_end/
Player data: inventory, ender chest, experience, positionworld/playerdata/world/players/data/
Statisticsworld/stats/world/players/stats/
Advancementsworld/advancements/world/players/advancements/
Maps, scoreboardworld/data/world/data/minecraft/
Bans, OPs, whitelistServer root: banned-players.json, banned-ips.json, ops.json, whitelist.jsonSame
world is the level-name value from server.properties. From the Minecraft Wiki (Java Edition level format) and the Paper docs

That gives a simple method: set the whole world folder aside — player data, statistics and advancements go with it, while bans and OPs in the root stay put. If the level-name folder doesn't exist, the server generates a new world on startup. level-seed in server.properties sets the seed; empty means random.

set last season's world aside (Linux)
# the server is stopped and a full backup is done
cd /opt/minecraft
mkdir -p seasons/season-1

# Paper 1.21.x: each dimension has its own folder
mv world world_nether world_the_end seasons/season-1/

# Paper 26.1 and newer: every dimension and the players live inside world
# mv world seasons/season-1/

Plugin data: what to reset, what to keep

DataWhere it livesOn a wipe
Permissions and donor groupsLuckPerms: an H2 file in its folder by default, or MySQLKeep. Purchased perks must survive the wipe — see donation store
Bans and mutesbanned-players.json, banned-ips.json or a punishment plugin's databaseKeep. A wipe isn't an amnesty
EssentialsX money and homesplugins/Essentials/userdata/<uuid>.ymlUsually reset. All balances back to the starting amount: /eco reset **
WorldGuard regionsPer world, in the plugin's folderReset: the old world's regions mean nothing in the new one
CoreProtect logsThe plugin's database: SQLite or MySQLOptional: /co purge or a fresh database
Shops, clans, quests, leaderboardsThose plugins' folders and databasesDecide for each in advance and write it down

/eco reset ** in EssentialsX sets the starting balance for every player the plugin knows, offline ones included; * only covers players online. Old CoreProtect logs only confuse things in a new world: same coordinates, different builds. From the console /co purge removes data older than 24 hours, in game — older than 30 days. How a server economy is put together is in economy and Vault.

The wipe step by step

  1. 1

    Announce the date

    In Discord, in the server chat and in the MOTD: what resets, what stays, when the launch is. Changing the server-list description is covered in MOTD and icon.

  2. 2

    Stop the server and back up

    stop, then a full archive of the server folder and the database dumps.

  3. 3

    Set the worlds aside

    Move the world folders into a season archive folder, as in the example above.

  4. 4

    Reset plugin data

    Per the table: economy, regions, logs, shops. Leave permissions, bans and donor perks alone.

  5. 5

    Set up the new world

    A new level-seed, or empty for a random one; game rules — see gamerules; the border — see world border.

  6. 6

    Start with the whitelist on

    /whitelist on: the server generates the new world, and you can pre-generate it calmly and check spawn, kits, shops and the anticheat.

  7. 7

    Open

    /whitelist off at the announced time.

Launch day: the load

In the first hours every player runs off from spawn in a different direction, and the server generates chunks on the fly — one of the heaviest things it does. Set a world border and pre-generate everything inside it before opening, following world pre-generation. Watch TPS and MSPT (see TPS and MSPT) and keep the spark profiler at hand.

A loud announcement attracts more than players: be ready for bots at opening too — see bots and DDoS. How much memory the peak needs is in how much RAM a server needs.

A new season brings a new wave of cheaters

A fresh map is a race: the first diamonds, the first base, the top spot. That's exactly where cheaters show up: Speed and Fly to reach resources first, Nuker and FastBreak to out-farm everyone, KillAura to take what others have. An anticheat installed after the first complaint is too late: the season's leaderboards and economy are already spoiled.

Install DGuard — the best anticheat for a modern Minecraft server — before opening: a key from the panel, the latest PacketEvents release, DGuard.jar in plugins/ and a restart; /dguard license shows the plan, the license state and the PacketEvents version. DGuard gathers evidence on every front at once — combat, movement, packets, inventory, building, world — doesn't rush to a verdict, and you set the strictness. The plan depends on online players, so estimate the launch peak in advance — see pricing; DGuard is free up to 30 players online. A plugin anticheat can't see X-Ray — Paper's anti-xray handles that, see X-Ray protection.

FAQ

What is a wipe on a Minecraft server?

A reset of the world and players' progress: a new map, empty inventories, a zeroed economy. Permissions, bans and purchased perks are usually kept.

Where does a server store player inventories?

In the world folder: in world/playerdata/ before 26.1 and in world/players/data/ from 26.1, one file per player UUID. That's why inventories reset along with the world folder.

How do I reset everyone's money in EssentialsX?

With /eco reset ** — it sets the starting balance for every player the plugin knows, offline ones included. /eco reset * only affects players who are online.

Does a world wipe reset bans and OPs?

No, if you only set the world folders aside: banned-players.json, banned-ips.json, ops.json and whitelist.json sit in the server root, and LuckPerms permissions live in its folder or database.

Sources

All sections

Run the best anticheat for modern Minecraft

DGuard catches all 47 kinds of cheats in our comparison — the closest rival, Intave, has 27. Full protection on every plan, free up to 30 players online.