Rust Force Wipe Checklist: Everything Server Owners Need to Do Before Wipe Day

Which framework does your server run?Update steps, folders and commands on this page change to match.

Be ready for wipe day

Facepunch releases a Rust update on the first Thursday of every month, around 19:00 UK time, and every server has to update and wipe the map to stay joinable. Modded servers have more to do: the framework has to be updated after Rust, plugins have to compile against the new game, and the right data has to reset. This checklist covers all of it, in the order that avoids a broken server.

The order matters. Update Rust first, then OxideCarbon. A Rust update restores the game’s original files, so a framework installed before it is overwritten and your server starts vanilla, with no plugins.

Your force wipe checklist

Work through these in order. Each step says what to check before you move on.

1

The day before: list your plugins and tell your players

Write down every plugin your server runs and which ones it can’t run without: your economy, kits, shop, teleport, base protection. These are the ones you test first after the update.

  • Check each plugin’s page, changelog or Discord for wipe-day notices. Developers often post when an update is needed, or when a plugin works as it is.
  • Look for plugins that haven’t been updated in a long time. If an abandoned plugin breaks on wipe day, there may be no fix coming. Pick a maintained alternative before the wipe, not during it. See plugin compatibility.
  • Announce the wipe time to your players: in your Discord, on your server’s banner or description, and in game.
2

Turn off automatic restarts and updates

If your host panel restarts the server on a schedule or updates it on boot, pause that for wipe day. An automatic restart halfway through your update can start the server on the new Rust build without its framework, or before you’ve backed up.

Some hosts update Rust and OxideCarbon together on every restart. If yours does, you can let it, but still take the backup in step 3 first and do the checks in step 7 afterwards.

3

Save, stop and back up the server

Run server.save in the console, then stop the server. Copy these folders somewhere off the server, such as your own PC:

your server folder /server/your identity folder (e.g. server/rust/)
your server folder /oxide/plugins, config, data, lang
your server folder /carbon/plugins, configs, data, lang

The identity folder holds the map save, blueprints, server.cfg and users.cfg. The oxidecarbon folder holds every plugin, its config and its data, plus your groups and permissions. With both copied, any mistake from here on can be undone.

Keep the backup for a few days. Players sometimes report a missing purchase, a reset rank or a lost kit days after the wipe, and the old data file is the only way to check.
4

Update the Rust server

Wait until Facepunch has released the update. Clients update through Steam, so a server that updates early or late gets a protocol mismatch and players can’t join.

On a game host, use the panel’s Update or Reinstall game files button. On your own machine, update with SteamCMD. The Rust dedicated server is Steam app 258550:

steamcmd +force_install_dir "C:\rustserver" +login anonymous +app_update 258550 validate +quit

Change the folder to your own server folder. validate checks every game file and replaces any that are wrong. This is also why the framework has to go on afterwards.

5

Update OxideCarbon

Oxide releases a new build for each Rust update, usually within minutes of the Rust release. An old Oxide build on a new Rust build fails to load. Download the latest build from umod.org/games/rust:

  • Windows: Oxide.Rust.zip
  • Linux: Oxide.Rust-linux.zip

Extract it into your server folder, the one that holds RustDedicated.exe, and overwrite when asked. The zip’s folders match the server’s, so don’t extract it into RustDedicated_Data. Your oxide folder with plugins, configs and data is left alone.

Carbon releases its production build for a wipe-day Rust update about an hour before the Rust update itself. When self-updating is turned on ("SelfUpdating" → "Enabled": true in carbon/config.json, the default), Carbon downloads the matching build when the server starts on the latest Rust version.

If self-updating is off, or Carbon doesn’t load after the update, download the latest production release from Carbon’s GitHub releases:

  • Windows: Carbon.Windows.Release.zip
  • Linux: Carbon.Linux.Release.tar.gz

Extract it into your server folder and overwrite when asked. Your carbon plugins, configs and data are left alone. On Linux, start the server the way Carbon’s release notes describe, so its environment script runs first.

6

Wipe the map, and blueprints if you choose to

With the server still stopped, delete the wipe files from your identity folder (server/rust/ or your own identity name). A force wipe requires a map wipe. Blueprint wipes are only forced now and then, when Facepunch announces one, so check the update notes before you decide.

The wipe files table lists what to delete for each kind of wipe. If you want a new map, change server.seed in your startup command or panel now, or update server.levelurl if you run a custom map.

7

Reset the plugin data that should reset

Plugins keep their data in oxidecarbon/data/, as one file or folder per plugin. A map wipe doesn’t touch it, so data from the old wipe carries over unless you reset it.

  • Usually reset: data that belongs to one wipe, like leaderboards and wipe stats, cooldowns, saved homes and teleport points, claimed kit counts and anything tied to positions on the old map.
  • Usually keep: data players paid for or earned across wipes: purchased perks, VIP time, store balances and long-term ranks.
  • Many plugins reset their own wipe data when they detect a new map, or have a config option for it. Check each plugin’s page before deleting a file by hand. A deleted file can’t be brought back without your backup.

Never delete oxide.groups.data or oxide.users.data. They hold your groups and permissions, and a wipe doesn’t change them.

