Een Rust-server wipen: kaart, blueprints en planning

Een wipe betekent dat de wereld, en eventueel ook de geleerde blueprints, worden verwijderd en dat er een nieuwe ronde begint. We leggen de soorten wipes uit, wat de maandelijkse force wipe van Facepunch doet, welke bestanden je verwijdert, hoe je stap voor stap te werk gaat, wat je met de gegevens van plugins doet en hoe je een vast ritme en het aftellen in het spel instelt.

Soorten wipes#

Force wipe#

Facepunch brengt één keer per maand een grote update van Rust uit, meestal op de eerste donderdag van de maand. De standaardtijd van de wipetimer in het spel is 19:00 uur Londense tijd (20:00 uur Nederlandse tijd).

• De update verhoogt het versienummer (protocol) dat in de naam van het wereldbestand staat. Een bijgewerkte server laadt de oude wereld niet en genereert een nieuwe. De map wipe gebeurt dus vanzelf zodra je de server bijwerkt.
• Blueprints worden bij een force wipe volgens de wiki van Facepunch meestal niet verwijderd. Of je ze verwijdert, beslis je zelf (BP wipe).
• Probeer de oude wereld niet te “reanimeren” door het bestand te hernoemen. Facepunch noemt dat gevaarlijk en raadt het af.
• Na een update van Rust is ook een nieuwe versie van het framework nodig (Oxide opnieuw uploaden, Carbon werkt zichzelf bij), zie Oxide en Carbon.

Plan je eigen wipes daarom zo dat een ervan altijd op de dag van de force wipe valt.

Welke bestanden je verwijdert#

De wereld en de gegevens van spelers staan in de map van de identiteit: server/<IDENTITY>/ in de hoofdmap van de server (<IDENTITY> is de waarde van de parameter server.identity). Het getal in de bestandsnamen is de versie (protocol) en verandert met updates. Naast de databasebestanden .db kunnen hulpbestanden staan waarvan de naam hetzelfde begint en eindigt op -wal of -shm; verwijder die altijd samen met het hoofdbestand.

De stappen één voor één#

1. Kondig de wipe vooraf aan bij de spelers: op Discord, in de serverbeschrijving en een paar minuten voor het uitschakelen in de chat:

   say "De server gaat over 5 minuten uit voor de wipe. De nieuwe kaart staat er over 15 minuten."

2. Sla de wereld op met het commando server.save, zodat de back-up actueel is.

3. Schakel de server uit (op een VPS met systemctl stop rust).

4. Maak een back-up van de hele map server/<IDENTITY> en van de map oxide (of carbon). Gebruik bij gamehosting de back-up in je klantaccount, tabblad Back-ups (back-ups van gameservers), en op een VPS bijvoorbeeld:

   tar -czf /root/rust-pred-wipe-$(date +%F).tar.gz -C /opt/rust/server server/rust oxide

   • tar -czf <ARCHIVE> – maakt (-c) een gecomprimeerd (-z) archief aan in een bestand (-f).
   • $(date +%F) – voegt de datum van vandaag in (2026-10-01), zodat back-ups elkaar niet overschrijven.
   • -C /opt/rust/server – werkt relatief ten opzichte van de hoofdmap van de server.
   • server/rust oxide – maakt een back-up van de map van de identiteit rust en van de map van Oxide. Schrijf bij Carbon carbon in plaats van oxide.

5. Verwijder de bestanden die bij het soort wipe horen (tabel hierboven). Bij gamehosting doe je dat in het bestandsbeheer, op een VPS (map van de identiteit rust, paden volgens de handleiding Je eigen Rust-server op een VPS) met dit commando voor een map wipe:

   cd /opt/rust/server/server/rust && rm -v -- *.sav* *.map player.states.*

   • cd … – gaat naar de map van de identiteit. && zorgt ervoor dat het verwijderen alleen gebeurt als het wisselen van map is gelukt (anders zou je ergens anders verwijderen).
   • rm -v – verwijdert de bestanden en toont welke het heeft verwijderd.
   • -- – na dit teken komen geen opties meer, alleen bestandsnamen.
   • *.sav* – de wereld en de back-ups ervan, *.map – de kaart, player.states.* – de status van spelers.

   Verwijder bij een BP wipe of full wipe ook de blueprints (het patroon pakt ook de hulpbestanden -wal en -shm mee):

   cd /opt/rust/server/server/rust && rm -v -- player.blueprints.*

   De melding No such file or directory bij een van de patronen betekent alleen dat zo'n bestand niet in de map staat.

