Pluginy i mody rozszerzają wiele gier, ale często przestają działać po aktualizacji gry albo gdy brakuje jakiegoś pliku. Poniższe sekcje omawiają typowe komunikaty z CS2 z CounterStrikeSharp, Valheim z BepInEx, Conan Exiles, SCP: Secret Laboratory, Project Zomboid i The Forest, a także ogólne błędy pluginów .NET. Każda sekcja pokazuje komunikat, wyjaśnia go i podaje kolejne kroki.

Pełny komunikat znajdziesz w Konsola oraz w plikach logów gry w zakładce Pliki. Wiele błędów składa się z kilku linii. Stacktrace pod nimi, czyli lista wywołanych części programu, często wskazuje dany plugin; wyjątek (exception) to błąd programu zgłaszany przez .NET lub Unity. Zanim wymienisz pluginy, mody lub pliki konfiguracyjne, utwórz kopię zapasową w zakładce Kopie zapasowe.

„Missing required weapons definition file”: plugin skinów CS2 nie znajduje pliku weapons.json

Tak wygląda komunikat:

System.InvalidOperationException: Missing required weapons definition file: <Folder-pluginu>/weapons.json

Co się za tym kryje: Pluginy skinów do CS2 potrzebują listy wszystkich broni i ich identyfikatorów. Znajduje się ona w obowiązkowym pliku weapons.json w folderze danych pluginu. Jeśli tego pliku brakuje, plugin nie może się zainicjalizować, czyli w ogóle się nie uruchamia: funkcja skinów przestaje całkowicie działać. Dzieje się tak na przykład wtedy, gdy podczas wgrywania przesłano tylko plik programu pluginu, a nie cały pakiet.

Jak to naprawić:

  1. Przeczytaj ścieżkę w komunikacie. Pokazuje ona, w którym folderze plugin oczekuje pliku.
  2. Pobierz ponownie plugin w tej samej wersji i zainstaluj go od nowa w całości, ze wszystkimi folderami z pakietu.
  3. Możesz też skopiować weapons.json z pakietu tej samej wersji pluginu do wskazanego folderu w zakładce Pliki. Nie używaj pliku z innej wersji.
  4. Uruchom ponownie serwer i sprawdź w Konsoli, czy plugin ładuje się bez błędów.

Warto wiedzieć: Więcej o pluginach do CS2: Pluginy do CS2: MetaMod, CounterStrikeSharp i MatchZy.

„Method … not found in gamedata.json”: WeaponPaints nie może się uruchomić

Tak wygląda komunikat:

Method CAttributeList_SetOrAddAttributeValueByName not found in gamedata.json

Co się za tym kryje: WeaponPaints odnajduje określone funkcje w programie CS2 za pomocą sygnatur, czyli cech rozpoznawczych zapisanych w pliku gamedata.json. Po aktualizacji CS2 jedna z tych sygnatur przestaje się zgadzać i plugin nie znajduje funkcji. Wtedy nie może się uruchomić. Nie wynika to z Twoich ustawień, tylko z tego, że gra i plugin przestały do siebie pasować.

Jak to naprawić:

  1. Sprawdź, czy CS2 dostał niedawno aktualizację. To najczęstsza przyczyna.
  2. Zaktualizuj jednocześnie CounterStrikeSharp i WeaponPaints do najnowszej wersji i przy okazji wgraj aktualny plik gamedata.json z WeaponPaints.
  3. Jeśli dostosowana wersja jeszcze nie istnieje, tymczasowo usuń WeaponPaints, dopóki autor jej nie wyda.
  4. Uruchom ponownie serwer i sprawdź, czy komunikat zniknął.

Warto wiedzieć: Po dużych aktualizacjach CS2 czasem mija trochę czasu, zanim autorzy pluginów opublikują dostosowane wersje. Więcej o aktualizacjach gry: Aktualizacja serwera CS2: jak rozpoznać build drift i bezpiecznie zrestartować serwer.

„PreLogin failure”: Conan Exiles odrzuca niezgodną listę modów

Tak wygląda komunikat:

[<Data>-<Godzina>][<No.>]LogNet: PreLogin failure: <Mod A> (<ID-Workshop>), <Mod B> (<ID-Workshop>), <Mod C> (<ID-Workshop>).

Co się za tym kryje: Gracz próbował dołączyć i został odrzucony, ponieważ jego aktywne mody nie zgadzają się dokładnie z listą modów Twojego serwera. Ważne: mody w tej linii to wymagana lista serwera, a nie błędne mody gracza. Jakie mody gracz ma faktycznie aktywne, nie widać w logu. Conan Exiles wymaga dokładnej zgodności, brakujący mod blokuje tak samo jak dodatkowy. Gracz nie widzi żadnego powodu: jego gra zatrzymuje się na „Próba dołączenia do gry”. Wygląda to jak przekroczenie limitu czasu, ale w rzeczywistości jest to natychmiastowe odrzucenie.

Jak to naprawić:

  1. Porównaj listę z logu z modami, które gracz włączył w launcherze Conana. Zestaw musi być identyczny, bez dodatków.
  2. Gdy gracz wyłączy każdy mod, którego nie ma na liście, i włączy brakujące, znów będzie mógł się połączyć.
  3. Jeśli dodatkowy mod ma być dozwolony, zainstaluj go na serwerze w sekcji Mody i zrestartuj serwer.
  4. Po każdej zmianie modów na serwerze wszyscy gracze muszą dopasować swoją listę modów.

„Error invoking callback”: plugin CounterStrikeSharp zawodzi przy zdarzeniu

Tak wygląda komunikat:

<Godzina> [EROR] (cssharp:…) Error invoking callback

Co się za tym kryje: CounterStrikeSharp to platforma pluginów dla CS2. Pluginy podpinają się w niej pod zdarzenia, takie jak „gracz się łączy” czy „runda się zaczyna”; funkcja, która jest wtedy wywoływana, nazywa się callbackiem. W takim callbacku plugin wywołał błąd, tzw. wyjątek (exception). Serwer działa dalej, ale dana funkcja pluginu nie zadziałała. Który to był plugin i dlaczego, znajdziesz w stacktrace poniżej, czyli liście wywołanych części programu.

Jak to naprawić:

  1. Przeczytaj pełny stacktrace pod komunikatem. Nazwa pluginu zwykle pojawia się w nim jako część nazw klas lub jako nazwa pliku.
  2. Zaktualizuj ten plugin i CounterStrikeSharp do wersji, które do siebie pasują. Strona pluginu podaje obsługiwaną wersję CounterStrikeSharp.
  3. Uruchom ponownie cały serwer, a nie tylko plugin.
  4. Jeśli błąd nadal występuje, usuń plugin i zgłoś błąd jego autorowi.

„A parameterless default constructor …”: baza danych CS2-SimpleAdmin nie pasuje

Tak wygląda komunikat:

A parameterless default constructor or one matching signature (…) is required for CS2_SimpleAdmin.<Klasa> materialization

Co się za tym kryje: CS2-SimpleAdmin zapisuje bany, wyciszenia i historię adresów IP w bazie danych MySQL. Komunikat oznacza, że kolumny tabel nie pasują do wersji, której oczekuje plugin. Zwykle dzieje się tak po aktualizacji pluginu, której migracja bazy danych (automatyczne dostosowanie tabel) się nie wykonała, albo gdy dalej używasz bazy danych ze starszej instalacji. Funkcje administracyjne pluginu nie działają wtedy niezawodnie, ale sam serwer CS2 działa dalej.

Jak to naprawić:

  1. Zanim cokolwiek zmienisz, zabezpiecz zawartość bazy danych, na przykład przez eksport.
  2. Zaktualizuj CS2-SimpleAdmin do najnowszej wersji i uruchom serwer ponownie jeden raz, aby wykonała się migracja.
  3. Jeśli komunikat nie znika, porównaj tabele swojej bazy danych ze schematem, czyli strukturą tabel, zainstalowanej wersji pluginu.
  4. Jeśli możesz zrezygnować ze starych danych o banach, utwórz w zakładce Bazy danych nową bazę danych, wpisz jej dane dostępowe w konfiguracji pluginu i uruchom serwer ponownie.