Leave Carbon’s own permission and group data in place. A wipe doesn’t change your groups or permissions.

8

Start the server and test before you open

Start the server and watch the console while it loads. Each plugin that fails to compile or load prints an error with its name. When the server is up, run these in the console or RCON:

Check Oxide and your plugins

  • oxide.version

    Shows the installed Oxide version. If the command isn’t found, Oxide didn’t load. Go back to step 5.

  • oxide.plugins

    Lists every loaded plugin. Compare it with the list you made in step 1.

  • oxide.reload "Plugin name"

    Reloads one plugin after you’ve replaced or fixed it, without restarting the server.

Check Carbon and your plugins

  • c.version

    Shows the installed Carbon version. If the command isn’t found, Carbon didn’t load. Go back to step 5.

  • c.plugins

    Lists every loaded plugin. Compare it with the list you made in step 1.

  • c.reload "Plugin name"

    Reloads one plugin after you’ve replaced or fixed it, without restarting the server.

Then join the server yourself and try the features your players use the most: open the shop, claim a kit, set a home, check your permissions as a VIP. A plugin can load without errors and still misbehave after a Rust update.

Turn your automatic restarts back on, then open the server and announce that it’s live.

A plugin won’t load? Unload it and open the server without it, rather than keeping everyone waiting. Check for an update, report the error to its developer, or swap in a maintained alternative later in the wipe.

Wipe files

All of these are in your identity folder, e.g. server/rust/. The file names include your map size and seed, so the asterisk stands for those. Delete a file’s -wal partner along with it.

  • proceduralmap.*.map

    Map wipe. The generated map. The server makes a new one on start.

  • proceduralmap.*.sav .sav.1 .sav.2

    Map wipe. The world save: every base, deployable and dropped item, plus its older copies.

  • player.deaths.*.db player.identities.*.db player.states.*.db

    Map wipe. Player data tied to the old world. Some guides keep these on a map wipe, and the server still starts if you do.

  • player.blueprints.*.db

    Blueprint wipe only. Every player’s learned blueprints. Keep it unless you’re wiping blueprints.

  • player.tokens.db

    Full reset only. Rust+ app pairing. Deleting it makes every player pair their app again.

  • server.cfg users.cfg bans.cfg cfg/

    Keep. Server settings, owners and moderators, and bans. A wipe never needs these deleted.

Using a host panel? Most have a Wipe page with “Map wipe” and “Map and blueprint wipe” options that delete the right files for you. Take your backup first anyway.

Plugin compatibility

Most wipe-day problems on modded servers come from plugins, not from Rust or the framework.

Why plugins break on wipe day

Plugins are compiled when the server loads them, against the current Rust and framework code. When a Rust update renames something a plugin uses, that plugin fails to compile and simply doesn’t load, while the rest of the server keeps running. Usually the developer releases a small fix, and you replace the file.

Replace abandoned plugins early

A plugin nobody maintains can work for months and then break for good on one update. If a plugin you rely on hasn’t been updated in a long time, test a maintained alternative during the current wipe, so you can switch on wipe day without losing a feature.

Plugins for Oxide and Carbon

Every ModPulse plugin supports both Oxide and Carbon, so switching frameworks doesn’t mean replacing your plugins. Downloads are instant from your account, and support is on Discord if something isn’t right after an update.

Know what’s out of date

Plugin Update Checker is free. It checks your server for outdated ModPulse plugins once when the server starts, and can post the result to Discord with a webhook. Run check in the console to check again by hand.

Bring players back after the wipe. Welcomer greets every player who connects, and Restart Rewards announces scheduled restarts and rewards players who reconnect afterwards.

Troubleshooting

The server starts, but no plugins load

The Rust update overwrote the framework, or the framework was installed before Rust was updated. Stop the server and install the latest OxideCarbon again, as in step 5. Then check that oxide.versionc.version works.

Players can’t join: the server shows as outdated or gets a protocol mismatch

The server and the players’ game are on different Rust builds. Update the server again with SteamCMD or your panel. If the server is up to date, the players need to restart Steam to get the update.

One plugin fails to compile

The console error names the plugin and the line. Download the latest version from where you got it and replace the file in oxidecarbon/plugins/. It reloads by itself. If there’s no update yet, leave it unloaded and open the server without it.

Players kept their blueprints, or lost them by mistake

Blueprints are stored in player.blueprints.*.db. If they should have been wiped, stop the server and delete that file. If they were wiped by mistake, stop the server and copy the file back from your backup. Only restore it before players have started learning new blueprints, or they lose those.

Carbon didn’t update itself

Carbon’s production build only self-updates once the server is on the latest Rust version, so update Rust first. Also check "SelfUpdating" is enabled in carbon/config.json. Otherwise, install the latest release by hand as in step 5.

Old wipe data still shows up in a plugin

That plugin’s data in oxidecarbon/data/ wasn’t reset. Check the plugin’s page for a wipe or reset option first. If it has none, stop the server, delete that plugin’s data file, and start again.

Take your server further

High performance Rust plugins for Oxide / Carbon, with support on Discord.