A wipe means deleting the world, and possibly the blueprints players have learned, and starting a new round. This guide explains the types of wipe, what Facepunch's monthly force wipe does, which files to delete, how to go about it step by step, what to do with plugin data and how to set up a regular schedule and the in-game countdown.
What you'll need
- Access to the server files and the ability to stop and start the server
- A free backup slot (game server backups) or space on your VPS disk
- An announcement to players in advance (Discord, server description)
- About 20 minutes
Rust at StormHost
We're still preparing Rust servers. This guide also applies to a Rust server on your own VPS (installation guide).
Types of wipe#
| Type | What gets deleted | What stays | When it's done |
|---|---|---|---|
| Map wipe | The map and everything on it: buildings, items, player inventories. | Learned blueprints, admins, bans, configuration. | With every new round (weekly, every two weeks, monthly). |
| Blueprint wipe (BP wipe) | All players' learned blueprints. | The map (unless you delete it at the same time). | Usually together with a map wipe, but less often (e.g. once a month). |
| Full wipe | Both the map and blueprints (possibly other player data too). | Admins, bans, server configuration, plugins. | Monthly or with a major server change. |
Force wipe#
Facepunch releases a major Rust update once a month, usually on the first Thursday of the month. The in-game wipe timer's default time is 19:00 London time (20:00 in Prague).
- The update raises the version (protocol) number stored in the world file's name. An updated server won't load the old world and generates a new one. So the map wipe happens by itself as soon as you update the server.
- According to the Facepunch wiki, blueprints usually aren't deleted at a force wipe. Whether you delete them is your call (BP wipe).
- Don't try to “revive” the old world by renaming the file. Facepunch calls this dangerous and advises against it.
- After a Rust update you also need a new framework version (upload Oxide again, Carbon updates itself), see Oxide and Carbon.
So plan your own wipes so that one of them always falls on force wipe day.
Which files to delete#
The world and player data are in the identity folder: server/<IDENTITY>/ in the server root (<IDENTITY> is the value of the server.identity parameter). The number in the file names is the version (protocol) and changes with updates. The .db database files may have helper files next to them with the same start of the name and the suffix -wal or -shm; always delete those together with the main file.
| File | What it contains (according to the Facepunch wiki) | Map wipe | BP wipe | Full wipe |
|---|---|---|---|---|
*.sav and its backups (*.sav.1 …) | The whole world: buildings, items, entities. | Delete | – | Delete |
*.map | The map (terrain, monuments). The name contains the size and seed. | Delete | – | Delete |
player.blueprints.*.db | Players' learned blueprints. | – | Delete | Delete |
player.states.*.db | Death markers, the hostile timer and other player state. | Recommended to delete | – | Delete |
player.deaths.*.db | Information about deaths (who killed the player and why). | – | – | Delete |
sv.files.*.db | Images on signs and photos from players' contacts. | Optional | – | Delete |
player.identities.*.db | Player data (Facepunch doesn't describe its purpose in detail). | – | – | Keep |
player.tokens.*.db | Player pairings with the Rust+ app. If deleted, players have to pair again. | Keep | Keep | Keep |
companion.id | The server's identity for Rust+. | Never | Never | Never |
cfg folder | server.cfg, admins, bans. | Keep | Keep | Keep |
loadouts, serveremoji folders | Saved loadouts and the server's custom emoji. | Keep | Keep | Keep |
Don't delete companion.id
The companion.id file is the server's identity for the Rust+ app. Facepunch warns that deleting it creates a new identity, players stop receiving notifications and have to pair the server again. The only way to get it back is from a backup.
Step-by-step procedure#
Announce the wipe to players in advance: on Discord, in the server description and in chat a few minutes before shutting down:
text say "Server is shutting down in 5 minutes for the wipe. The new map will be up in 15 minutes."Save the world with
server.saveso the backup is up to date.Stop the server (on a VPS,
systemctl stop rust).Make a backup of the whole
server/<IDENTITY>folder and theoxide(orcarbon) folder. On a game host, use the backup in the customer area, the Backups tab (game server backups); on a VPS, for example:bash tar -czf /root/rust-pred-wipe-$(date +%F).tar.gz -C /opt/rust/server server/rust oxidetar -czf <ARCHIVE>– creates (-c) a compressed (-z) archive in a file (-f).$(date +%F)– inserts today's date (2026-10-01) so backups don't overwrite each other.-C /opt/rust/server– works relative to the server root.server/rust oxide– backs up therustidentity folder and the Oxide folder. With Carbon, writecarboninstead ofoxide.
Deleting can't be undone
Without a backup, there's no way to get a deleted world or blueprints back. Before you continue, check that the backup from the previous step exists and isn't empty.
Delete the files according to the type of wipe (table above). On a game host in the file manager; on a VPS (identity folder
rust, paths as in the Your own Rust server on a VPS guide) with this command for a map wipe:bash cd /opt/rust/server/server/rust && rm -v -- *.sav* *.map player.states.*cd …– goes to the identity folder.&&makes sure the deletion only runs if changing into the folder worked (otherwise you'd be deleting somewhere else).rm -v– deletes the files and prints which ones it deleted.--– after this, there are no more options, only file names.*.sav*– the world and its backups,*.map– the map,player.states.*– player state.
For a BP wipe or full wipe, also delete the blueprints (the pattern also catches the
-waland-shmhelper files):bash cd /opt/rust/server/server/rust && rm -v -- player.blueprints.*A
No such file or directorymessage for one of the patterns just means there's no such file in the folder.Optionally change the seed (
+server.seed) or map size so the new map is different. See server.cfg and launch parameters.Update the server and the framework if an update is out (always at a force wipe).
Deal with plugin data as described in the next section.
Start the server (on a VPS,
systemctl start rust). Generating the new map takes a few minutes. The server is ready whenServer startup completeappears in the console.
Verification#
- Connect and check that the map is new (different layout, no old buildings).
- After a BP wipe, check that you have no learned blueprints.
- Enter
wipetimer.printwipein the console (listed on the Facepunch wiki as PrintWipe) and check the date of the next wipe. - Check that plugins are running:
oxide.plugins(Carbon:c.plugins).
Restoring from a backup when a wipe goes wrong#
Deleted more than you meant to, or the wipe shouldn't happen after all? Restore the state from the backup you made in step 4.
- Game host: restore the backup in the customer area (the Backups tab › Restore, see game server backups).
- Your own VPS (as root, paths as in the VPS guide):
systemctl stop rust
cd /opt/rust/server
mv server/rust server/rust-po-wipe
mv oxide oxide-po-wipe
tar -xzf /root/rust-pred-wipe-<DATE>.tar.gz -C /opt/rust/server
systemctl start rustsystemctl stop rust– stops the server so it doesn't overwrite anything while running.mv server/rust server/rust-po-wipeandmv oxide oxide-po-wipe– just move the current state aside (nothing is deleted) so it doesn't get mixed with the backup. With Carbon, movecarbonaside instead ofoxide.tar -xzf … -C /opt/rust/server– extracts the backup to its original location. Replace<DATE>with the date from the backup file name (for example2026-10-01).systemctl start rust– starts the server with the old world.
Once you've checked that everything works, delete the *-po-wipe folders you moved aside.
After a force wipe, the old world won't load
If you've updated the server to the new monthly version in the meantime, the old world won't work with it (it has an older version number) and the server will create a new one anyway. Restoring from a backup only makes sense on the same Rust version.
Wipes and plugin data#
Plugins store their data in oxide/data (Carbon: carbon/data). Some of it belongs to a single round and would make no sense after a wipe (homes on the old map, used-up kits); some of it should stay (permissions, clans).
- Many plugins detect a wipe by themselves. When the server creates a new world, the framework tells them, and the plugin deletes data according to its settings. The plugin's configuration decides, for example:
- Kits:
"Wipe player data when the server is wiped"– defaultfalse. Set it totrueif kit usage counters and cooldowns should reset after a wipe. - NTeleportation:
"Wipe On Upgrade Or Change"– defaulttrue, homes are deleted after a wipe. - Backpacks: the
"Enabled"option in the"Clear on wipe"section – defaultfalse, backpack contents survive the wipe. If backpacks should be emptied, set it totrue.
- Kits:
- For a plugin that doesn't detect a wipe, clear the data by hand: unload the plugin (
oxide.unload <PLUGIN_NAME>), delete its data file inoxide/dataand load the plugin again (oxide.load <PLUGIN_NAME>). It will create empty data. - Never delete
oxide/anddata/ oxide. users. data oxide/. They hold all permissions and groups.data/ oxide. groups. data - Keep the manually deleted files in mind when it comes to backups too: if you roll a wipe back from a backup, restore the world and plugin data from the same point in time.
You'll find details about specific plugins in the Recommended plugins article.
Scheduling and the in-game countdown#
Common schedules:
| Schedule | Tag | For whom |
|---|---|---|
| Weekly | weekly | Servers with faster progression (2x, 10x), lots of players. |
| Every two weeks | biweekly | A compromise, the most common on community servers. |
| Monthly | monthly | Vanilla servers; wipe only at the force wipe. |
A BP wipe is usually done only once a month (at the force wipe), even when the map is wiped more often.
Set the schedule with a tag in server.cfg (only one of monthly, biweekly, weekly). The wipe timer counts down based on it: the countdown on the laptop by the nuclear warhead in the Missile Silo monument. It also triggers the end-of-round events (fighter jets over the island and armored vehicles on the roads) roughly 24 hours before the wipe.
server.tags monthly,vanilla,EU
wipetimer.wipetimezone "Europe/Prague"
wipetimer.wipedayofweek 4
wipetimer.wipehourofday 20| Setting | What it does | Recommended value | When to change it |
|---|---|---|---|
server.tags | The wipe schedule (monthly/biweekly/weekly) and other tags. | according to your schedule | When the schedule changes. |
wipetimer.wipetimezone | The timer's time zone. The default is Europe/London. | "Europe/Prague" | – |
wipetimer.wipedayofweek | Wipe day: 0 = Sunday, 1 = Monday … 4 = Thursday (default) … 6 = Saturday. | 4 | When you wipe on a different day. |
wipetimer.wipehourofday | Wipe hour in 24-hour format; 14.5 = 14:30. Default 19. | 20 (with the Prague time zone, this matches 19:00 in London) | According to your wipe time. |
wipetimer. | A custom schedule in cron format; overrides the day and hour. | leave empty | Irregular schedules, e.g. “every 3 days”. |
wipetimer. | The exact time of the next wipe as a Unix timestamp. Overrides everything else; ignored if it's in the past. | leave empty | A one-off extra wipe. |
How the timer counts: monthly = the first given weekday of the month, weekly = every week, biweekly = the first and third given weekday of the month (according to the Facepunch wiki). How many hours before the wipe the end-of-round events start is set by a variable from the eventschedulewipeoffset group (default 24 hours, 0 turns them off); find eventschedulewipeoffset prints the exact name in your version.
Automation: Carbon has an optional AutoWipe module that wipes on a schedule (cron), can run commands and delete files after the wipe and can pick maps from a prepared list. On your own VPS, you can write a script run by a systemd timer or cron that performs the steps from the procedure above.
Troubleshooting#
The old map is still there after the wipe#
- You deleted files in a different identity folder than the one the server uses. Check
+server.identity. - The world's backup files remained (
*.sav.1,*.sav.2). Delete all files that start with the world's name and end with.savfollowed by anything. - You use a custom map (
server.levelurl): the map stays the same and only what was on it is deleted. That's correct.
Players still have their blueprints#
The player.blueprints.*.db file or its -wal and -shm helper files remained, or the server was running while you deleted them. Stop the server and delete all files starting with player.blueprints..
The server won't start after the wipe#
At a force wipe, it's usually a mismatch between the framework and game versions. Update both Rust and Oxide (Carbon updates itself on start) and check the log and oxide/logs or carbon/logs.
Plugins remember old data#
Homes in places where there's nothing anymore, used-up kits, full backpacks. Check the wipe settings in the plugins' configuration (the Wipes and plugin data section) or delete the data by hand.
The countdown on the laptop in the Missile Silo is wrong#
Check the schedule tag in server.tags (only one), the time zone and the hour. Verify the result with the wipetimer.printwipe command. For an irregular schedule, use wipetimer..
Rust+ doesn't work for players after the wipe#
You deleted companion.id or player.tokens.*.db. Restore them from a backup, or have players pair the server in the app again.
Summary
- Map wipe = delete
*.sav*and*.map(and preferablyplayer.states.*), BP wipe =player.blueprints.*, full wipe = both plus other player data. - Don't delete
companion.id,player.tokens.*, thecfgfolder or the plugin permission files. - The force wipe comes with the monthly update (first Thursday of the month); the update wipes the map by itself.
- Before a wipe, always save, stop and back up the server.
- What happens to plugin data after a wipe is controlled by their configuration (Kits, NTeleportation, Backpacks).
- You set the schedule and countdown with a tag and the
wipetimer.*variables.