„TypeInitializationException”: WeaponPaints się nie uruchamia

Tak wygląda komunikat:

TypeInitializationException: The type initializer for 'WeaponPaints.WeaponPaints' threw an exception.
 ---> <wewnętrzny wyjątek>: <Przyczyna>

Co się za tym kryje: Przy pierwszym użyciu WeaponPaints wykonuje statyczną procedurę startową (type initializer). Ta procedura się nie powiodła, dlatego plugin się nie uruchamia. Sam komunikat jest tylko otoczką: właściwą przyczynę podaje wewnętrzny wyjątek zaraz po nim, na przykład błędna konfiguracja, brakujący plik danych albo niepasująca zależność.

Jak to naprawić:

  1. Przeczytaj pierwszy wewnętrzny wyjątek pod tym komunikatem, zwykle poprzedzony --->.
  2. Zaktualizuj jednocześnie WeaponPaints i CounterStrikeSharp do pasujących do siebie wersji.
  3. Następnie popraw tylko to, co konkretnie wskazuje wewnętrzny wyjątek: plik konfiguracyjny, brakujący plik danych, taki jak weapons.json, albo połączenie z bazą danych. Dane dostępowe do swojej bazy danych znajdziesz w zakładce Bazy danych.
  4. Uruchom ponownie serwer i sprawdź Konsolę.

„Could not load file or assembly”: brakuje zależności pluginu .NET

Tak wygląda komunikat:

System.IO.FileNotFoundException: Could not load file or assembly '<Nazwa>, Version=<Wersja>, Culture=neutral, PublicKeyToken=<…>' or one of its dependencies. The system cannot find the file specified.
 ---> System.IO.FileNotFoundException: Could not load file or assembly '<Nazwa>, Version=<Wersja>, Culture=neutral, PublicKeyToken=null'. The system cannot find the file specified.

Co się za tym kryje: Wiele gier ładuje pluginy przez .NET, na przykład CS2 z CounterStrikeSharp, Valheim z BepInEx albo SCP: Secret Laboratory. Assembly to plik programu .NET, zwykle .dll. Komunikat oznacza, że plugin potrzebuje określonego assembly, które nie jest zainstalowane, albo wersje jego zależności do siebie nie pasują. Dany plugin nie uruchamia się wtedy wcale lub działa tylko częściowo.

Jak to naprawić:

  1. Odczytaj nazwę i wersję w cudzysłowie. To jest brakująca zależność.
  2. Sprawdź na stronie pluginu, jakie zależności i w jakich wersjach są wymagane. Często znajdują się jako dodatkowe pliki .dll w paczce do pobrania.
  3. Zainstaluj zależność w wymaganej wersji w sekcji Pliki, w folderze wskazanym na stronie pluginu.
  4. Zrestartuj serwer i sprawdź, czy komunikat zniknął.

Dobrze wiedzieć: ---> przed linią oznacza wewnętrzną przyczynę dłuższego komunikatu o błędzie. Nazwa w cudzysłowie również wtedy wskazuje brakującą zależność.

TargetInvocationException / TypeInitializationException: błąd komponentu .NET

Tak wygląda komunikat:

System.TypeInitializationException: The type initializer for '<Klasa>' threw an exception
System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation.

Co się za tym kryje: Komponent .NET, czyli plugin, mod albo część loadera, zawiódł podczas swojej procedury startowej lub w callbacku. Callback to funkcja wywoływana przy określonym zdarzeniu. Te komunikaty są tylko opakowaniem właściwego błędu: przyczynę zawiera wewnętrzny wyjątek, który pojawia się bezpośrednio po nich. Komponent, którego to dotyczy, nie działa potem wcale lub działa tylko w ograniczonym zakresie.

