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.
Your force wipe checklist
Work through these in order. Each step says what to check before you move on.
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.
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.
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:
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.
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.
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.
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.
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.
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.versionShows the installed Oxide version. If the command isn’t found, Oxide didn’t load. Go back to step 5.
oxide.pluginsLists 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.versionShows the installed Carbon version. If the command isn’t found, Carbon didn’t load. Go back to step 5.
c.pluginsLists 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.
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.*.mapMap wipe. The generated map. The server makes a new one on start.
-
proceduralmap.*.sav.sav.1.sav.2Map wipe. The world save: every base, deployable and dropped item, plus its older copies.
-
player.deaths.*.dbplayer.identities.*.dbplayer.states.*.dbMap 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.*.dbBlueprint wipe only. Every player’s learned blueprints. Keep it unless you’re wiping blueprints.
-
player.tokens.dbFull reset only. Rust+ app pairing. Deleting it makes every player pair their app again.
-
server.cfgusers.cfgbans.cfgcfg/Keep. Server settings, owners and moderators, and bans. A wipe never needs these deleted.
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.
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.
