Plugins en mods breiden veel games uit, maar gaan graag stuk na een game-update of als er een bestand ontbreekt. De onderstaande secties behandelen typische meldingen uit CS2 met CounterStrikeSharp, Valheim met BepInEx, Conan Exiles, SCP: Secret Laboratory, Project Zomboid en The Forest, en algemene fouten van .NET-plugins. Elke sectie toont een melding, legt die uit en noemt de volgende stappen.
De volledige melding vind je in de Console en in de logbestanden van de game onder Bestanden. Veel fouten bestaan uit meerdere regels. De stacktrace eronder, de lijst met aangeroepen programmaonderdelen, noemt vaak de betrokken plugin; een exception is een programmafout die .NET of Unity meldt. Maak onder Back-ups een back-up voordat je plugins, mods of configuratiebestanden vervangt.
“Missing required weapons definition file”: CS2-skins-plugin vindt weapons.json niet
Zo ziet de melding eruit:
System.InvalidOperationException: Missing required weapons definition file: <plugin-map>/weapons.json
Wat erachter zit: Skins-plugins voor CS2 hebben een lijst nodig van alle wapens en hun ID's. Die staat in het verplichte bestand weapons.json in de datamap van de plugin. Ontbreekt dit bestand, dan kan de plugin niet initialiseren en start hij dus helemaal niet: de skinfunctie valt volledig weg. Dit gebeurt bijvoorbeeld als bij het uploaden alleen het programmabestand van de plugin is overgezet en niet het hele pakket.
Zo los je het op:
- Lees het pad in de melding. Het laat zien in welke map de plugin het bestand verwacht.
- Download de plugin in dezelfde versie opnieuw en installeer hem volledig opnieuw, met alle mappen uit het pakket.
- Je kunt ook
weapons.jsonuit het pakket van dezelfde pluginversie via Bestanden naar de genoemde map kopiëren. Gebruik geen bestand uit een andere versie. - Herstart de server en controleer in de Console of de plugin zonder fouten laadt.
Goed om te weten: Uitgebreide informatie over CS2-plugins: CS2-plugins: MetaMod, CounterStrikeSharp en MatchZy.
“Method … not found in gamedata.json”: WeaponPaints kan niet starten
Zo ziet de melding eruit:
Method CAttributeList_SetOrAddAttributeValueByName not found in gamedata.json
Wat erachter zit: WeaponPaints vindt bepaalde functies in het CS2-programma via signaturen, oftewel herkenningskenmerken die in het bestand gamedata.json staan. Na een CS2-update klopt een van deze signaturen niet meer en vindt de plugin de functie niet. Dan kan hij niet starten. Dat ligt niet aan je instellingen, maar aan het feit dat het spel en de plugin niet meer bij elkaar passen.
Zo los je het op:
- Controleer of CS2 onlangs een update heeft gekregen. Dat is de gebruikelijke oorzaak.
- Werk CounterStrikeSharp en WeaponPaints samen bij naar de nieuwste versie en neem daarbij de actuele
gamedata.jsonvan WeaponPaints over. - Is er nog geen aangepaste versie, verwijder WeaponPaints dan tijdelijk totdat de auteur een update heeft uitgebracht.
- Herstart de server en controleer of de melding verdwenen is.
Goed om te weten: Na grote CS2-updates duurt het soms even voordat plugin-auteurs aangepaste versies publiceren. Meer over game-updates: Je CS2-server updaten: build-drift herkennen en veilig herstarten.
„PreLogin failure“: Conan Exiles weigert een afwijkende modlijst
Zo ziet de melding eruit:
[<Date>-<Time of day>][<No.>]LogNet: PreLogin failure: <Mod A> (<Workshop ID>), <Mod B> (<Workshop ID>), <Mod C> (<Workshop ID>).
Wat erachter zit: Een speler wilde meedoen en is geweigerd, omdat zijn actieve mods niet exact overeenkomen met de modlijst van jouw server. Belangrijk: de mods in die regel vormen de gewenste lijst van de server, niet de verkeerde mods van de speler. Welke mods de speler echt actief heeft, staat niet in de log. Conan Exiles eist een exacte overeenkomst: een ontbrekende mod blokkeert net zo goed als een extra mod. De speler ziet geen reden: zijn spel blijft hangen bij „Spielbeitritt wird versucht“. Dat lijkt op een time-out, maar is een directe weigering.
Zo los je het op:
- Vergelijk de lijst uit de log met de mods die de speler in de Conan-launcher heeft geactiveerd. De samenstelling moet gelijk zijn, zonder extra's.
- Als de speler elke mod uitschakelt die niet in de lijst staat en de ontbrekende mods activeert, kan hij weer verbinding maken.
- Wil je een extra mod toestaan, installeer hem dan op de server onder Mods en start de server opnieuw op.
- Na elke wijziging aan de servermods moeten alle spelers hun modlijst aanpassen.
“Error invoking callback”: CounterStrikeSharp-plugin faalt bij een gebeurtenis
Zo ziet de melding eruit:
<tijd> [EROR] (cssharp:…) Error invoking callback
Wat erachter zit: CounterStrikeSharp is een pluginplatform voor CS2. Plugins koppelen zich daar aan gebeurtenissen zoals “speler maakt verbinding” of “ronde begint”; de functie die dan wordt aangeroepen heet een callback. In zo'n callback heeft een plugin een fout veroorzaakt, een zogenaamde exception. De server blijft draaien, maar de betreffende pluginfunctie is niet gelukt. Welke plugin het was en waarom, staat in de stacktrace eronder: de lijst met aangeroepen programmaonderdelen.
Zo los je het op:
- Lees de volledige stacktrace onder de melding. De naam van de plugin staat daar meestal als onderdeel van de klassennamen of als bestandsnaam.
- Werk deze plugin en CounterStrikeSharp bij naar versies die bij elkaar passen. Op de pluginpagina staat welke CounterStrikeSharp-versie wordt ondersteund.
- Herstart de server volledig, niet alleen de plugin.
- Blijft de fout daarna optreden, verwijder dan de plugin en meld de fout bij de auteur.
“A parameterless default constructor …”: CS2-SimpleAdmin-database klopt niet
Zo ziet de melding eruit:
A parameterless default constructor or one matching signature (…) is required for CS2_SimpleAdmin.<klasse> materialization
Wat erachter zit: CS2-SimpleAdmin slaat bans, mutes en de IP-geschiedenis op in een MySQL-database. De melding betekent dat de tabelkolommen niet passen bij de versie die de plugin verwacht. Dit gebeurt meestal na een plugin-update waarbij de databasemigratie (de automatische aanpassing van de tabellen) niet is voltooid, of als een database uit een oudere installatie wordt hergebruikt. De adminfuncties van de plugin werken dan niet betrouwbaar; de CS2-server zelf blijft gewoon draaien.
Zo los je het op:
- Maak een back-up van de inhoud van de database voordat je iets wijzigt, bijvoorbeeld via een export.
- Werk CS2-SimpleAdmin bij naar de nieuwste versie en herstart de server één keer, zodat de migratie wordt uitgevoerd.
- Blijft de melding, vergelijk dan de tabellen van je database met het schema, oftewel de tabelstructuur, van de geïnstalleerde pluginversie.
- Kun je de oude bangegevens missen, maak dan via Databases een nieuwe database aan, vul de inloggegevens ervan in de configuratie van de plugin in en herstart.
“TypeInitializationException”: WeaponPaints start niet
Zo ziet de melding eruit:
TypeInitializationException: The type initializer for 'WeaponPaints.WeaponPaints' threw an exception.
---> <interne exception>: <oorzaak>
Wat erachter zit: Bij de eerste toegang voert WeaponPaints een statische opstartroutine uit (type initializer). Die is mislukt, en daarom start de plugin niet. De melding zelf is slechts de buitenkant: de eigenlijke oorzaak staat in de interne exception direct daarna, bijvoorbeeld een foutieve configuratie, een ontbrekend databestand of een afhankelijkheid die niet past.
Zo los je het op:
- Lees de eerste interne exception onder deze melding, meestal voorafgegaan door
--->. - Werk WeaponPaints en CounterStrikeSharp samen bij naar versies die bij elkaar passen.
- Corrigeer daarna alleen wat de interne exception concreet noemt: het configuratiebestand, een ontbrekend databestand zoals
weapons.jsonof de verbinding met de database. De inloggegevens van je database vind je onder Databases. - Herstart de server en controleer de Console.
„Could not load file or assembly”: afhankelijkheid van een .NET-plugin ontbreekt
Zo ziet de melding eruit:
System.IO.FileNotFoundException: Could not load file or assembly '<Naam>, Version=<Versie>, Culture=neutral, PublicKeyToken=<…>' or one of its dependencies. The system cannot find the file specified.
---> System.IO.FileNotFoundException: Could not load file or assembly '<Naam>, Version=<Versie>, Culture=neutral, PublicKeyToken=null'. The system cannot find the file specified.
Wat erachter zit: Veel games laden plugins via .NET, zoals CS2 met CounterStrikeSharp, Valheim met BepInEx of SCP: Secret Laboratory. Een assembly is een .NET-programmabestand, meestal een .dll. De melding betekent: een plugin heeft een bepaalde assembly nodig die niet geïnstalleerd is, of de versies van zijn afhankelijkheden passen niet bij elkaar. De betreffende plugin start dan niet of maar gedeeltelijk.
Zo los je het op:
- Lees de naam en de versie tussen de aanhalingstekens. Dat is de ontbrekende afhankelijkheid.
- Controleer op de pluginpagina welke afhankelijkheden in welke versie nodig zijn. Vaak zitten ze als extra
.dll-bestanden in het downloadpakket. - Installeer de afhankelijkheid in de vereiste versie onder Bestanden in de map die de pluginpagina aangeeft.
- Start de server opnieuw en controleer of de melding verdwenen is.
Goed om te weten: ---> vóór de regel markeert de onderliggende oorzaak van een langere foutmelding. Ook dan is de naam tussen de aanhalingstekens de ontbrekende afhankelijkheid.
TargetInvocationException / TypeInitializationException: .NET-component mislukt
Zo ziet de melding eruit:
System.TypeInitializationException: The type initializer for '<Class>' threw an exception
System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation.
Wat erachter zit: Een .NET-component, dus een plugin, een mod of een onderdeel van de loader, is mislukt in de startroutine of in een callback. Een callback is een functie die bij een bepaalde gebeurtenis wordt aangeroepen. Deze meldingen zijn slechts een omhulsel rond de eigenlijke fout: de direct daarna volgende innerlijke exception bevat de oorzaak. De betreffende component werkt daarna niet of maar beperkt.
Zo los je het op:
- Stel vast welke component het betreft. De klassenaam tussen de aanhalingstekens en de stacktrace, de aanroeplijst onder de fout, helpen bij het herleiden.
- Werk deze component en de gebruikte mod- of pluginloader bij, bijvoorbeeld BepInEx of CounterStrikeSharp.
- Start de server opnieuw op en lees in het log de eerste innerlijke exception, meestal ingeleid met
--->. Bij Unity-spellen staat de oorspronkelijke exception vaak direct boven een regel metRethrow as. - Los op wat deze innerlijke exception noemt, bijvoorbeeld een ontbrekend bestand of een onjuiste instelling.
“ReflectionTypeLoadException”: .NET-plugin kan zijn klassen niet laden
Zo ziet de melding eruit:
System.Reflection.ReflectionTypeLoadException: Unable to load one or more of the requested types.
System.Exception: Unable to find plugin in assembly
Wat erachter zit: De pluginloader heeft het pluginbestand geopend, maar kon de klassen ervan niet laden of het startpunt niet vinden, oftewel de plek waar hij de plugin opstart. Ofwel past het pluginbestand niet bij de geïnstalleerde loader- of gameversie, ofwel staat het verkeerde bestand in de pluginmap, bijvoorbeeld een losse hulpbibliotheek in plaats van de plugin zelf. De plugin blijft dan inactief.
Zo los je het op:
- Werk de plugin en de loader samen bij, zodat beide bij de huidige gameversie passen.
- Controleer via Bestanden of het juiste pluginbestand in de map staat die op de pluginpagina wordt aangegeven.
- Verwijder oudere kopieën van dezelfde plugin, zodat er maar één versie wordt geladen.
- Herstart de server en controleer de Console.
Valheim: mod past niet bij de spelversie en blijft zonder effect
Zo ziet de melding eruit:
Rethrow as TypeInitializationException: The type initializer for '<Mod-Class>' threw an exception.
Wat er speelt: BepInEx, de modloader voor Valheim, heeft de mod geladen, maar die is bij het initialiseren meteen gecrasht. De mod benadert iets in de game dat in de draaiende Valheim-versie niet of niet meer bestaat. De server start toch normaal op en is volledig speelbaar. De mod blijft als geïnstalleerd verschijnen, maar doet niets, en in de game verschijnt hierover geen foutmelding. De vaakst voorkomende oorzaak is een Valheim-update: de server werkt zichzelf bij elke start bij, terwijl de mod op zijn oude stand blijft. De naam van de mod staat in de regel erboven.
Zo los je het op:
- Onthoud de modnaam uit de regel boven de melding.
- Controleer onder Mods of er een nieuwere versie is die bij de actuele Valheim-versie past. Zo ja, installeer die en start de server opnieuw op.
- Is er geen passende versie, verwijder de mod dan voorlopig. Anders neemt hij alleen ruimte in en wekt hij de indruk actief te zijn.
- Mods die belangrijk zijn voor je server activeer je pas weer als de auteur ze heeft aangepast aan de nieuwe spelversie.
Uitgebreid: Valheim 1.0: serverupdate, oude wereld en mods veilig controleren
„ZRoutedRpc.Everybody”: Valheim-mod past niet bij de spelversie
Zo ziet de melding eruit:
MissingFieldException: Field not found: .ZRoutedRpc.Everybody Due to: Using static instructions with literal field
at ServerSync.CustomSyncedValueBase.set_BoxedValue (…)
at AzuCraftyBoxes.AzuCraftyBoxesPlugin..cctor ()
Wat erachter zit: ZRoutedRpc is het deel van Valheim waarmee de server en spelers berichten uitwisselen. Een BepInEx-mod is gebouwd voor een andere Valheim-versie en verwacht daar het veld Everybody, dat in de geïnstalleerde versie niet bestaat. De mod kan zijn functie op dit punt niet uitvoeren en werkt niet of maar gedeeltelijk.
Zo los je het op:
- Zoek in de stacktrace, de lijst met aangeroepen programmaonderdelen onder de melding, de eerste mod. Staat daar eerst
ServerSync, zoek dan verder naar de modnaam, in het voorbeeld AzuCraftyBoxes. - Werk de mod onder Mods bij naar een versie voor de huidige Valheim-build, dus de spelversie die nu draait.
- Bestaat die nog niet, verwijder de mod dan voorlopig en start de server opnieuw.
- Draait de mod ook bij je medespelers, dan moet iedereen dezelfde versie gebruiken.
Uitgebreid: Valheim 1.0: de server bijwerken, de oude wereld en mods veilig controleren
SCP: Secret Laboratory: plugin kan niet worden geladen
Zo ziet de melding eruit:
[LabApi] System.BadImageFormatException: <Plugin file details>
Wat erachter zit: LabApi is de pluginkoppeling van SCP: Secret Laboratory. Het kon een pluginbestand niet laden, omdat het formaat niet past bij de serverversie. Dat gebeurt meestal na een game-update, als een plugin nog voor de vorige versie is gebouwd, of als het bestand tijdens het uploaden is beschadigd. De betreffende plugin blijft inactief, de server start zonder die plugin.
Zo los je het op:
- Controleer of de melding de naam van het pluginbestand noemt.
- Upload de plugin opnieuw in een versie voor je huidige SCP:SL-versie en start de server opnieuw op. De pluginpagina vermeldt de ondersteunde versies.
- Weet je niet welke plugin het is, verwijder dan onder Bestanden het laatst toegevoegde bestand uit de pluginmap en start opnieuw op.
- Vergelijk na het uploaden de bestandsgrootte met het origineel. Wijkt die af, dan was de overdracht onvolledig.
Goed om te weten: Basisinformatie over de server vind je onder SCP Secret Laboratory-server instellen.
Project Zomboid: map of mod gebruikt een onbekende tile-eigenschap
Zo ziet de melding eruit:
IsoPropertyTypeNotFoundException: Property Name not found: <Property>
Wat erachter zit: Kaarten in Project Zomboid bestaan uit tegels (tiles). Elke tegel heeft eigenschappen die bijvoorbeeld bepalen of iets een container, een deur of een obstakel is. Een map of mod gebruikt hier een eigenschap die jouw Project Zomboid-versie niet kent. Betreffende objecten kunnen ontbreken of verkeerd werken, de server blijft meestal gewoon draaien. Vaak is de map of mod gemaakt voor een andere spelversie, bijvoorbeeld na de overstap naar Build 42.
Zo los je het op:
- Zoek uit welke map of mod het betreft. Is de melding nieuw, dan is de laatst geïnstalleerde of bijgewerkte het eerste vermoeden.
- Werk de map of mod bij naar een versie die past bij jouw geïnstalleerde Project Zomboid-versie.
- Begon het na een modupdate, zet dan de vorige compatibele versie van de mod terug.
- Wil je een map-mod helemaal verwijderen, maak dan eerst onder Back-ups een back-up aan. Ontbreekt een kaart die jouw wereld al gebruikt, dan kan dat de wereld veranderen.
Goed om te weten: Voor de overstap naar Build 42 is er Project Zomboid Build 42 op je eigen server.
„Bolt is already running”: The Forest start Bolt twee keer
Zo ziet de melding eruit:
BoltException: Bolt is already running, you must call BoltLauncher.Shutdown() before starting a new instance of Bolt.
at BoltCore.BeginStart (…)
Wat erachter zit: The Forest gebruikt voor multiplayer de netwerkbibliotheek Bolt. De melding betekent: de server probeerde een tweede Bolt-instantie te starten terwijl de eerste nog draait. Dat kan gebeuren na een mislukte soft-restart, dus een herstart binnen het draaiende programma in plaats van een echte herstart van het proces. De nieuwe sessie kan zo niet goed starten.
Zo los je het op:
- Stop de server in het panel en wacht tot hij helemaal uit is.
- Start hem daarna opnieuw. Een nieuw proces start Bolt maar één keer.
- Gebruik voor een herstart geen functie in het spel en geen herladen tijdens het draaien, maar altijd de herstart via het panel.
- Voor regelmatige herstarts stel je onder Taken een geplande herstart in.
Goed om te weten: Hoe dat werkt, lees je in Automatische herstarts voor je server plannen.
„NetworkInformationException”: The Forest kan netwerkadapters niet uitlezen
Zo ziet de melding eruit:
NetworkInformationException: File not found.
at CoopDedicatedServerStarter.getMachineIp ()
Wat erachter zit: Bij het opstarten probeert de dedicated server van The Forest zijn netwerkadapters en daarmee zijn eigen IP-adres te bepalen. De besturingssysteeminterface die hij daarvoor raadpleegt, is in de serveromgeving niet beschikbaar. Is de server toch bereikbaar, dan heeft de melding verder geen gevolgen.
Zo los je het op:
- Controleer of de server bereikbaar is: verschijnt hij in de serverlijst en kunnen spelers joinen?
- Zo ja, dan kun je de melding negeren.
- Zo niet, werk de server bij naar de huidige build, dus de nieuwste serverversie van het spel, en start hem opnieuw.
- Blijft hij onbereikbaar, open dan een ticket en vermeld het tijdstip van de melding. De opstartomgeving van de server kun je niet zelf aanpassen.
Goed om te weten: De basis over de server vind je in Een The Forest-server inrichten.
Mod meldt „CS0246: Type of namespace niet gevonden“
Zo ziet de melding eruit:
<File>.cs(<Line>,<Column>): error CS0246: The type or namespace name '<Type>' could not be found
Wat erachter zit: De compiler, die C#-broncode vertaalt naar uitvoerbare programmaonderdelen, kan een gebruikt type niet vinden. De naam kan noch in de aanwezige broncode noch via de ingebonden bibliotheken worden herleid. Daardoor kan de betreffende mod niet worden geladen. Bij meegeleverde of aangepaste modbestanden moeten broncode en bibliotheken bij de spelversie passen.
Zo los je het op:
- Lees de volledige foutmelding in de Console. Hierin staan het bestand, de regel en het ontbrekende type.
- Maak een back-up van je eigen wijzigingen onder Bestanden voordat je modbestanden vervangt.
- Installeer een versie van de betreffende mod die bij de spelversie past, inclusief de benodigde afhankelijkheden. Controleer bij eigen broncode de schrijfwijze, de namespace en de bibliotheekverwijzingen.
- Start de server opnieuw op en controleer of de compiler nog andere fouten meldt.
RustCore kan benodigde velden van de Rust-serverbestanden niet vinden
Zo ziet de melding eruit:
Failed to initialize plugin 'RustCore v<Versie>' (MissingFieldException: Field not found: <Veld>)
Failed to call hook '<Hook>' on plugin 'RustCore v<Versie>' (MissingFieldException: Field not found: <Veld>)
Wat er achter zit: Oxide verbindt Rust met de geïnstalleerde plugins. De kerncomponent RustCore verwacht velden, oftewel interne gegevensonderdelen, die in de geladen Rust-bibliotheken ontbreken. Hierdoor mislukt de initialisatie of de verwerking van serveropdrachten; getroffen pluginfuncties vallen uit.
Zo los je het op:
- Maak onder Back-ups een back-up van je wereld en plugingegevens. Stop daarna de server volledig.
- Controleer of de gebruikte Oxide-uitgave bij de Rust-serverversie hoort. Werk de Rust-serverbestanden bij en installeer daarna de bijbehorende Oxide-uitgave volledig.
- Start de server opnieuw. Controleer in de Console of RustCore nu laadt en of de getroffen opdrachten werken.
- Blijft de fout bestaan, open dan een ticket en geef de tijd en de gebruikte Rust- en Oxide-versies door.
DayZ kan een inventarisvoorwerp niet vervangen
Zo ziet de melding eruit:
ReplaceItemWithNewLambdaBase Step D) ABORT - wanted to create=<Voorwerp> at loc={<Plaats>}, but failed
Wat erachter zit: DayZ breekt het vervangen van een inventarisvoorwerp af; in het uitgebreide voorbeeld kan een beschadigd voertuigonderdeel niet op de bedoelde plek worden aangemaakt. De betreffende inventariswijziging mislukt, terwijl de server gewoon doordraait. De korte OnAbort-regel is de bijbehorende afbreekmelding; de uitgebreide regel daarvoor noemt de mislukte stap.
Zo los je het op:
- Bekijk in de console de regels vóór het afbreken en noteer welke voertuig- of inventarismod erbij betrokken is.
- Maak onder Back-ups een back-up en vergelijk de geïnstalleerde mods inclusief hun afhankelijkheden met hun compatibiliteitsgegevens.
- Test na een passende mod-update en een volledige herstart dezelfde inventarisactie opnieuw; meld een blijvende fout met het volledige log bij de ontwikkelaars van de mod.
MatchZy: pauzecommando mislukt door een lege gegevensreeks
Zo ziet de melding eruit:
System.InvalidOperationException: Sequence contains no elements
at System.Linq.ThrowHelper.ThrowNoElementsException()
at MatchZy.MatchZy.IsTacticalTimeoutActive()
Wat erachter zit: MatchZy controleert bij het pauzeren of er al een tactische time-out actief is. Daarbij verwacht de plugin een item in een gegevensreeks, maar vindt er geen. Het pauzecommando wordt met een fout afgebroken; de CS2-server blijft draaien. De volgende aanroepregels heten stacktrace en tonen de weg naar de fout.
Zo los je het op:
- Lees het volledige foutspoor in de Console. Noteer het commando dat de fout veroorzaakte en de spelstatus, bijvoorbeeld of er al een pauze actief was.
- Maak een back-up van de MatchZy-instellingen onder Bestanden. Controleer of MatchZy en CounterStrikeSharp de gebruikte CS2-build ondersteunen en werk bij naar bij elkaar passende versies.
- Start de server volledig opnieuw op en test de pauze opnieuw. Blijft de fout bestaan, stuur de auteur van MatchZy dan het opgeschoonde foutspoor, de versies en de stappen om de fout op te wekken.
„Unable to connect to any of the specified MySQL hosts“: CS2-plugin bereikt de database niet
Zo ziet de melding eruit:
MySqlConnector.MySqlException (0x80004005): Unable to connect to any of the specified MySQL hosts.
at MySqlConnector.Core.ServerSession.OpenTcpSocketAsync(...)
Wat erachter zit: Een CounterStrikeSharp-plugin, bijvoorbeeld voor admins, ranglijsten of skins, maakt via de bibliotheek MySqlConnector verbinding met een MySQL-database. Geen van de ingevoerde hosts reageert. Meestal kloppen het adres of de poort in de pluginconfiguratie niet, of er is nog geen database aangemaakt. Alles wat de plugin in de database opslaat of uitleest, valt uit; de CS2-server blijft draaien.
Zo los je het op:
- Maak onder Databases een database aan als er nog geen bestaat, en open de toegangsgegevens ervan.
- Open onder Bestanden het configuratiebestand van de plugin die in de stacktrace wordt genoemd.
- Vul host, poort, databasenaam, gebruiker en wachtwoord precies zo in als ze onder Databases staan.
- Start de server opnieuw op en controleer de Console.
Goed om te weten: De stacktrace is de lijst met „at“-regels; verderop staat meestal de naam van de plugin.
„The given key … was not present”: CS2-module vindt zijn hoofdplugin niet
Zo ziet de melding eruit:
System.Collections.Generic.KeyNotFoundException: The given key '<plugin>:api' was not present in the dictionary.
at CounterStrikeSharp.API.Core.Capabilities.PluginCapability`1.Get()
Wat erachter zit: Veel CounterStrikeSharp-plugins bestaan uit een hoofdplugin en modules. Een module haalt bij het laden via een interface (capability) de functies van de hoofdplugin op. Is de hoofdplugin niet geladen of bij het starten mislukt, dan ontbreekt deze interface. De module werkt dan niet, maar de server blijft draaien.
Zo los je het op:
- Zoek in de Console verder naar boven naar fouten van de hoofdplugin, bijvoorbeeld een ontbrekende DLL („Could not load file or assembly”).
- Los die fout eerst op, bijvoorbeeld door de ontbrekende afhankelijkheid te installeren.
- Installeer de hoofdplugin en de modules in versies die volgens de pluginpagina bij elkaar passen.
- Start de server volledig opnieuw en controleer de Console nogmaals.
„Assembly with same name is already loaded”: CS2-plugin staat er dubbel in
Zo ziet de melding eruit:
System.IO.FileLoadException: Could not load file or assembly '<Plugin>, Version=<Versie>, Culture=neutral, PublicKeyToken=null'. Assembly with same name is already loaded
Wat erachter zit: CounterStrikeSharp laadt elke plugin uit een DLL-bestand (assembly). Er is al een DLL met deze naam geladen, meestal omdat dezelfde plugin twee keer in de pluginmap staat, bijvoorbeeld na een update in een tweede submap. De tweede kopie wordt niet geladen.
Zo los je het op:
- Maak onder Back-ups een back-up.
- Open onder Bestanden de map
addons/counterstrikesharp/plugins. - Zoek submappen die een DLL met de genoemde naam bevatten.
- Houd alleen de actuele versie en verwijder de overige kopieën.
- Start de server volledig opnieuw.
Goed om te weten: Leveren twee verschillende plugins een DLL met dezelfde naam mee, vraag dan bij de makers naar versies die bij elkaar passen.
Staat je melding er niet bij?
Lees de hele melding in de Console of in het logbestand van de game, ook de regels ervoor. Bij .NET- en Unity-games zit de eigenlijke oorzaak vaak in de innerlijke exception. Welke plugin of mod erbij betrokken is, zie je aan de map- en bestandsnamen in de stacktrace. Maak vóór elke vervanging onder Back-ups een back-up. Crashes en mislukte updates behandelt Gameserver crasht of Steam-update mislukt. Kom je er niet uit, open dan een ticket en vermeld het tijdstip van de melding.