Jak to naprawić:

  1. Ustal, którego komponentu to dotyczy. Pomogą ci w tym nazwa klasy w cudzysłowie oraz stacktrace, czyli lista wywołań pod błędem.
  2. Zaktualizuj ten komponent oraz używany loader modów lub pluginów, na przykład BepInEx albo CounterStrikeSharp.
  3. Zrestartuj serwer i przeczytaj w logu pierwszy wewnętrzny wyjątek, zwykle poprzedzony --->. W grach na Unity pierwotny wyjątek często znajduje się bezpośrednio nad linią z Rethrow as.
  4. Usuń problem wskazany przez ten wewnętrzny wyjątek, na przykład brakujący plik albo błędne ustawienie.

„ReflectionTypeLoadException”: plugin .NET nie może załadować swoich klas

Tak wygląda komunikat:

System.Reflection.ReflectionTypeLoadException: Unable to load one or more of the requested types.
System.Exception: Unable to find plugin in assembly

Co się za tym kryje: Loader pluginów otworzył plik pluginu, ale nie mógł załadować jego klas ani znaleźć jego punktu wejścia, czyli miejsca, od którego uruchamia plugin. Albo plik pluginu nie pasuje do zainstalowanej wersji loadera lub gry, albo w folderze pluginów leży niewłaściwy plik, na przykład sama biblioteka pomocnicza zamiast właściwego pluginu. Plugin pozostaje wtedy nieaktywny.

Jak to naprawić:

  1. Zaktualizuj jednocześnie plugin i loader, tak aby oba pasowały do aktualnej wersji gry.
  2. Sprawdź w zakładce Pliki, czy właściwy plik pluginu znajduje się w folderze podanym na stronie pluginu.
  3. Usuń starsze kopie tego samego pluginu, aby ładowana była tylko jedna wersja.
  4. Uruchom ponownie serwer i sprawdź Konsolę.

Valheim: mod nie pasuje do wersji gry i nie działa

Tak wygląda komunikat:

Rethrow as TypeInitializationException: The type initializer for '<Klasa-moda>' threw an exception.

Co się za tym kryje: BepInEx, loader modów do Valheim, załadował moda, ale ten od razu się wysypał podczas inicjalizacji. Odwołuje się do czegoś w grze, czego w uruchomionej wersji Valheim nie ma lub już nie ma. Serwer mimo to startuje normalnie i można na nim w pełni grać. Mod nadal widnieje jako zainstalowany, ale nic nie robi, a w grze nie pojawia się żaden komunikat o błędzie. Najczęstszą przyczyną jest aktualizacja Valheim: serwer aktualizuje się sam przy każdym starcie, a mod zostaje w swojej wersji. Nazwę moda podaje linia powyżej.

Jak to naprawić:

  1. Zapamiętaj nazwę moda z linii nad komunikatem.
  2. Sprawdź w zakładce Mody, czy jest nowsza wersja pasująca do aktualnej wersji Valheim. Jeśli tak, zainstaluj ją i zrestartuj serwer.
  3. Jeśli nie ma pasującej wersji, na razie odinstaluj moda. W przeciwnym razie tylko zajmuje miejsce i sprawia wrażenie, że jest aktywny.
  4. Mody ważne dla twojego serwera włączaj ponownie dopiero wtedy, gdy ich autor dostosuje je do nowej wersji gry.

Więcej szczegółów: Valheim 1.0: bezpieczna aktualizacja serwera, sprawdzenie starego świata i modów

„ZRoutedRpc.Everybody”: mod do Valheim nie pasuje do wersji gry

Tak wygląda komunikat:

MissingFieldException: Field not found: .ZRoutedRpc.Everybody Due to: Using static instructions with literal field
  at ServerSync.CustomSyncedValueBase.set_BoxedValue (…)
  at AzuCraftyBoxes.AzuCraftyBoxesPlugin..cctor ()

Co się za tym kryje: ZRoutedRpc to część Valheim, przez którą serwer i gracze wymieniają się wiadomościami. Mod BepInEx został zbudowany dla innej wersji Valheim i oczekuje w niej pola Everybody, którego w zainstalowanej wersji nie ma. Mod nie może w tym miejscu wykonać swojej funkcji i nie działa wcale albo działa tylko częściowo.

