Kort antwoord: Controleer na een Rust-update eerst welk framework er daadwerkelijk draait. Onder Oxide helpen oxide.version, oxide.plugins en de startlog je verder. Ontbreekt er maar één plugin, maak dan onderscheid tussen een compilerfout, een ontbrekende afhankelijkheid en een configuratiefout. Geladen plugins sluiten een frameworkfout niet uit. Maak een back-up van je bestanden en savegame voordat je iets wijzigt; een wipe of het verwijderen van alle configs is geen zinvolle eerste diagnosestap.
Deze guide geldt voor Rust Dedicated Servers van de pc-versie, zelf gehost of bij een willekeurige aanbieder. Voor beheerstappen heb je toegang nodig tot de echte serverconsole of geautoriseerde RCON en eventueel tot de serverbestanden. Een klantaccount bij SupremeTier is niet vereist. Speel je alleen op de getroffen server, begin dan bij de volgende sectie.
Stand van zaken: 6 november 2026; eigen fouttests: 29 oktober 2026. De commando's in de hoofdprocedure hebben betrekking op Oxide. Carbon wordt apart besproken. De foutscenario's “afzonderlijke plugin compileert niet” en “afhankelijkheid ontbreekt” zijn op een eigen geïsoleerde testserver gecontroleerd opgewekt en verholpen. Deze tests simuleren foutsituaties; het zijn geen waarnemingen van een uitgevallen plugin van derden na de update. Ook een opzettelijk gemengde frameworkstand is geïsoleerd getest. Daarbij laadden plugins terwijl een framework-hook mislukte. De onderstaande originele uitvoer komt uit gecontroleerde fouttests en wordt niet voorgesteld als een natuurlijk incident op een klantenserver.
Als speler: wat kun je doen?
Een verdwenen /kit-menu bewijst niet dat je inventaris is gewist. Misschien ontbreekt alleen de plugin die het commando aanbiedt. Vraag eerst of andere spelers dezelfde functie missen en of meerdere onafhankelijke functies zijn getroffen. Noteer het tijdstip, het ingevoerde commando en de zichtbare reactie. Een screenshot van een melding helpt; privé-spelersnamen kun je afdekken voordat je hem doorstuurt.
Meld bijvoorbeeld: “Sinds de herstart rond 19.00 uur krijg ik geen reactie op mijn kit-commando. Teleport werkt ook niet. Normaal bouwen werkt wel. Voor de herstart werkte beide.” Daarmee kunnen de beheerders gericht zoeken naar de bijbehorende serverstart. De bewering “Alles is gewiped” zou zonder controle te ver gaan.
Installeer geen willekeurig aangeboden clientbestanden als vermeende reparatie van een serverplugin. Als speler kun je het framework aan de serverkant niet opnieuw laden. Ontbreken er beschermingsfuncties, zoals de PvE-regels die op deze server zijn beloofd, reken er dan niet op totdat er duidelijkheid is. De beheerders moeten beslissen of normaal doorspelen veilig is.
Maak eerst onderscheid tussen de drie lagen
Voor deze diagnose bestaat een gemodde Rust-server uit drie lagen. Rust zelf levert de spelwereld en de spelmechanieken. Het framework, hier Oxide of als alternatief Carbon, maakt de uitbreidingen mogelijk. Afzonderlijke plugins implementeren bijvoorbeeld kits, teleport, beheerfuncties of wijzigingen in de spelregels. Sommige plugins hebben andere plugins of extensions nodig.
Als een onderliggende laag ontbreekt, lijken veel functies daarboven tegelijk kapot. Als één uitbreiding uitvalt, kunnen de andere blijven werken. Dit onderscheid is het uitgangspunt, maar nog geen bewijs: ook meerdere plugins kunnen dezelfde ontbrekende bibliotheek nodig hebben. Omgekeerd kan een framework reageren en toch problemen hebben bij bepaalde game-events.
“Bestand aanwezig”, “gecompileerd”, “geladen” en “werkt” zijn vier verschillende toestanden. Een .cs-bestand in de juiste map bewijst alleen dat daar broncode staat. Compileren betekent dat daaruit uitvoerbare code is gemaakt. Laden omvat de initialisatie. Pas een gerichte functietest laat zien of het gewenste gedrag met jouw instellingen en rechten echt werkt.
De officiële Oxide-documentatie over het installeren van plugins beschrijft .cs-bestanden, automatisch compileren en de pluginmap. Verwar dit bestandsniveau niet met zichtbaar succes in het spel.
De snelle beslisroute
Begin nadat de server volledig is opgestart in de serverconsole, niet in de normale spelchat. Deze eerste controle wijzigt geen plugins:
oxide.version
oxide.plugins
oxide.version vraagt de frameworkversie op. oxide.plugins toont de plugins, inclusief mislukte laadpogingen. De officiële commandoreferentie beschrijft de pluginlijst en de gerichte laadcommando's; de Owner-guide over commando's legt de console en de chat uit.
| Waarneming | Eerste werkhypothese |
Volgende controle |
|---|---|---|
| Oxide reageert niet, veel functies ontbreken | Framework ontbreekt, start niet of verkeerde consolecontext |
Startlog, daadwerkelijk gekozen framework en installatie controleren |
| Oxide reageert, meerdere plugins draaien, één mislukt | Probleem met deze plugin of de vereisten ervan |
Eerste volledige foutmelding en pluginversie lezen |
| Meerdere getroffen plugins noemen dezelfde afhankelijkheid | Gemeenschappelijke afhankelijkheid uitgevallen |
Deze afhankelijkheid als eerste onderzoeken |
| Plugin is geladen, alleen één functie ontbreekt | Rechten, instellingen, hook of runtimeprobleem |
Concrete functie onder gecontroleerde omstandigheden testen |
| Nieuwe configs, andere wereld of schijnbaar lege data | Mogelijk een andere serverinstantie of een ander datapad |
Identiteit, startparameters en mounts vergelijken met de vorige toestand |
Een onbekend commando is een aanwijzing, geen kant-en-klare diagnose. Controleer of je echt de console van de getroffen server hebt geopend, of het opstarten is voltooid en of deze server überhaupt Oxide gebruikt. Bij Carbon is een Oxide-specifieke test alleen geen voldoende basis.
Voor elke reparatie: bewijs en terugweg veiligstellen
Een goede diagnose begint met een korte inventarisatie. Leg vast wanneer de fout voor het eerst opviel, welke game-update of herstart eraan voorafging en wat er sindsdien al is gewijzigd. Bewaar de samenhangende startlog vanaf het begin van het proces tot en met de eerste foutmelding. Een schermafbeelding van de laatste rode regel is vaak niet genoeg, omdat die alleen de vervolgfout laat zien.
Oxide schrijft laad- en compilerfouten bovendien naar eigen logbestanden in de map oxide/logs van je serverinstallatie. Daar staat een melding vaak vollediger dan in het zichtbare deel van de console, bijvoorbeeld als de console alleen de laatste regels toont. Kies het bestand waarvan de datum overeenkomt met de betreffende start en bewaar het samen met de consolelog.
Noteer de Rust-versie of buildinformatie, de gebruikte releasebranch, het besturingssysteem, de frameworkversie en de versies van de getroffen plugins. Bewaar ook de downloadbron van de geïnstalleerde bestanden. “Nieuwste versie” is geen reproduceerbare versieaanduiding: het bestand kan sinds je download zijn vervangen, of je startscript laadt een andere versie dan verwacht.
Wat hoort er in de back-up?
Maak een back-up van een samenhangende stand van de wereld- en spelersdata, de startconfiguratie en de moddingbestanden. Bij Oxide horen met name oxide/plugins, oxide/config en oxide/data in de inventarisatie; denk ook aan rechtendata en eigen uitbreidingen. De concrete opslagstructuur hangt af van de installatie. Controleer de paden die je daadwerkelijk gebruikt, in plaats van blindelings een voorbeeldmap over te nemen.
Maak onderscheid tussen instellingen en gebruiksdata. Een config bepaalt bijvoorbeeld het gedrag van een plugin; de data van die plugin kunnen al uitgedeelde beloningen, opgeslagen posities of andere blijvende toestanden bevatten. De inhoud verschilt per plugin. Het zomaar leegmaken van oxide/data kan daarom meer veranderen dan alleen de defecte functie.
Gebruik voor een consistente back-up de gedocumenteerde back-upprocedure van je installatie. Een kopie die wordt gemaakt terwijl er nog naar bestanden wordt geschreven, kan inconsistent zijn. Controleer of de back-up echt is voltooid en kan worden opgehaald. Pak hem uit of controleer hem op een aparte locatie, zonder de huidige server te overschrijven. Alleen een weergegeven back-upnaam is nog geen geteste terugweg.
Bepaal de grens van je wijziging
Schrijf voor de ingreep op: “Ik vervang alleen dit pluginbestand” of “Ik installeer het Oxide-pakket dat bij de huidige Rust-versie past opnieuw”. Daarbij horen het opgeslagen oude bestand, het nieuwe bestand en het succescriterium. Wijzig niet tegelijk het framework, meerdere plugins, configs en mapparameters. Anders weet je achteraf niet welke ingreep heeft geholpen of schade heeft veroorzaakt.
Als een beschermings-, economie- of toegangsplugin uitvalt, beslis dan vóór de test of de server beschikbaar blijft. Een wereld die technisch bereikbaar is, is niet automatisch speelbaar onder de beloofde regels. Kondig een noodzakelijke onderbreking aan en gebruik de reguliere stopprocedure van je installatie. Herhaaldelijk hard afbreken vervangt geen diagnose.
Geval A: het framework valt uit
Typische situatie: de server start na een game-update, maar talloze onafhankelijke pluginfuncties ontbreken. In de huidige startlog is niet te zien dat Oxide succesvol is geladen, of de versieopvraag geeft in de juiste consolecontext geen frameworkversie terug.
De oorzaak die je moet controleren, is niet alleen „Oxide is te oud”. De game-update kan gewijzigde bestanden vervangen, een startscript kan daarna de vanillabestanden terugzetten en het framework kan in de verkeerde servermap zijn uitgepakt. Ook een verkeerd besturingssysteempakket, een niet-passende gamebranch of een onvolledige upload kunnen de oorzaak zijn.
Facepunch wijst er in de handleiding voor de Dedicated Server uitdrukkelijk op dat een game-update een nieuwe Oxide-installatie kan vereisen en dat SteamCMD tijdens het opstarten bestanden weer naar vanilla kan terugzetten. Daaruit volgt de belangrijke volgorde: game updaten, de passende frameworkversie installeren en dan de server starten. Een extra controle van de gamebestanden na de frameworkinstallatie kan het werk weer tenietdoen.
Volgorde bij zelf hosten
Bij een zelf gehoste server met SteamCMD ziet de volgorde er zo uit. Het pad is een voorbeeld; vul je eigen servermap in:
steamcmd +force_install_dir /pfad/zum/rustserver +login anonymous +app_update 258550 validate +quit
258550 is de app-ID van de Rust Dedicated Server. validate controleert de gamebestanden en herstelt daarbij de vanillaversie. Precies daarom komt Oxide pas daarna: download uit de officiële Oxide.Rust-release het archief voor je besturingssysteem, Oxide.Rust-linux.zip voor Linux of Oxide.Rust.zip voor Windows. Pak het met behoud van de mappenstructuur uit in de hoofdmap van de server, dus daar waar ook RustDedicated of RustDedicated.exe staat, en laat bestaande bestanden overschrijven. Start de server pas daarna en controleer oxide.version.
Roept je startscript vóór elke start SteamCMD aan, dan vervangt het de Oxide-bestanden bij elke herstart opnieuw. In dat geval hoort de Oxide-installatie ook in het startscript, tussen de update en de serverstart, of haal je de automatische update uit het startscript. Bij managed hosting gebruik je in plaats daarvan de frameworkfunctie van je aanbieder.
Huidige release en historische testcombinatie uit elkaar houden
Bij onze releasecontrole op 6 november 2026 was de officiële Oxide.Rust-release 2.0.7894 de nieuwste gepubliceerde versie. Deze werd op 6 november 2026 om 10:11:56 UTC gepubliceerd en vermeldt de eerste Rust-hotfix van die dag voor 2636.290.1. Dat Rust-nummer is geen Oxide-pakketversie. Deze update bevestigt de gepubliceerde release, maar is geen eigen functietest met de nieuwe combinatie.
Onze eigen fouttests blijven op de stand van 29 oktober 2026: de uMod-changelog voor Rust vermeldt voor de update van 22 oktober 2635.289.1; de bijbehorende officiële Oxide.Rust-release 2.0.7839 werd op 22 oktober 2026 om 18:02:03 UTC gepubliceerd. Op onze geïsoleerde testserver meldden version en oxide.version daadwerkelijk Rust-protocol 2635.289.1 en Oxide.Rust 2.0.7839. Dat is een historische testcombinatie en geen blijvend advies om deze nummers ook na latere updates aan te houden.
Controleer bij de daadwerkelijke ingreep opnieuw de huidige release en de Rust-versie van je server. Dat er een passende releasevermelding bestaat, bewijst niet dat je aanbieder of startscript deze versie al heeft geïnstalleerd. Doorslaggevend is de versie die je daarna uit de draaiende instantie uitleest, samen met de huidige startlog.
Eigen test A: frameworkfout ondanks geladen plugins
Onze uitgangssituatie was Rust-protocol 2635.289.1 met de bijbehorende Oxide.Rust 2.0.7839. Na een reguliere stop en een back-up van onze eigen testwereld inclusief de Oxide-map plaatsten we alleen op de geïsoleerde testserver bewust de oude Oxide.Rust.dll uit de officiële release 2.0.7072 van 19 februari 2026. De rest van de actuele installatie bleef ongewijzigd. Dit simuleert een gemengde, niet bij elkaar passende frameworkstand; het is geen test van een volledig historisch serverpakket.
De wijziging werd gecontroleerd aan de hand van de SHA-256 van de daadwerkelijk geplaatste DLL. Bij het starten verscheen deze echte melding:
Failed to call hook 'IOnServerCommand' on plugin 'RustCore v2.0.7072' (MissingFieldException: Field not found: string .Arg.FullString Due to: Could not find field in class)
Tegelijkertijd bereikten onze eigen testplugins hun initialisatiemarkeringen. Ook het serverproces bleef draaien. Dat is het belangrijke verschil met een te simpele vuistregel: een frameworkprobleem hoeft niet alle plugins van het laden te weerhouden. Een geslaagde pluginlijst of een draaiend proces is geen volledige compatibiliteitscontrole.
De melding noemt RustCore, dus een frameworkcomponent, en een veldtoegang die niet gevonden werd. Het is geen JSON-fout in een kitconfiguratie. In deze doelbewust gecreëerde combinatie ligt de oorzaak bij de niet-passende frameworkstand. Hetzelfde type fout onder een andere naam kan daarentegen in één afzonderlijke plugin ontstaan; lees dus altijd component, hook en context samen.
Voor het minimale herstel zetten we de eerder vastgelegde, passende DLL 2.0.7839 terug en startten we gecontroleerd opnieuw op. Daarna antwoordde oxide.version weer met 2.0.7839, toonde oxide.plugins alle vier onze eigen testplugins en was de eerder waargenomen MissingFieldException niet meer aanwezig in de nieuwe beschikbare consolebuffer. De weg terug naar het passende framework is daarmee voor deze specifieke test gecontroleerd. Voor je productieserver volgt hieruit geen advies om losse DLL's uit willekeurige archieven bij elkaar te kopiëren: gebruik daar de volledige, passende installatieprocedure van het framework, zodat de stand consistent is.
De test gebruikt bewust een aanzienlijk oudere release. Hij beweert niet dat elke oudere versie op dezelfde manier faalt en ook niet dat precies dit foutbeeld bij elke oktober-update optreedt. Uitval van het framework kan ook gewoon betekenen dat de server vanilla draait zonder geladen Oxide. Daarom blijft de combinatie van daadwerkelijke versie, eerste logdiagnose en functietest nodig.
Minimale reparatie
- Maak een back-up van de uitgangssituatie en de log. Controleer of er op dat moment een automatische updater actief is. Start geen tweede, tegenstrijdig installatieproces.
- Vergelijk de Rust-versie, de releasebranch, het besturingssysteem en de daarvoor bedoelde frameworkrelease.
- Stop de server op de reguliere manier als de installatie wijzigingen aan de frameworkbestanden vereist.
- Gebruik de gedocumenteerde installatieprocedure. Bij zelf hosten pak je het betrouwbare, passende archief met behoud van de mappenstructuur uit in de juiste installatie, in de hierboven beschreven volgorde. Bij managed hosting gebruik je de frameworkfunctie van je aanbieder; ga er niet van uit dat paneelmenu's van anderen ook bij jouw aanbieder gelden.
- Controleer de updatevolgorde en start één keer gecontroleerd op. Lees de nieuwe startlog.
- Controleer de frameworkversie, de pluginlijst en minstens één functie die eerder was uitgevallen.
Succes: het verwachte framework antwoordt vanuit de juiste instantie, de verwachte plugins worden geladen en de gecontroleerde functie werkt. Terugweg: bewaar de toestand van vóór de ingreep. Zet niet blindelings een oud frameworkbestand terug over een nieuwe game. Als alleen een ouder totaalpakket compatibel was, moet apart worden gecontroleerd of dat kan worden hersteld, inclusief wereldformaat en clientcompatibiliteit. Is dat onduidelijk, houd de server dan gecontroleerd buiten bedrijf tot er een passende versie beschikbaar is.
Geval B: een plugin compileert niet
Typische situatie: Oxide antwoordt en andere plugins worden geladen, maar één bepaalde plugin wordt als mislukt weergegeven. De log noemt een compilerfout, vaak met bestand, regel, kolom en een ontbrekend symbool of een methode die niet meer past.
Een compilerfout betekent in eerste instantie alleen: de aanwezige broncode kan niet worden gecompileerd tegen de beschikbare referenties. Een game-update kan een gebruikte interface hebben gewijzigd. Maar ook een beschadigde download, eigen aangepaste code of een ontbrekende harde afhankelijkheid is mogelijk. “Failed to compile” betekent dus niet automatisch “de auteur hoeft alleen een nieuwe versie uit te brengen”.
Eigen test B: een compilerfout
Op onze geïsoleerde testserver met Rust-protocol 2635.289.1 en Oxide.Rust 2.0.7839 bevatte uitsluitend de testplugin Guide7CompileBroken.cs een opzettelijke #error-regel. De al geladen controleplugin Guide7Probe bleef daarvan gescheiden. De echte console-uitvoer luidde:
Error while compiling Guide7CompileBroken: #error: 'GUIDE7_INTENTIONAL_COMPILE_FAILURE' | Line: 1, Pos: 8
Voor de minimale reparatie verwijderden we alleen de opzettelijk toegevoegde foutregel. Daarna meldde de console:
Guide7CompileBroken was compiled successfully in 362ms
Loaded plugin Guide7CompileBroken v1.0.0 by Guide7 isolated test fixture
De weg terug bij deze gecontroleerde test is het herstellen van het ongewijzigde foutbestand; daarmee zou dezelfde opzettelijke compilerfout opnieuw ontstaan. Voor een echte plugin van derden is “verwijder zomaar een regel” uitdrukkelijk geen reparatie-instructie. Onze test toont de scheiding tussen framework en plugincompiler aan, geen concrete API-breuk door de oktober-update. De gemeten 362 ms beschrijven alleen deze ene test, geen algemene laadtijd.
Zoek in het echte log, in de console of in oxide/logs eerst de naam van het betreffende bestand en de eerste compilerdiagnose. Een latere melding dat de plugin niet geladen kon worden, herhaalt vaak alleen het resultaat. Controleer of meerdere plugins exact hetzelfde ontbrekende symbool noemen: dan kan het om een gemeenschappelijke API-wijziging of referentie gaan in plaats van om meerdere losse defecten.
Download een update uitsluitend via de gedocumenteerde bron van de plugin. Lees de wijzigingsnotities: lossen ze jouw probleem op, vereisen ze een nieuwe afhankelijkheid of wijzigen ze het gegevensformaat? Een hoger versienummer alleen garandeert geen compatibiliteit met jouw combinatie.
Minimale reparatie
Maak een back-up van het bestaande .cs-bestand en de bijbehorende config en data. Vervang eerst alleen de betreffende plugin door de bedoelde gecorrigeerde versie. Oxide houdt wijzigingen in de pluginmap normaal gesproken in de gaten; vermijd daarom dubbele uploads en haastige extra reloads. Volg het proces in de console en controleer daarna welke versie daadwerkelijk actief is.
Als een gerichte reload nodig is, ziet de opdracht er zo uit:
oxide.reload Pluginname
Pluginname staat hier voor de werkelijke bestandsnaam van de plugin zonder .cs, niet voor de marketingtitel van een download. De officiële commandoreferentie documenteert deze gerichte reload. Gebruik tijdens het afbakenen van het probleem geen wildcard-reload van alle plugins. Die verandert onnodig veel statussen en kan nieuwe fouten veroorzaken.
Succes: de compilerdiagnose verdwijnt, de verwachte pluginversie wordt geladen en de concreet getroffen functie doorstaat de test. Weg terug: als de update mislukt, bewaar dan ook dit nieuwe log. Herstel de oude pluginversie met de bijbehorende data alleen als die combinatie bij de huidige game past. Een oud bestand dat na de game-update al kapot was, is geen werkende rollback.
Is er geen compatibele fix, dan kan het zinvol zijn om uitsluitend de betreffende plugin tijdelijk uit te schakelen. Controleer vooraf welke andere plugins en spelregels ervan afhankelijk zijn. Verplaats het veiliggestelde bronbestand, terwijl de server netjes is gestopt, uit de bewaakte pluginmap naar een aparte back-upmap. Verwijder daarbij geen config of gebruikersdata. Noteer welke functie tot aan de reparatie ontbreekt.
Geval C: er ontbreekt een afhankelijkheid
Typische situatie: een plugin noemt een ontbrekende vereiste. Andere functies blijven werken, of meerdere uitgevallen plugins zijn afhankelijk van dezelfde bibliotheek. Het ontbrekende bestand kan zelfs aanwezig zijn, maar zelf niet laden.
De Oxide-richtlijn over afhankelijkheden maakt onderscheid tussen optionele, vereiste en harde afhankelijkheden. Een optionele integratie breidt het gedrag uit. Een vereiste afhankelijkheid is nodig voor de functie. Een harde afhankelijkheid kan het compileren al verhinderen. Deze begrippen verklaren waarom “afhankelijkheid ontbreekt” en “compilerfout” elkaar kunnen overlappen.
Eigen test C: een ontbrekende afhankelijkheid
Op dezelfde testserver laadden we onze eigen testplugin Guide7Consumer.cs met de gedeclareerde vereiste // Requires: Guide7Dependency. De bijbehorende afhankelijkheid was aanvankelijk opzettelijk niet geïnstalleerd. Dit is de echte uitvoer van de gecontroleerde test:
Guide7Consumer plugin requires missing dependency: Guide7Dependency
Ignored unexpected plugin compilation failure: Guide7Consumer
Error while compiling Guide7Consumer: Missing dependency: Guide7Dependency
Ook hier staat “Error while compiling”. De doorslaggevende toevoeging is echter de uitdrukkelijk genoemde ontbrekende afhankelijkheid. We installeerden uitsluitend Guide7Dependency.cs en herlaadden daarna gericht de afhankelijke plugin. Vervolgens verschenen beide initialisatiemarkers en beide laadbevestigingen:
[Guide7Dependency] GUIDE7_DEPENDENCY_READY
Loaded plugin Guide7Dependency v1.0.0 by Guide7 isolated test fixture
[Guide7Consumer] GUIDE7_CONSUMER_READY
Loaded plugin Guide7Consumer v1.0.0 by Guide7 isolated test fixture
De markers tonen de initialisatie van beide testplugins aan, geen test van shop-, teleport- of beschermingsfuncties van een plugin van derden. Als weg terug zou bij deze test na het ontladen van de afhankelijke plugin alleen onze eigen afhankelijkheid worden verwijderd. De afhankelijke plugin steeds opnieuw laden installeert de vereiste niet. Mislukt in jouw echte log eerst de afhankelijkheid zelf, los dan eerst de eerste fout daarvan op. Een bibliotheek met een vergelijkbare naam uit een willekeurige downloadbron is geen vervanging.
Controleer op de pluginpagina en in de documentatie de exacte naam, het type afhankelijkheid en eventueel vereiste versies. Een extra .cs-plugin en een gecompileerde extensie zijn verschillende dingen. Ze kunnen verschillende installatielocaties en herstartvereisten hebben. Volg voor extensies hun eigen installatiehandleiding; kopieer een DLL niet op goed geluk naar oxide/plugins.
Minimale reparatie
Maak een korte keten: betreffende plugin → benodigde vereiste → status van die vereiste. Controleer de vereiste in de pluginlijst en in het opstartlog. Ontbreekt die echt, installeer dan precies die vereiste vanuit de officiële bron. Is ze al aanwezig, los dan de eerste fout ervan op in plaats van hetzelfde bestand steeds opnieuw te uploaden.
Bij een gewone pluginafhankelijkheid kun je daarna gericht eerst de vereiste en dan de afhankelijke plugin laden, mits de documentatie deze volgorde ondersteunt. Bij een extensie of een gewijzigde opstartinitialisatie kan een gecontroleerde herstart nodig zijn. Behandel een herstart als een controleerbare stap met een nieuw log, niet als automatisch wondermiddel.
Succes: de vereiste en de afhankelijke plugin laden in de bedoelde versies en de functie die beide verbindt, werkt. Een lijst met twee geladen plugins is daarvoor niet genoeg. Weg terug: herstel de veiliggestelde compatibele combinatie of schakel de afhankelijke plugin uit zolang de vereiste ontbreekt. Controleer vóór een downgrade of de nieuwe versie configs of data al heeft herschreven.
Geladen, maar zonder functie
Als een plugin als geladen wordt weergegeven, stap dan over van installatiediagnose naar een functietest. Controleer eerst of je de juiste functie met het juiste account test. Een admin kan andere rechten hebben dan een gewone speler. Het resultaat van één poging als admin geldt daarom niet automatisch voor alle spelers.
Controleer daarna de gedocumenteerde rechten en instellingen. Zijn de benodigde functie, wereld, zone of gebruikersgroep vrijgegeven? Zijn er voorwaarden zoals een cooldown, een gevechtsstatus of een vereiste in de game? Deze voorbeelden zijn mogelijke controlepunten, geen bewering over elke plugin. Doorslaggevend is de documentatie van precies jouw uitbreiding.
Een geslaagde start bewijst bovendien niet dat elke hook werkt. Een hook is een door het framework aangeboden koppeling aan een game-event. Wordt zo'n interface gewijzigd, dan kan een plugin gewoon laden en pas bij het betreffende event vastlopen of niet meer reageren. Herhaal daarom de eigenlijke trigger en bekijk de log precies op dat moment.
Bewaar bij een runtime-exception de volledige relevante stacktrace en noteer wat er vlak daarvoor gebeurde. Veel permissies wijzigen “om te testen” is geen goed alternatief: daarmee kun je toegang uitbreiden en de oorspronkelijke fout verdoezelen. Voor een zuivere vergelijking gebruik je een vast account en gedocumenteerde rechten.
Waarom configs verwijderen zelden de juiste eerste stap is
Een configuratiebestand kan inderdaad fouten bevatten. Aanwijzingen zijn bijvoorbeeld een expliciet gemelde JSON-parsefout of een fout die direct bij het inlezen van een instelling optreedt. Een compilerfout over een ontbrekende gamemethode los je daarentegen niet op door alle configs te resetten.
De Oxide-handleiding over configuraties waarschuwt ook voor plugins die bij het unloaden instellingen terugschrijven. Een wijziging terwijl de plugin actief is, kan dan worden overschreven. Maak een back-up van het bestand, volg de handleiding van de plugin en unload de plugin zo nodig voordat je gaat bewerken.
Controleer JSON eerst lokaal met een geschikte validator. Vertrouwelijke waarden zoals inloggegevens of webhookadressen horen niet thuis in openbare online validators. Geldige JSON is echter alleen een syntaxcontrole: een netjes geschreven veld kan toch een ongeldige waarde of een verouderd schema bevatten.
Heb je een verse config nodig om te vergelijken, werk dan zo mogelijk in een geïsoleerde kopie. Bewaar het originele bestand ongewijzigd. Vergelijk daarna afzonderlijke instellingen en neem alleen wijzigingen over die je kunt verklaren. Een volledige reset kan regels, prijzen, verwijzingen naar permissies of andere pluginafhankelijke instellingen veranderen, zonder dat dit bij de eerste functietest opvalt.
Geen wipe als pluginreparatie
Een wipe heeft betrekking op de spelstand of op geselecteerde voortgangsgegevens. Een compilerfout in een plugin heeft betrekking op code en de vereisten daarvan. Dat zijn verschillende niveaus. Een nieuwe wereld maakt een verwijderde API-methode niet opnieuw beschikbaar en installeert geen ontbrekende library.
Dat een fout op een wipedag optreedt, bewijst geen verband met beschadigde wereldgegevens. Game-update, framework-update, plugin-update en wipe vinden vaak in dezelfde onderhoudsronde plaats. Houd deze gebeurtenissen in je tijdlijn uit elkaar. Controleer ook of na de herstart een andere serveridentiteit of een andere datamap is gebruikt.
Vermoed je echt een probleem met de wereld of de gegevens, dan is dat een aparte diagnose met een eigen back-up en een eigen succescriterium. Voer die niet terloops uit als laatste stap van een pluginreparatie. Voordat je een oudere back-up terugzet, moet duidelijk zijn welke sindsdien opgebouwde voortgang verloren zou gaan en of die stand überhaupt compatibel is.
Carbon: dezelfde diagnoselogica, een eigen installatieweg
Gebruikt je server Carbon, begin dan met de versiecontrole daarvan:
c.version
De Carbon-configuratie en de officiële release notes documenteren de eigen functies en versie-informatie van Carbon. Gebruik de commando's en paden van je daadwerkelijke Carbon-installatie. Een mislukt Oxide-commando alleen bewijst daar niet dat het framework niet werkt.
De basisvragen blijven hetzelfde: draait het framework? Welke extensies zijn daadwerkelijk geladen? Faalt één afzonderlijke plugin of een gedeelde vereiste? Welke functie is echt getest? Daaruit volgt echter niet dat elke Oxide-plugin ongewijzigd onder elke Carbon-versie werkt of dat overstappen naar een ander framework een risicoloze snelle oplossing is.
Wissel tijdens het afbakenen van het probleem niet tussendoor van Oxide naar Carbon of andersom. Een migratie verandert meerdere voorwaarden tegelijk. Plan die apart, maak een back-up van gegevens en permissies en test de plugins die je nodig hebt. Bij één compilerfout is de kleinste passende wijziging meestal beter te herleiden dan een volledige platformwissel.
Drie gevallen direct vergeleken
| Geval | Doorslaggevende bevinding |
Kleinste zinvolle ingreep |
Wat expliciet blijft |
Bewijs achteraf |
|---|---|---|---|---|
| Framework ontbreekt of past niet | Start van framework niet bevestigd; veel functies getroffen |
Passende frameworkversie correct installeren na de game-update |
Wereld, pluginconfigs en gebruikersdata |
Versie, startlog, pluginlijst, functie |
| Afzonderlijke plugin compileert niet | Framework draait; eerste diagnose noemt deze plugin |
Compatibele pluginversie plaatsen of de plugin geïsoleerd uitschakelen |
Andere plugins en geback-upte data |
Compileren, laden en functie apart controleren |
| Dependency ontbreekt | Afhankelijke plugin noemt vereiste; die ontbreekt of faalt |
Vereiste repareren, daarna afhankelijke plugin controleren |
Niet-betrokken extensies |
Dependency en gezamenlijke functie werken |
Deze vergelijking toont het diagnoseverloop, geen gemeten reparatietijden. Niet elke fout past eenduidig in één rij. Een ontbrekend DLL-referentiedoel kan bijvoorbeeld een compilerfout veroorzaken. Deel in op basis van de eerste aangetoonde oorzaak, niet op basis van de laatste rode melding.
Zo controleer je de reparatie grondig
Bepaal vóór de wijziging een kleine test die de oorspronkelijke storing zichtbaar maakt. Bij een kit-plugin is dat bijvoorbeeld een gedocumenteerde aanvraag met een daarvoor bestemd testaccount en een bekende testkit. Bij een beveiligingsplugin controleer je de eerder toegezegde bescherming onder gecontroleerde omstandigheden. Gebruik daarvoor geen bouwwerken van anderen of echte economische waarden.
Vergelijk daarna dezelfde test vóór en na precies één wijziging. Noteer accounttype, relevante rechten, pluginversie, instellingen, handeling en resultaat. Controleer ook een aangrenzende functie die niet kapot was. Zo merk je het wanneer een reparatie weliswaar het zichtbare probleem oplost, maar een andere belangrijke regel verandert.
Een zinvolle afronding omvat vijf vragen:
- Reageert het verwachte framework vanuit de juiste serverinstantie?
- Komen de daadwerkelijk geladen pluginversies overeen met de beoogde stand?
- Is de eerste fout uit de nieuwe log verdwenen, zonder dat er een andere is ontstaan?
- Werkt de concrete toepassing met het juiste gebruikersaccount?
- Blijft het resultaat behouden na de volgende geplande, gecontroleerde start?
Het laatste punt controleert vooral de installatievolgorde en de automatische start. Forceer daarvoor niet onnodig nog een herstart terwijl er gespeeld wordt. Staat dit bewijs nog open, documenteer de reparatie dan als functioneel getest met openstaand startbewijs.
Een nuttig foutrapport
Stuur geen verzameling ongeordende screenshots. Een kort, reproduceerbaar rapport maakt het afbakenen sneller. De Oxide-richtlijnen voor het melden van problemen raden aan om omgevingsgegevens, stappen, verwacht en werkelijk resultaat en relevante logs te vermelden.
Getroffen functie:
Eerste waargenomen fout met datum en tijdzone:
Rust-versie en releasebranch:
Framework en daadwerkelijk uitgelezen versie:
Pluginnaam, versie en downloadbron:
Benodigde dependency's en hun status:
Laatste wijziging vóór de fout:
Eerste volledige foutmelding:
Stappen om het na te bootsen:
Verwacht resultaat / werkelijk resultaat:
Al geprobeerde afzonderlijke wijziging en resultaat:
Beschikbare back-up en terugvalroute:
Verwijder wachtwoorden, tokens, webhookadressen en niet-noodzakelijke persoonsgegevens uit de kopie. Bewaar het ongewijzigde origineel beveiligd voor jezelf. Een opgeschoonde logkopie moet de technische oorzaak behouden: verwijder niet per ongeluk de bestandsnaam van de plugin of de foutmelding die voor de diagnose nodig is.
Richt je vraag aan de juiste partij. Bij een verkeerde installatievolgorde of een framework dat niet te selecteren is, kan de hostingsupport helpen. Bij een reproduceerbare fout in één afzonderlijke plugin is de ontwikkelaar daarvan vaak het juiste aanspreekpunt. Zijn meerdere niveaus onduidelijk, stuur dan je bevindingen in plaats van voorbarig iemand de schuld te geven.
Vóór de volgende Rust-update
Houd een kleine inventaris bij van je kritieke plugins en afhankelijkheden. Noteer welke spelregels zonder die plugins niet gelden en welke functies alleen voor gemak zorgen. Zo kun je na een update eerst controleren wat voor jullie community het belangrijkst is, in plaats van alfabetisch elke uitbreiding af te gaan.
Maak vóór geplande wijzigingen een back-up van een herleidbare staat en bewaar de bijbehorende versie-informatie. Bekijk de actuele mededelingen van het frameworkproject en van de belangrijkste pluginontwikkelaars. Reken niet op een vaste wachttijd: een release kan snel verschijnen, maar een bepaalde plugin kan nog steeds een aanpassing nodig hebben.
Controleer ook wat je startscript of provider automatisch doet. Werkt het Rust, het framework, allebei of geen van beide bij? In welke volgorde? De ene host doet dit bij elke start, de andere via een aparte updatefunctie. De handleiding van een ander panel beschrijft niet automatisch jouw server.
Voor grotere community's loont een aparte testprocedure met bekende testdata. Een test moet dezelfde relevante versies en instellingen gebruiken, anders zegt het slagen ervan maar weinig. Documenteer de grenzen van je test, in plaats van op basis van een lege testserver algemene beloftes over stabiliteit te doen.
FAQ
Moet ik na elke plugin-update de hele server herstarten?
Niet per se. Oxide ondersteunt het automatisch herkennen van pluginwijzigingen en het gericht herladen van plugins. Frameworkbestanden, extensions en bepaalde initialisatieprocessen kunnen daarentegen wel een herstart vereisen. Doorslaggevend is de documentatie van het betreffende onderdeel. Controleer na een reload de log en de functie; alleen een geaccepteerd commando is niet genoeg.
Alle plugins ontbreken. Ligt het dan zeker aan Oxide?
Nee. Het is een sterke aanwijzing, maar controleer de consolecontext, de volledige start, de frameworkkeuze, de serverinstantie en gedeelde afhankelijkheden. Ook een verkeerde datamap of meerdere plugins met dezelfde vereiste kunnen op een totale uitval lijken. Pas de combinatie van bevindingen bakent de fout betrouwbaar af.
Helpt een herstart zodra er een nieuw framework is verschenen?
Alleen als je installatieproces dat framework daarbij ook echt installeert of als je het vooraf correct hebt bijgewerkt. Bij selfhosting is een herstart op zich geen download. Vergelijk de daarna ingelezen frameworkversie met de beoogde versie. Blijft die ongewijzigd, onderzoek dan de updateroute.
Kan ik de config verwijderen en opnieuw laten aanmaken?
Een nieuwe config kan in een beveiligde testkopie helpen bij het vergelijken. Als algemene reparatie is dat ongeschikt en het kan je eigen regels terugzetten. Zoek eerst naar een concrete configuratiefout. Maak een back-up van het origineel en de data, en let erop of de plugin bij het ontladen instellingen terugschrijft.
Waarom blijft een plugin na de update als geladen zichtbaar, maar werkt hij niet?
Laden is maar één stap. De concrete functie kan stuklopen op rechten, instellingen, een afhankelijkheid die pas later nodig is of een gewijzigde hook. Test de trigger onder gecontroleerde omstandigheden en lees de log van hetzelfde moment. Beweer niet alleen op basis van de vermelding in de lijst dat de functie gerepareerd is.
Hoelang moet ik wachten op Oxide of een pluginfix?
Een vaste duur valt niet serieus te beloven. Controleer het actuele releasekanaal en de status van de betreffende plugin. Is een kritieke beveiliging niet beschikbaar, beslis dan in welke veilige toestand je de server laat draaien, in plaats van op een geschat tijdstip te vertrouwen.
Mag ik gewoon teruggaan naar een oudere versie?
Alleen met een geteste compatibele combinatie en een veilige terugweg. Een oud framework met een nieuwe Rust-versie kan opnieuw misgaan. Een nieuwe pluginversie kan data hebben gewijzigd die de oude versie niet begrijpt. Maak daarnaast een back-up van de huidige staat en controleer of de data compatibel zijn voordat je terugzet.
Begrippen die vaak in de log opduiken
Framework: basis voor de uitbreidingen, zoals Oxide of Carbon. Plugin: afzonderlijke uitbreiding met een bepaalde functie. Compiler: zet de broncode van een plugin om in uitvoerbare code. Afhankelijkheid: een ander onderdeel dat een uitbreiding nodig heeft. Extension: aanvullende framework-uitbreiding, vaak een gecompileerde bibliotheek met een eigen installatieroute. Hook: koppeling aan een gebeurtenis in het spel. RCON: geautoriseerde externe toegang tot de serverconsole. Rollback: gecontroleerd herstel van een eerdere, onderling passende staat. Wipe: het resetten van geselecteerde speelgegevens; geen algemene pluginreparatie.
Je zinvolste volgende stap op de getroffen server is klein: maak een kopie van de huidige startlog, controleer welk framework er werkelijk draait en volg de eerste foutmelding. Pas daarna beslis je welk afzonderlijk onderdeel gewijzigd moet worden.
Bronnen en teststatus
- Oxide.Rust-releases op GitHub: actuele release 2.0.7894 van 6 november 2026 voor Rust 2636.290.1; historische tests met release 2.0.7839 van 22 oktober 2026 en release 2.0.7072 van 19 februari 2026.
- uMod-changelog voor Rust: vermeldingen uit oktober, inclusief de update van 22 oktober 2026.
- Oxide-documentatie: plugininstallatie,
oxide/logs, commando's, configuratie, afhankelijkheden en foutmeldingen. - Facepunch-handleiding voor de dedicated server: SteamCMD, app-ID 258550 en Oxide na game-updates.
- Carbon-documentatie: versiecommando en configuratie.
Teststatus: release-informatie gecontroleerd op 6 november 2026; geen nieuwe functietest met Oxide.Rust 2.0.7894. De drie fouttests zijn op 29 oktober 2026 uitgevoerd op een eigen, geïsoleerde testserver met Rust-protocol 2635.289.1 en Oxide.Rust 2.0.7839; de testserver is daarna verwijderd. De versienummers van deze historische tests zijn na verdere Rust-updates nog slechts een voorbeeld.