Warum sich dein CounterStrikeSharp-Plugin nicht lädt
Eine erfolgreiche Kompilierung beweist nur, dass der Code gültig ist. Ob der Server das Plugin wirklich lädt, hängt vom Server ab: von Metamod, der CounterStrikeSharp-Version, dem Ort der kopierten Dateien und davon, was das Plugin zum Laufen braucht. Gehe die Prüfungen unten der Reihe nach durch, denn die ersten sind die häufigsten.
Prüfe, ob CounterStrikeSharp selbst läuft
Bevor du dem Plugin die Schuld gibst, stelle sicher, dass das Framework lebt. Gib meta list in der Serverkonsole ein. CounterStrikeSharp muss in der Liste stehen. Fehlt es, liegt das Problem bei der Installation von Metamod oder CounterStrikeSharp und nicht bei deinem Plugin. Unsere Anleitung zur Metamod-Einrichtung behandelt diesen Teil.
meta list
Lies die Fehlermeldung in der Konsole
Wenn ein Plugin scheitert, nennt die Konsole, welches Plugin betroffen ist und warum. Ein <ERROR>-Eintrag in der Plugin-Liste bedeutet: Die Datei wurde gefunden, konnte aber nicht geladen werden. Kopiere die ganze Meldung, nicht nur die erste Zeile, denn der eigentliche Grund steht meist einige Zeilen weiter unten.
[META] Failed to load plugin addons/counterstrikesharp/bin/linuxsteamrt64/counterstrikesharp
Listing 1 plugin:
[01] <ERROR>
Der Server wurde aktualisiert und nichts geht mehr
Nach einem Update von Counter-Strike 2 müssen CounterStrikeSharp und Metamod oft ebenfalls aktualisiert werden, weil sich die Spieldateien geändert haben, in die sie eingreifen. Sind alle Plugins gleichzeitig ausgefallen, ist das die Ursache. Aktualisiere CounterStrikeSharp und Metamod auf die neuesten Versionen und starte den Server neu. Unsere Anleitung zum Aktualisieren von CounterStrikeSharp zeigt den sicheren Weg.
Sieh nach, was der Server als installiert ansieht
Führe css_plugins list in der Konsole aus. Der Befehl zeigt jedes Plugin, das das Framework gefunden hat, samt Status. Erscheint dein Plugin gar nicht, liegen die Dateien am falschen Ort oder der Ordnername passt nicht zum DLL-Namen. Erscheint es mit einem Fehler, gehe zurück zu Schritt zwei und lies die Meldung.
css_plugins list
Prüfe die Ordnerstruktur
Jedes Plugin braucht in plugins einen eigenen Ordner, und die Haupt-DLL muss exakt so heißen wie dieser Ordner. Die Dateien daneben, etwa die deps.json, gehören zusammen mit der DLL dorthin.
Kopiere nur den Plugin-Ordner, nicht dependencies
Unser Compiler legt zwei Dinge in die ZIP-Datei: den Plugin-Ordner und einen Ordner dependencies. Kopiere nur den Plugin-Ordner auf deinen Server. Der Ordner dependencies enthält Dateien, die CounterStrikeSharp bereits mitbringt, und ihr Kopieren kann Versionskonflikte auslösen.
Plugins mit schweren Frameworks oder anderer API-Version
Ein Plugin für eine ältere CounterStrikeSharp.API kann sich kompilieren lassen und auf einem neueren Server trotzdem scheitern, oder umgekehrt. Nennt die Konsole eine fehlende Methode oder einen fehlenden Typ, passen die API-Versionen nicht zusammen. Unsere Anleitung zu Versionskonflikten erklärt, welche Kompilieroption du wählen solltest. Beachte außerdem: Große Frameworks wie ASP.NET werden in einem Plugin für Spieleserver nicht unterstützt.
Was du bei einer Hilfeanfrage mitschicken solltest
Kommst du nicht weiter, frag den Plugin-Autor oder die CounterStrikeSharp-Community und gib an: die Ausgabe von meta list und css_plugins list, die vollständige Fehlermeldung aus der Konsole, die CounterStrikeSharp-Version und wie du das Plugin kompiliert hast. Mit diesen Angaben sind die meisten Probleme in einer Antwort gelöst.
War diese Anleitung hilfreich?
Barlap für die Community.