Jak to naprawić:

  1. Znajdź w stacktrace, czyli liście wywołanych części programu pod komunikatem, pierwszy mod. Jeśli na początku widnieje ServerSync, szukaj dalej nazwy moda, w przykładzie AzuCraftyBoxes.
  2. Zaktualizuj go w zakładce Mody do wersji dla aktualnego buildu Valheim, czyli działającej wersji gry.
  3. Jeśli takiej wersji jeszcze nie ma, na razie odinstaluj mod i uruchom serwer ponownie.
  4. Jeśli mod działa też u innych graczy, wszyscy powinni używać tej samej wersji.

Więcej szczegółów: Valheim 1.0: bezpieczna aktualizacja serwera, stary świat i mody

SCP: Secret Laboratory: nie można załadować pluginu

Tak wygląda komunikat:

[LabApi] System.BadImageFormatException: <Szczegóły pliku pluginu>

Co się za tym kryje: LabApi to interfejs pluginów w SCP: Secret Laboratory. Nie mógł on załadować pliku pluginu, ponieważ jego format nie pasuje do wersji serwera. Zdarza się to zwykle po aktualizacji gry, gdy plugin jest jeszcze zbudowany dla poprzedniej wersji, albo gdy plik został uszkodzony podczas przesyłania. Plugin, którego to dotyczy, pozostaje nieaktywny, a serwer startuje bez niego.

Jak to naprawić:

  1. Sprawdź, czy komunikat podaje nazwę pliku pluginu.
  2. Prześlij ponownie plugin w wersji dla twojej aktualnej wersji SCP:SL i zrestartuj serwer. Obsługiwane wersje znajdziesz na stronie pluginu.
  3. Jeśli nie wiesz, o który plugin chodzi, usuń w zakładce Pliki ostatnio dodany plik z folderu pluginów i uruchom serwer ponownie.
  4. Po przesłaniu porównaj rozmiar pliku z oryginałem. Jeśli się różni, transfer był niekompletny.

Warto wiedzieć: Podstawowe informacje o serwerze znajdziesz w poradniku Jak skonfigurować serwer SCP Secret Laboratory.

Project Zomboid: mapa lub mod używa nieznanej właściwości kafelka

Tak wygląda komunikat:

IsoPropertyTypeNotFoundException: Property Name not found: <Właściwość>

Co się za tym kryje: Mapy w Project Zomboid składają się z kafelków (tiles). Każdy kafelek ma właściwości, które określają na przykład, czy coś jest pojemnikiem, drzwiami albo przeszkodą. Mapa lub mod używa tu właściwości, której Twoja wersja Project Zomboid nie zna. Obiekty, których to dotyczy, mogą zniknąć albo działać nieprawidłowo, ale serwer zwykle działa dalej. Często mapa lub mod zostały stworzone pod inną wersję gry, na przykład po przejściu na Build 42.

Jak to naprawić:

  1. Ustal, której mapy lub którego moda to dotyczy. Jeśli komunikat pojawił się niedawno, w pierwszej kolejności podejrzewaj ostatnio zainstalowany lub zaktualizowany element.
  2. Zaktualizuj mapę lub mod do wersji zgodnej z zainstalowaną wersją Project Zomboid.
  3. Jeśli problem zaczął się po aktualizacji moda, przywróć jego poprzednią kompatybilną wersję.
  4. Jeśli chcesz całkowicie usunąć mod z mapą, najpierw utwórz kopię zapasową w sekcji Kopie zapasowe. Brak mapy, z której korzysta już Twój zapis gry, może zmienić świat.

Warto wiedzieć: O przejściu na Build 42 przeczytasz w poradniku Project Zomboid Build 42 na własnym serwerze.

„Bolt is already running”: The Forest uruchamia Bolt dwukrotnie

Tak wygląda komunikat:

BoltException: Bolt is already running, you must call BoltLauncher.Shutdown() before starting a new instance of Bolt.
  at BoltCore.BeginStart (…)