6. Wijzig eventueel de seed (+server.seed) of de kaartgrootte, zodat de nieuwe kaart anders is. Zie server.cfg en startparameters.

7. Werk de server en het framework bij als er een update is verschenen (bij een force wipe altijd).

8. Regel de gegevens van plugins volgens het volgende hoofdstuk.

9. Start de server (op een VPS met systemctl start rust). Het genereren van de nieuwe kaart duurt enkele minuten. De server is klaar zodra in de console Server startup complete verschijnt.

Controle#

1. Maak verbinding en controleer of de kaart nieuw is (andere indeling, geen oude bouwwerken).
2. Controleer na een BP wipe of je geen geleerde blueprints meer hebt.
3. Voer in de console wipetimer.printwipe in (op de wiki van Facepunch vermeld als PrintWipe) en controleer de datum van de volgende wipe.
4. Controleer of de plugins draaien: oxide.plugins (Carbon: c.plugins).

Terugzetten uit een back-up als de wipe mislukt#

Heb je per ongeluk meer verwijderd dan je wilde, of moet de wipe toch niet doorgaan? Zet de toestand terug uit de back-up die je in stap 4 hebt gemaakt.

• Gamehosting: herstel de back-up in je klantaccount (tabblad Back-ups › Herstellen, zie back-ups van gameservers).
• Eigen VPS (als root, paden volgens de handleiding voor de VPS):

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 rust

• systemctl stop rust – stopt de server, zodat hij tijdens het draaien niets overschrijft.
• mv server/rust server/rust-po-wipe en mv oxide oxide-po-wipe – zetten de huidige toestand alleen opzij (er wordt niets verwijderd), zodat die niet met de back-up wordt vermengd. Zet bij Carbon carbon opzij in plaats van oxide.
• tar -xzf … -C /opt/rust/server – pakt de back-up uit op de oorspronkelijke plek. Vervang <DATE> door de datum uit de naam van het back-upbestand (bijvoorbeeld 2026-10-01).
• systemctl start rust – start de server met de oude wereld.

Verwijder de opzijgezette mappen *-po-wipe zodra je hebt gecontroleerd dat alles werkt.

Wipe en de gegevens van plugins#

Plugins slaan hun gegevens op in oxide/data (Carbon: carbon/data). Een deel daarvan hoort bij één ronde en zou na een wipe onzin opleveren (homes op de oude kaart, opgebruikte kits), een deel moet blijven (rechten, clans).

• Veel plugins herkennen een wipe zelf. Wanneer de server een nieuwe wereld aanmaakt, meldt het framework dat aan de plugins en verwijdert de plugin de gegevens volgens zijn instellingen. De configuratie van de plugin bepaalt wat er gebeurt, bijvoorbeeld:
  • Kits: "Wipe player data when the server is wiped" – standaard false. Zet het op true als de teller van het gebruik van kits en de cooldowns na een wipe op nul moeten.
  • NTeleportation: "Wipe On Upgrade Or Change" – standaard true, de homes worden na een wipe verwijderd.
  • Backpacks: in de sectie "Clear on wipe" de optie "Enabled" – standaard false, de inhoud van de rugzakken overleeft de wipe. Zet het op true als de rugzak geleegd moet worden.
• Een plugin die de wipe niet herkent, regel je handmatig: ontlaad de plugin (oxide.unload <PLUGIN_NAME>), verwijder zijn gegevensbestand in oxide/data en laad de plugin (oxide.load <PLUGIN_NAME>). Hij maakt dan lege gegevens aan.
• Verwijder nooit oxide/data/oxide.users.data en oxide/data/oxide.groups.data. Daarin staan alle rechten en groepen.
• Denk ook bij back-ups aan de handmatig verwijderde bestanden: als je een wipe terugzet uit een back-up, zet dan de wereld en de gegevens van plugins van hetzelfde moment terug.