Co się za tym kryje: The Forest korzysta w trybie wieloosobowym z biblioteki sieciowej Bolt. Komunikat oznacza, że serwer próbował uruchomić drugą instancję Bolt, choć pierwsza nadal działa. Może się to zdarzyć po nieudanym miękkim restarcie (soft restart), czyli ponownym uruchomieniu wewnątrz działającego programu zamiast prawdziwego restartu procesu. Nowa sesja nie może wtedy poprawnie wystartować.

Jak to naprawić:

  1. Zatrzymaj serwer w panelu i poczekaj, aż całkowicie się wyłączy.
  2. Następnie uruchom go ponownie. Świeży proces uruchamia Bolt tylko raz.
  3. Do restartu nie używaj żadnej funkcji w grze ani przeładowania w trakcie działania, tylko zawsze restartu przez panel.
  4. Aby restartować serwer regularnie, ustaw zaplanowany restart w zakładce Zadania.

Dobrze wiedzieć: Jak to zrobić, przeczytasz w poradniku Planowanie automatycznych restartów serwera.

„NetworkInformationException”: The Forest nie może odczytać kart sieciowych

Tak wygląda komunikat:

NetworkInformationException: File not found.
  at CoopDedicatedServerStarter.getMachineIp ()

Co się za tym kryje: Podczas uruchamiania serwer dedykowany The Forest próbuje ustalić swoje karty sieciowe, a tym samym własny adres IP. Interfejs systemu operacyjnego, o który przy tym pyta, nie jest dostępny w środowisku serwera. Jeśli serwer mimo to jest osiągalny, komunikat nie ma dalszych skutków.

Jak to naprawić:

  1. Sprawdź, czy serwer jest osiągalny: czy pojawia się na liście serwerów i czy gracze mogą do niego dołączyć?
  2. Jeśli tak, możesz zignorować komunikat.
  3. Jeśli nie, zaktualizuj serwer do aktualnego buildu, czyli najnowszej wersji serwera gry, i uruchom go ponownie.
  4. Jeśli nadal jest nieosiągalny, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu. Środowiska uruchomieniowego serwera nie możesz zmienić samodzielnie.

Dobrze wiedzieć: Podstawowe informacje o serwerze znajdziesz w poradniku Konfiguracja serwera The Forest.

Mod zgłasza „CS0246: nie znaleziono typu lub przestrzeni nazw”

Tak wygląda komunikat:

<Plik>.cs(<Wiersz>,<Kolumna>): error CS0246: The type or namespace name '<Type>' could not be found

Co się za tym kryje: Kompilator, który przekształca kod źródłowy C# w wykonywalne części programu, nie może znaleźć użytego typu. Nazwy nie da się odnaleźć ani w dostępnym kodzie źródłowym, ani w dołączonych bibliotekach. Przez to mod, którego to dotyczy, nie może zostać załadowany. W przypadku dostarczonych lub zmodyfikowanych plików moda kod źródłowy i biblioteki muszą pasować do wersji gry.

Jak to naprawić:

  1. Przeczytaj pełny komunikat błędu w zakładce Konsola. Podaje on plik, wiersz i brakujący typ.
  2. Zabezpiecz własne zmiany w sekcji Pliki, zanim podmienisz pliki moda.
  3. Zainstaluj wersję moda zgodną z wersją gry wraz z wymaganymi zależnościami. Jeśli używasz własnego kodu, sprawdź pisownię, przestrzeń nazw i odwołania do bibliotek.
  4. Uruchom ponownie serwer i sprawdź, czy kompilator zgłasza kolejne błędy.

RustCore nie znajduje wymaganych pól w plikach serwera Rust

Tak wygląda komunikat:

Failed to initialize plugin 'RustCore v<Wersja>' (MissingFieldException: Field not found: <Pole>)
Failed to call hook '<Hook>' on plugin 'RustCore v<Wersja>' (MissingFieldException: Field not found: <Pole>)