Details over de afzonderlijke plugins vind je in het artikel Aanbevolen plugins.

Planning en aftellen in het spel#

Gangbare ritmes:

Een BP wipe doe je meestal maar één keer per maand (bij de force wipe), ook als de kaart vaker wordt verwijderd.

Stel het ritme in met een tag in server.cfg (slechts één van monthly, biweekly, weekly). Daarmee rekent de wipetimer: het aftellen op de laptop bij de kernkop in het monument Missile Silo. Op basis daarvan starten ook de slotevenementen van de ronde (straaljagers boven het eiland en gepantserde voertuigen op de wegen), ongeveer 24 uur voor de wipe.

server.tags monthly,vanilla,EU
wipetimer.wipetimezone "Europe/Prague"
wipetimer.wipedayofweek 4
wipetimer.wipehourofday 20

Hoe de timer rekent: monthly = de eerste opgegeven dag van de maand, weekly = elke week, biweekly = de eerste en de derde opgegeven dag van de maand (volgens de wiki van Facepunch). Hoeveel uur voor de wipe de slotevenementen beginnen, bepaalt een variabele uit de groep eventschedulewipeoffset (standaard 24 uur, 0 schakelt ze uit); de exacte naam in jouw versie toont find eventschedulewipeoffset.

Automatisering: Carbon heeft een optionele module AutoWipe, die de wipe volgens een planning (cron) uitvoert, na de wipe commando's kan uitvoeren en bestanden kan verwijderen, en kaarten uit een voorbereide lijst kan kiezen. Op je eigen VPS kun je een script schrijven dat door een systemd-timer of cron wordt gestart en de stappen van hierboven uitvoert.

Als iets niet werkt#

Na de wipe staat de oude kaart er nog steeds#

• Je hebt in een andere identiteitsmap verwijderd dan de map die de server gebruikt. Controleer +server.identity.
• Er zijn back-upbestanden van de wereld blijven staan (*.sav.1, *.sav.2). Verwijder alle bestanden die beginnen met de naam van de wereld en eindigen op .sav met wat er ook achter staat.
• Je gebruikt een eigen kaart (server.levelurl): de kaart blijft dezelfde, alleen wat erop stond wordt verwijderd. Dat klopt.

Spelers hebben nog steeds blueprints#

Het bestand player.blueprints.*.db of de hulpbestanden -wal en -shm zijn blijven staan, of de server draaide terwijl je verwijderde. Schakel de server uit en verwijder alle bestanden die beginnen met player.blueprints..

De server start niet na de wipe#

Bij een force wipe komen de versies van het framework en het spel meestal niet overeen. Werk Rust en Oxide bij (Carbon werkt zichzelf bij tijdens het starten) en kijk in de log en in oxide/logs of carbon/logs.

Plugins onthouden oude gegevens#

Homes op plekken waar niets meer staat, opgebruikte kits, volle rugzakken. Controleer de wipe-instellingen in de configuratie van de plugins (hoofdstuk Wipe en de gegevens van plugins) of verwijder de gegevens handmatig.

Het aftellen op de laptop in Missile Silo klopt niet#

Controleer de ritmetag in server.tags (slechts één), de tijdzone en het uur. Controleer het resultaat met het commando wipetimer.printwipe. Gebruik voor een onregelmatig ritme wipetimer.wipecronoverride.

Rust+ werkt na de wipe niet meer voor spelers#

Je hebt companion.id of player.tokens.*.db verwijderd. Herstel ze uit een back-up, of laat de spelers de server opnieuw koppelen in de app.

Meer bronnen#

• Facepunch: bestanden in de identiteitsmap (opent in een nieuw venster)
• Facepunch: wipetimer (opent in een nieuw venster)
• Facepunch: tags in de serverlijst (opent in een nieuw venster)
• Facepunch: Rust+ en het bestand companion.id (opent in een nieuw venster)
• Carbon: de module AutoWipe (opent in een nieuw venster)