Co się za tym kryje: Oxide łączy Rust z zainstalowanymi pluginami. Jego główny komponent RustCore oczekuje pól, czyli wewnętrznych elementów danych, których brakuje w załadowanych bibliotekach Rust. Przez to nie udaje się jego inicjalizacja albo przetwarzanie poleceń serwera, a funkcje pluginów, których to dotyczy, przestają działać.

Jak to naprawić:

  1. Utwórz w sekcji Kopie zapasowe kopię zapasową świata i danych pluginów. Następnie całkowicie zatrzymaj serwer.
  2. Sprawdź, czy używane wydanie Oxide pasuje do wersji serwera Rust. Zaktualizuj pliki serwera Rust, a następnie zainstaluj w całości odpowiadające im wydanie Oxide.
  3. Uruchom ponownie serwer. Sprawdź w zakładce Konsola, czy RustCore teraz się ładuje i czy polecenia, których to dotyczyło, działają.
  4. Jeśli błąd nadal występuje, otwórz zgłoszenie i podaj godzinę oraz używane wersje Rust i Oxide.

DayZ nie może zastąpić przedmiotu w ekwipunku

Tak wygląda komunikat:

ReplaceItemWithNewLambdaBase Step D) ABORT - wanted to create=<Przedmiot> at loc={<Miejsce>}, but failed

Co się za tym kryje: DayZ przerywa zastępowanie przedmiotu w ekwipunku; w szczegółowym przykładzie uszkodzona część pojazdu nie może zostać utworzona w przewidzianym miejscu. Zmiana w ekwipunku, której to dotyczy, nie udaje się, ale serwer działa dalej. Krótki wiersz OnAbort to powiązany komunikat o przerwaniu; szczegółowy wiersz przed nim wskazuje krok, który się nie powiódł.

Jak to naprawić:

  1. Sprawdź w konsoli wiersze przed przerwaniem i zanotuj, który mod pojazdów lub ekwipunku jest w to zaangażowany.
  2. Utwórz kopię zapasową w sekcji Kopie zapasowe i porównaj zainstalowane mody wraz z zależnościami z informacjami o ich kompatybilności.
  3. Po odpowiedniej aktualizacji moda i pełnym restarcie ponownie przetestuj tę samą akcję w ekwipunku; jeśli błąd nie znika, zgłoś go twórcom moda, dołączając pełny log.

MatchZy: polecenie pauzy kończy się błędem przez pustą sekwencję danych

Tak wygląda komunikat:

System.InvalidOperationException: Sequence contains no elements
   at System.Linq.ThrowHelper.ThrowNoElementsException()
   at MatchZy.MatchZy.IsTacticalTimeoutActive()

Co się za tym kryje: Podczas pauzowania MatchZy sprawdza, czy aktywna jest już przerwa taktyczna. Plugin oczekuje przy tym wpisu w sekwencji danych, ale go nie znajduje. Polecenie pauzy zostaje przerwane z błędem; serwer CS2 działa dalej. Kolejne linie wywołań to tak zwany stacktrace, który pokazuje drogę do błędu.

Jak to naprawić:

  1. Przeczytaj pełny ślad błędu w Konsola. Zanotuj polecenie, które go wywołało, oraz stan gry, na przykład czy pauza była już aktywna.
  2. Zrób kopię ustawień MatchZy w Pliki. Sprawdź, czy MatchZy i CounterStrikeSharp obsługują używany build CS2, i zaktualizuj je do wzajemnie zgodnych wersji.
  3. Uruchom serwer całkowicie od nowa i ponownie przetestuj pauzę. Jeśli błąd nadal występuje, wyślij autorowi MatchZy oczyszczony ślad błędu, wersje oraz kroki prowadzące do jego wywołania.

„Unable to connect to any of the specified MySQL hosts”: plugin CS2 nie może połączyć się z bazą danych

Tak wygląda komunikat:

MySqlConnector.MySqlException (0x80004005): Unable to connect to any of the specified MySQL hosts.
   at MySqlConnector.Core.ServerSession.OpenTcpSocketAsync(...)

Co się za tym kryje: Plugin CounterStrikeSharp, na przykład do adminów, rang lub skinów, łączy się z bazą danych MySQL przez bibliotekę MySqlConnector. Żaden z wpisanych hostów nie odpowiada. Najczęściej adres lub port w konfiguracji pluginu są nieprawidłowe albo baza danych nie została jeszcze utworzona. Wszystko, co plugin zapisuje w bazie danych lub z niej odczytuje, przestaje działać; serwer CS2 działa dalej.

Jak to naprawić:

  1. Utwórz bazę danych w sekcji Bazy danych, jeśli jeszcze żadnej nie ma, i otwórz jej dane dostępowe.
  2. W sekcji Pliki otwórz plik konfiguracyjny pluginu wymienionego w stacktrace.
  3. Wpisz host, port, nazwę bazy danych, użytkownika i hasło dokładnie tak, jak podano w sekcji Bazy danych.
  4. Zrestartuj serwer i sprawdź Konsola.

Dobrze wiedzieć: Stacktrace to lista linii zaczynających się od „at”; niżej zwykle znajduje się nazwa pluginu.

„The given key … was not present”: moduł CS2 nie znajduje swojego głównego pluginu

Tak wygląda komunikat:

System.Collections.Generic.KeyNotFoundException: The given key '<plugin>:api' was not present in the dictionary.
   at CounterStrikeSharp.API.Core.Capabilities.PluginCapability`1.Get()

Co się za tym kryje: Wiele pluginów CounterStrikeSharp składa się z głównego pluginu i modułów. Podczas ładowania moduł pobiera funkcje głównego pluginu przez interfejs (Capability). Jeśli główny plugin nie jest załadowany albo nie uruchomił się poprawnie, tego interfejsu brakuje. Moduł wtedy nie działa, ale serwer działa dalej.

Jak to naprawić:

  1. Poszukaj w Konsola wyżej błędów głównego pluginu, na przykład brakującego pliku DLL („Could not load file or assembly”).
  2. Najpierw napraw ten błąd, na przykład instalując brakującą zależność.
  3. Zainstaluj główny plugin i moduły w wersjach, które według strony pluginu do siebie pasują.
  4. Zrestartuj serwer całkowicie i ponownie sprawdź Konsola.

„Assembly with same name is already loaded”: plugin CS2 występuje podwójnie

Tak wygląda komunikat:

System.IO.FileLoadException: Could not load file or assembly '<Plugin>, Version=<Wersja>, Culture=neutral, PublicKeyToken=null'. Assembly with same name is already loaded

Co się za tym kryje: CounterStrikeSharp ładuje każdy plugin z pliku DLL (assembly). Plik DLL o tej nazwie jest już załadowany, najczęściej dlatego, że ten sam plugin znajduje się w folderze pluginów dwa razy, na przykład po aktualizacji w drugim podfolderze. Druga kopia nie zostaje załadowana.

Jak to naprawić:

  1. Utwórz kopię zapasową w sekcji Kopie zapasowe.
  2. W sekcji Pliki otwórz folder addons/counterstrikesharp/plugins.
  3. Znajdź podfoldery zawierające plik DLL o podanej nazwie.
  4. Zachowaj tylko aktualną wersję i usuń pozostałe kopie.
  5. Zrestartuj serwer całkowicie.

Dobrze wiedzieć: Jeśli dwa różne pluginy zawierają plik DLL o tej samej nazwie, zapytaj ich autorów o wersje, które ze sobą współpracują.

Nie ma tu twojego komunikatu?

Przeczytaj cały komunikat w Konsola lub w pliku logu gry, łącznie z liniami powyżej. W grach opartych na .NET i Unity właściwa przyczyna często kryje się w wewnętrznym wyjątku. To, który plugin lub mod jest zaangażowany, zdradzają nazwy folderów i plików w stacktrace. Przed każdą wymianą utwórz kopię zapasową w zakładce Kopie zapasowe. Awarie i nieudane aktualizacje omawia poradnik Serwer gry ulega awarii lub aktualizacja Steam kończy się niepowodzeniem. Jeśli utkniesz, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.