Krótka odpowiedź: Po aktualizacji Rust najpierw sprawdź, jaki framework faktycznie działa. W przypadku Oxide pomogą oxide.version, oxide.plugins i log startowy. Jeśli brakuje tylko jednego pluginu, rozróżnij błąd kompilacji, brakującą zależność i błąd konfiguracji. Załadowane pluginy nie wykluczają błędu frameworka. Przed zmianami zabezpiecz pliki i stan gry; wipe ani usunięcie wszystkich configów nie jest sensownym pierwszym krokiem diagnostycznym.

Ten poradnik dotyczy Rust Dedicated Server w wersji PC, hostowanego samodzielnie lub u dowolnego dostawcy. Do kroków administracyjnych potrzebujesz dostępu do prawdziwej konsoli serwera lub autoryzowanego RCON, a w razie potrzeby także do plików serwera. Konto klienta w SupremeTier nie jest wymagane. Jeśli tylko grasz na danym serwerze, zacznij od następnej sekcji.

Stan na: 6 listopada 2026; własne testy błędów: 29 października 2026. Polecenia w głównej procedurze dotyczą Oxide. Carbon omawiamy osobno. Ścieżki błędów „pojedynczy plugin się nie kompiluje” i „brakuje zależności” zostały w kontrolowany sposób wywołane i naprawione na naszym własnym, odizolowanym serwerze testowym. Te testy symulują stany błędów; nie są obserwacją awarii zewnętrznego pluginu po aktualizacji. W izolacji sprawdziliśmy też celowo wymieszany stan frameworka. Pluginy się wtedy ładowały, a jednocześnie jeden z hooków frameworka zawodził. Poniższe oryginalne komunikaty pochodzą z kontrolowanych testów błędów i nie są przedstawiane jako naturalny incydent na serwerze klienta.

Jako gracz: co możesz zrobić?

Zniknięcie menu /kit nie dowodzi, że Twój ekwipunek został usunięty. Być może brakuje tylko pluginu, który udostępnia to polecenie. Najpierw zapytaj, czy innym graczom brakuje tej samej funkcji i czy problem dotyczy kilku niezależnych od siebie funkcji. Zanotuj czas, wpisane polecenie i widoczną odpowiedź. Pomocny będzie zrzut ekranu z komunikatem; przed przekazaniem możesz zakryć prywatne nazwy graczy.

Zgłoś to na przykład tak: „Od restartu około 19:00 polecenie kit nie daje żadnej odpowiedzi. Teleport też nie działa. Zwykłe budowanie działa. Przed restartem działało jedno i drugie”. Dzięki temu administracja może od razu poszukać odpowiedniego uruchomienia serwera w logach. Stwierdzenie „Wszystko zostało zwipowane” bez sprawdzenia byłoby zbyt daleko idące.

Nie instaluj przypadkowo oferowanych plików klienta jako rzekomej naprawy pluginu serwerowego. Jako gracz nie możesz ponownie załadować frameworka po stronie serwera. Jeśli brakuje funkcji ochronnych, na przykład obiecanych na tym serwerze zasad PvE, nie polegaj na nich do czasu wyjaśnienia sprawy. To administracja musi zdecydować, czy normalna gra jest bezpieczna.

Najpierw rozdziel trzy warstwy

Na potrzeby tej diagnozy zmodyfikowany serwer Rust składa się z trzech warstw. Sam Rust zapewnia świat gry i jej mechaniki. Framework, tutaj Oxide lub alternatywnie Carbon, umożliwia działanie rozszerzeń. Poszczególne pluginy odpowiadają na przykład za kity, teleport, funkcje administracyjne lub zmiany zasad gry. Niektóre pluginy wymagają kolejnych pluginów lub rozszerzeń.

Gdy brakuje niższej warstwy, wiele funkcji znajdujących się wyżej wygląda na zepsute jednocześnie. Gdy zawiedzie pojedyncze rozszerzenie, pozostałe mogą działać dalej. To rozróżnienie jest punktem wyjścia, ale jeszcze nie dowodem: kilka pluginów może potrzebować tej samej brakującej biblioteki. Z drugiej strony framework może odpowiadać, a mimo to mieć problemy przy określonych zdarzeniach w grze.

„Plik istnieje”, „skompilowany”, „załadowany” i „działa” to cztery różne stany. Plik .cs we właściwym folderze dowodzi jedynie, że znajduje się tam kod źródłowy. Kompilacja oznacza, że powstał z niego kod wykonywalny. Ładowanie obejmuje inicjalizację. Dopiero celowany test funkcji pokaże, czy oczekiwane działanie faktycznie zachodzi przy Twoich ustawieniach i uprawnieniach.

Oficjalna dokumentacja Oxide dotycząca instalacji pluginów opisuje pliki .cs, automatyczną kompilację i katalog pluginów. Nie myl tego poziomu plików z widocznym efektem w grze.

Szybka ścieżka decyzyjna

Po zakończeniu uruchamiania serwera zacznij w konsoli serwera, a nie na zwykłym czacie w grze. To pierwsze sprawdzenie nie zmienia żadnych pluginów:

oxide.version
oxide.plugins

oxide.version odczytuje wersję frameworka. oxide.plugins wyświetla listę pluginów, łącznie z nieudanymi próbami załadowania. Oficjalna lista poleceń opisuje listę pluginów i polecenia do celowanego ładowania; poradnik dla właścicieli serwerów o poleceniach wyjaśnia działanie konsoli i czatu.

Obserwacja
Pierwsza hipoteza robocza
Następne sprawdzenie
Oxide nie odpowiada, brakuje wielu funkcji
Brak frameworka, framework się nie uruchamia lub niewłaściwy kontekst konsoli
Sprawdź log startowy, faktycznie wybrany framework i instalację
Oxide odpowiada, kilka pluginów działa, jeden zawodzi
Problem z tym pluginem lub jego wymaganiami
Przeczytaj pierwszy pełny komunikat błędu i sprawdź wersję pluginu
Kilka problematycznych pluginów wskazuje tę samą zależność
Awaria wspólnej zależności
Najpierw zbadaj tę zależność
Plugin jest załadowany, brakuje tylko jednej funkcji
Uprawnienia, ustawienia, hook lub problem w czasie działania
Sprawdź konkretną funkcję w kontrolowanych warunkach
Nowe configi, inny świat lub pozornie puste dane
Możliwe, że inna instancja serwera lub inna ścieżka danych
Porównaj tożsamość serwera, parametry startowe i punkty montowania ze stanem poprzednim

Nieznane polecenie to wskazówka, a nie gotowa diagnoza. Sprawdź, czy na pewno otworzyłeś konsolę właściwego serwera, czy uruchamianie się zakończyło i czy ten serwer w ogóle korzysta z Oxide. W przypadku Carbon sam test specyficzny dla Oxide nie jest wystarczającą podstawą.

Przed każdą naprawą: zabezpiecz dowody i drogę powrotu

Dobra diagnoza zaczyna się od krótkiej inwentaryzacji. Zapisz, kiedy błąd został zauważony po raz pierwszy, jaka aktualizacja gry lub jaki restart go poprzedziły i co od tego czasu zmieniono. Zabezpiecz spójny log startowy od początku procesu do pierwszego komunikatu o błędzie. Zrzut ekranu z ostatnią czerwoną linią często nie wystarcza, bo pokazuje tylko błąd wtórny.

Oxide zapisuje błędy ładowania i kompilacji także we własnych plikach logów w folderze oxide/logs Twojej instalacji serwera. Komunikat bywa tam pełniejszy niż w widocznym fragmencie konsoli, na przykład gdy konsola pokazuje tylko ostatnie linie. Wybierz plik, którego data odpowiada danemu uruchomieniu, i zabezpiecz go razem z logiem konsoli.

Zanotuj wersję Rust lub informacje o buildzie, używaną gałąź wydania, system operacyjny, wersję frameworka i wersje problematycznych pluginów. Zachowaj informację o źródle pobrania zainstalowanych plików. „Najnowsza wersja” nie jest powtarzalnym oznaczeniem wersji: plik mógł zostać podmieniony od czasu Twojego pobrania, a skrypt startowy może pobierać inny stan, niż się spodziewasz.

Co powinna zawierać kopia zapasowa?

Zabezpiecz spójny stan danych świata i graczy, konfiguracji startowej oraz plików modów. W przypadku Oxide do inwentaryzacji należą przede wszystkim oxide/plugins, oxide/config i oxide/data; uwzględnij też dane uprawnień i własne rozszerzenia. Konkretna struktura zapisu zależy od instalacji. Sprawdź ścieżki faktycznie używane u Ciebie, zamiast bezmyślnie przyjmować katalog z przykładu.

Oddziel ustawienia od danych użytkowych. Config określa na przykład zachowanie pluginu, a jego dane mogą zawierać już przyznane nagrody, zapisane pozycje lub inne trwałe stany. Zawartość zależy od pluginu. Dlatego hurtowe wyczyszczenie oxide/data może zmienić znacznie więcej niż tylko wadliwą funkcję.

Aby uzyskać spójną kopię, skorzystaj z udokumentowanej procedury tworzenia kopii zapasowych dla swojej instalacji. Kopia wykonana podczas trwających zapisów może być niespójna. Sprawdź, czy kopia zapasowa naprawdę się zakończyła i czy można ją pobrać. Rozpakuj ją lub skontroluj w osobnym miejscu, nie nadpisując aktualnego serwera. Sama wyświetlana nazwa kopii zapasowej nie jest jeszcze sprawdzoną drogą powrotu.

Wyznacz granicę swojej zmiany

Przed ingerencją zapisz: „Podmieniam tylko ten plik pluginu” albo „Instaluję ponownie pakiet Oxide pasujący do aktualnego stanu Rust”. Do tego dochodzą zabezpieczony stary plik, nowy plik i kryterium sukcesu. Nie zmieniaj jednocześnie frameworka, kilku pluginów, configów i parametrów mapy. W przeciwnym razie nie będziesz wiedzieć, która zmiana pomogła, a która zaszkodziła.

Gdy padnie plugin odpowiedzialny za ochronę, ekonomię lub dostęp, jeszcze przed testem zdecyduj, czy serwer ma pozostać dostępny. Świat osiągalny od strony technicznej nie zawsze nadaje się do gry na obiecanych zasadach. Zapowiedz konieczną przerwę i skorzystaj ze standardowej metody zatrzymywania swojej instalacji. Powtarzane twarde przerwania nie zastąpią diagnozy.

Przypadek A: awaria frameworka

Typowa sytuacja: serwer uruchamia się po aktualizacji gry, ale brakuje wielu niezależnych od siebie funkcji pluginów. W bieżącym logu startowym nie widać poprawnego załadowania Oxide albo sprawdzenie wersji we właściwym kontekście konsoli nie zwraca wersji frameworka.

Przyczyną do sprawdzenia jest nie tylko „zbyt stary Oxide”. Aktualizacja gry może zastąpić zmodyfikowane pliki, skrypt startowy może później przywrócić pliki Vanilla, a framework mógł zostać rozpakowany do niewłaściwego katalogu serwera. W grę wchodzi też pakiet dla złego systemu operacyjnego, niepasująca gałąź gry lub niekompletne przesłanie plików.

Facepunch w poradniku o serwerze dedykowanym wyraźnie zaznacza, że aktualizacja gry może wymagać ponownej instalacji Oxide, a SteamCMD podczas uruchamiania może przywrócić pliki do stanu Vanilla. Stąd ważna kolejność: zaktualizuj grę, zainstaluj pasującą wersję frameworka, a dopiero potem uruchom serwer. Kolejna weryfikacja plików gry po instalacji frameworka może zniweczyć całą pracę.

Kolejność przy własnym hostingu

Na samodzielnie hostowanym serwerze z SteamCMD kolejność wygląda następująco. Ścieżka jest przykładowa, więc podaj rzeczywisty katalog swojego serwera:

steamcmd +force_install_dir /pfad/zum/rustserver +login anonymous +app_update 258550 validate +quit

258550 to App ID serwera Rust Dedicated Server. validate sprawdza pliki gry i przy okazji przywraca ich wersję Vanilla. Właśnie dlatego Oxide instalujesz dopiero potem: z oficjalnego wydania Oxide.Rust pobierz archiwum dla swojego systemu operacyjnego, czyli Oxide.Rust-linux.zip dla Linuksa lub Oxide.Rust.zip dla Windowsa. Rozpakuj je z zachowaniem struktury folderów do głównego katalogu serwera, czyli tam, gdzie znajduje się RustDedicated lub RustDedicated.exe, i pozwól nadpisać istniejące pliki. Dopiero wtedy uruchom serwer i sprawdź oxide.version.

Jeśli Twój skrypt startowy wywołuje SteamCMD przed każdym uruchomieniem, przy każdym restarcie ponownie zastępuje pliki Oxide. W takim przypadku instalacja Oxide również powinna znaleźć się w skrypcie startowym, między aktualizacją a uruchomieniem serwera, albo musisz usunąć ze skryptu automatyczną aktualizację. Przy hostingu zarządzanym skorzystaj zamiast tego z funkcji frameworka udostępnianej przez dostawcę.

Odróżnij aktualne wydanie od historycznej kombinacji testowej

Podczas naszego sprawdzenia wydań 6 listopada 2026 najnowszą opublikowaną wersją było oficjalne wydanie Oxide.Rust 2.0.7894. Opublikowano je 6 listopada 2026 o 10:11:56 UTC, a jego opis wskazuje pierwszy tego dnia hotfix Rusta dla 2636.290.1. Ten numer dotyczy Rusta i nie jest numerem wersji pakietu Oxide. Ta aktualizacja potwierdza fakt opublikowania wydania, a nie nasz własny test działania nowej kombinacji.

Nasze własne próby z błędami pochodzą z 29 października 2026: changelog uMod dla Rusta podaje dla aktualizacji z 22 października wersję 2635.289.1, a powiązane oficjalne wydanie Oxide.Rust 2.0.7839 opublikowano 22 października 2026 o 18:02:03 UTC. Na naszym odizolowanym serwerze testowym version i oxide.version faktycznie zgłaszały protokół Rusta 2635.289.1 oraz Oxide.Rust 2.0.7839. To historyczna kombinacja testowa, a nie trwała rekomendacja, by trzymać się tych numerów także po późniejszych aktualizacjach.

Przed faktyczną ingerencją ponownie sprawdź aktualne wydanie i wersję Rusta na swoim serwerze. Sama obecność pasującej informacji o wydaniu nie dowodzi, że Twój dostawca lub skrypt startowy już zainstalował tę wersję. Rozstrzyga dopiero wersja odczytana później z działającej instancji wraz z bieżącym logiem startowym.

Nasza próba A: błąd frameworka mimo załadowanych pluginów

Punktem wyjścia był protokół Rusta 2635.289.1 z odpowiadającym mu Oxide.Rust 2.0.7839. Po standardowym zatrzymaniu i wykonaniu kopii zapasowej naszego testowego świata wraz z katalogiem Oxide celowo wstawiliśmy, wyłącznie na odizolowanym serwerze testowym, stary plik Oxide.Rust.dll z oficjalnego wydania 2.0.7072 z 19 lutego 2026. Reszta aktualnej instalacji pozostała bez zmian. Symuluje to mieszany, niespójny stan frameworka i nie jest testem kompletnego historycznego pakietu serwera.

Zmianę zweryfikowaliśmy za pomocą SHA-256 faktycznie użytego pliku DLL. Podczas uruchamiania pojawił się taki rzeczywisty komunikat:

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)

Jednocześnie nasze pluginy testowe dotarły do znaczników inicjalizacji, a proces serwera nadal działał. To ważna różnica w stosunku do zbyt prostej reguły: problem z frameworkiem nie musi uniemożliwiać załadowania wszystkich pluginów. Poprawna lista pluginów ani działający proces nie są pełnym sprawdzeniem kompatybilności.

Komunikat wskazuje RustCore, czyli komponent frameworka, oraz nieudany dostęp do nieodnalezionego pola. Nie jest to błąd JSON w konfiguracji kitu. W tej celowo przygotowanej kombinacji przyczyną jest niespójny stan frameworka. Ten sam typ błędu przy innej nazwie może natomiast wynikać z pojedynczego pluginu, dlatego zawsze analizuj łącznie komponent, hook i kontekst.

Aby w minimalnym zakresie cofnąć zmianę, przywróciliśmy wcześniej używany, pasujący plik DLL 2.0.7839 i wykonaliśmy kontrolowany restart. Następnie oxide.version znów zwracało 2.0.7839, oxide.plugins wyświetlało wszystkie cztery nasze pluginy testowe, a zaobserwowanego wcześniej MissingFieldException nie było już w nowym dostępnym buforze konsoli. Droga powrotna do pasującego frameworka została więc sprawdzona dla tej konkretnej próby. Dla Twojego serwera produkcyjnego nie wynika z tego zalecenie, by składać pojedyncze pliki DLL z przypadkowych archiwów: użyj tam pełnej ścieżki instalacji pasującego frameworka, aby zachować spójność wersji.

W próbie celowo użyto znacznie starszego wydania. Nie twierdzimy, że każda starsza wersja zawiedzie w identyczny sposób ani że dokładnie ten obraz błędu wystąpi przy każdej październikowej aktualizacji. Awaria frameworka może też oznaczać po prostu serwer Vanilla bez załadowanego Oxide. Dlatego nadal potrzebne jest połączenie faktycznej wersji, pierwszej diagnozy z logu i testu funkcji.

Minimalna naprawa

  1. Zabezpiecz stan wyjściowy i log. Sprawdź, czy właśnie nie działa automatyczny aktualizator. Nie uruchamiaj drugiego, kolidującego procesu instalacji.
  2. Porównaj wersję Rusta, gałąź wydania, system operacyjny i przeznaczone dla nich wydanie frameworka.
  3. Zatrzymaj serwer w standardowy sposób, jeśli instalacja wymaga zmian w plikach frameworka.
  4. Skorzystaj z udokumentowanej metody instalacji. Przy własnym hostingu rozpakuj zaufane, pasujące archiwum z zachowaniem struktury katalogów do właściwej instalacji, w opisanej wyżej kolejności. Przy hostingu zarządzanym użyj jego funkcji frameworka i nie zakładaj, że menu z innych paneli wyglądają tak samo u Twojego dostawcy.
  5. Sprawdź kolejność aktualizacji i wykonaj jedno kontrolowane uruchomienie. Przeczytaj nowy log startowy.
  6. Sprawdź wersję frameworka, listę pluginów i co najmniej jedną funkcję, która wcześniej nie działała.

Sukces: oczekiwany framework odpowiada z właściwej instancji, oczekiwane pluginy się ładują, a sprawdzana funkcja działa. Droga powrotna: zachowaj stan sprzed ingerencji. Nie wgrywaj na ślepo starego pliku frameworka na nową wersję gry. Jeśli kompatybilny był tylko starszy kompletny pakiet, trzeba osobno sprawdzić możliwość jego przywrócenia, w tym format świata i kompatybilność klienta. Jeśli nie ma co do tego pewności, serwer pozostaje w kontrolowany sposób wyłączony, dopóki nie pojawi się pasująca wersja.

Przypadek B: plugin się nie kompiluje

Typowa sytuacja: Oxide odpowiada, inne pluginy się ładują, ale jeden konkretny plugin jest oznaczony jako nieudany. Log wskazuje błąd kompilatora, często z plikiem, wierszem, kolumną oraz brakującym symbolem lub metodą, która już nie pasuje.

Błąd kompilatora oznacza na początku tylko tyle, że dostępnego kodu źródłowego nie da się skompilować z użyciem dostępnych referencji. Przyczyną może być aktualizacja gry, która zmieniła używany interfejs. W grę wchodzą jednak także uszkodzone pobieranie, własne zmiany w kodzie albo brak twardej zależności. „Failed to compile” nie oznacza więc automatycznie, że „autor musi tylko wydać nową wersję”.

Własny test B: błąd kompilatora

Na naszym odizolowanym serwerze testowym z protokołem Rust 2635.289.1 i Oxide.Rust 2.0.7839 celową linię #error zawierała wyłącznie wtyczka testowa Guide7CompileBroken.cs. Załadowana wcześniej wtyczka kontrolna Guide7Probe pozostała od tego odseparowana. Rzeczywisty wynik w konsoli wyglądał tak:

Error while compiling Guide7CompileBroken: #error: 'GUIDE7_INTENTIONAL_COMPILE_FAILURE' | Line: 1, Pos: 8

W ramach minimalnej naprawy usunęliśmy tylko celowo dodaną błędną linię. Następnie konsola zgłosiła:

Guide7CompileBroken was compiled successfully in 362ms
Loaded plugin Guide7CompileBroken v1.0.0 by Guide7 isolated test fixture

Droga powrotna w tym kontrolowanym teście polega na przywróceniu niezmienionego pliku z błędem, co ponownie wywołałoby ten sam celowy błąd kompilatora. W przypadku prawdziwej wtyczki innego autora „usunięcie jakiejś linii” zdecydowanie nie jest instrukcją naprawy. Nasz test potwierdza rozdzielenie frameworka i kompilatora wtyczek, ale nie dowodzi konkretnego złamania API przez październikową aktualizację. Zaobserwowane 362 ms dotyczą tylko tego pojedynczego testu i nie opisują ogólnego czasu ładowania.

W prawdziwym logu, w konsoli lub w oxide/logs najpierw znajdź nazwę problematycznego pliku i pierwszy komunikat diagnostyczny kompilatora. Późniejsze „nie udało się załadować wtyczki” często tylko powtarza skutek. Sprawdź, czy kilka wtyczek wskazuje dokładnie ten sam brakujący symbol. Jeśli tak, problem może dotyczyć wspólnej zmiany API lub referencji, a nie kilku niezależnych usterek.

Pobieraj aktualizację wyłącznie z udokumentowanego źródła wtyczki. Przeczytaj informacje o zmianach: czy rozwiązują Twój problem, wymagają nowej zależności albo zmieniają format danych? Sam wyższy numer wersji nie gwarantuje zgodności z Twoją kombinacją.

Minimalna naprawa

Zrób kopię zapasową dotychczasowego pliku .cs oraz powiązanej konfiguracji i danych. Na początek zastąp tylko problematyczną wtyczkę przewidzianą, poprawioną wersją. Oxide zwykle monitoruje zmiany w folderze wtyczek, więc unikaj podwójnego wgrywania i nerwowych dodatkowych przeładowań. Śledź cały proces w konsoli, a potem sprawdź faktyczny stan.

Jeśli potrzebne jest przeładowanie konkretnej wtyczki, polecenie ma taką postać:

oxide.reload Pluginname

Pluginname oznacza tutaj faktyczną nazwę pliku wtyczki bez .cs, a nie marketingowy tytuł z pobierania. Oficjalna dokumentacja poleceń opisuje takie celowane przeładowanie. Podczas zawężania przyczyny nie używaj przeładowania wszystkich wtyczek za pomocą symbolu wieloznacznego. Niepotrzebnie zmienia ono stan wielu elementów i może wywołać nowe błędy.

Sukces: komunikat diagnostyczny kompilatora znika, ładuje się oczekiwana wersja wtyczki, a konkretna funkcja, której dotyczył problem, przechodzi test. Droga powrotna: jeśli aktualizacja się nie powiedzie, zachowaj również ten nowy log. Przywróć starą wersję wtyczki wraz z wymaganym stanem danych tylko wtedy, gdy ta kombinacja pasuje do aktualnej wersji gry. Stary plik, który po aktualizacji gry już nie działał, nie jest sprawnym punktem wycofania.

Jeśli nie ma zgodnej poprawki, rozsądne może być tymczasowe wyłączenie wyłącznie tej jednej wtyczki. Wcześniej sprawdź, jakie inne wtyczki i zasady gry od niej zależą. Przy prawidłowo zatrzymanym serwerze przenieś zabezpieczony plik źródłowy z monitorowanego katalogu wtyczek do osobnego folderu z kopiami. Nie usuwaj przy tym ani konfiguracji, ani danych użytkowników. Zapisz, której funkcji będzie brakować do czasu naprawy.

Przypadek C: brakuje zależności

Typowa sytuacja: wtyczka wskazuje brakujące wymaganie. Inne funkcje działają dalej albo kilka niedziałających wtyczek korzysta z tej samej biblioteki. Brakujący plik może nawet istnieć, ale sam się nie ładować.

Wytyczne Oxide dotyczące zależności rozróżniają zależności opcjonalne, wymagane i twarde. Integracja opcjonalna rozszerza działanie wtyczki. Zależność wymagana jest potrzebna do działania funkcji. Twarda zależność może uniemożliwić już samą kompilację. Te pojęcia wyjaśniają, dlaczego „brakująca zależność” i „błąd kompilatora” mogą się pokrywać.

Własny test C: brakująca zależność

Na tym samym serwerze testowym załadowaliśmy własną wtyczkę testową Guide7Consumer.cs z zadeklarowanym wymaganiem // Requires: Guide7Dependency. Powiązana zależność początkowo celowo nie była zainstalowana. Oto rzeczywisty wynik kontrolowanego testu:

Guide7Consumer plugin requires missing dependency: Guide7Dependency
Ignored unexpected plugin compilation failure: Guide7Consumer
Error while compiling Guide7Consumer: Missing dependency: Guide7Dependency

Tutaj również pojawia się „Error while compiling”. Kluczowa jest jednak dodatkowa informacja, która wprost wskazuje brakującą zależność. Zainstalowaliśmy wyłącznie Guide7Dependency.cs, a następnie przeładowaliśmy konkretnie wtyczkę zależną. Potem pojawiły się oba znaczniki inicjalizacji i oba potwierdzenia załadowania:

[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

Znaczniki potwierdzają inicjalizację obu wtyczek testowych, ale nie są testem sklepu, teleportacji ani funkcji ochrony we wtyczce innego autora. Droga powrotna w tym teście polegałaby na usunięciu naszej zależności po wyładowaniu wtyczki zależnej. Samo wielokrotne przeładowywanie wtyczki zależnej nie zainstaluje jej wymagań. Jeśli w Twoim prawdziwym logu najpierw zawodzi sama zależność, zacznij od usunięcia jej pierwszego błędu. Biblioteka o podobnej nazwie z przypadkowego źródła nie jest zamiennikiem.

Sprawdź na stronie wtyczki i w dokumentacji dokładną nazwę, rodzaj zależności oraz ewentualne wymagane wersje. Kolejna wtyczka .cs i skompilowane rozszerzenie to różne rzeczy. Mogą mieć inne miejsca instalacji i inne wymagania dotyczące restartu. W przypadku rozszerzeń korzystaj z ich własnej instrukcji instalacji i nie kopiuj pliku DLL do oxide/plugins na chybił trafił.

Minimalna naprawa

Rozpisz krótki łańcuch: problematyczna wtyczka → potrzebne wymaganie → status tego wymagania. Sprawdź wymaganie na liście wtyczek i w logu startowym. Jeśli rzeczywiście go brakuje, zainstaluj dokładnie tę pozycję z oficjalnego źródła. Jeśli już jest na serwerze, usuń jej pierwszy błąd, zamiast w kółko wgrywać ten sam plik.

W przypadku zwykłej zależności między wtyczkami możesz następnie załadować najpierw wymaganą wtyczkę, a potem wtyczkę zależną, o ile ich dokumentacja przewiduje taką kolejność. Przy rozszerzeniu lub zmienionej inicjalizacji startowej może być potrzebny kontrolowany restart. Traktuj restart jako weryfikowalny krok z nowym logiem, a nie jako automatyczne lekarstwo.

Sukces: wymagana wtyczka i wtyczka zależna ładują się w przewidzianych wersjach, a funkcja, która je łączy, działa. Sama lista dwóch załadowanych wtyczek tego nie potwierdza. Droga powrotna: przywróć zabezpieczoną, zgodną kombinację albo wyłącz wtyczkę zależną, dopóki brakuje jej wymagania. Przed obniżeniem wersji sprawdź, czy nowa wersja nie przepisała już konfiguracji lub danych.

Załadowana, ale niedziałająca

Gdy wtyczka jest widoczna jako załadowana, przejdź od diagnozy instalacji do testu funkcji. Najpierw sprawdź, czy testujesz właściwą funkcję na właściwym koncie. Administrator może mieć inne uprawnienia niż zwykły gracz. Wyniku jednej próby na koncie administratora nie można więc automatycznie odnosić do wszystkich graczy.

Następnie skontroluj udokumentowane uprawnienia i ustawienia. Czy potrzebna funkcja, świat, strefa lub grupa użytkowników są odblokowane? Czy obowiązują warunki takie jak cooldown, status walki albo wymaganie w grze? Te przykłady to możliwe obszary do sprawdzenia, a nie stwierdzenie dotyczące każdej wtyczki. Decydująca jest dokumentacja dokładnie Twojego rozszerzenia.

Udany start nie dowodzi też, że każdy hook działa. Hook to udostępniany przez framework punkt zaczepienia powiązany ze zdarzeniem w grze. Jeśli taki interfejs ulegnie zmianie, plugin może się załadować, a dopiero przy danym zdarzeniu zgłosić błąd lub przestać reagować. Dlatego powtórz właściwą czynność wyzwalającą i obserwuj log dokładnie w tym momencie.

Przy wyjątku czasu wykonania zachowaj pełny, istotny stacktrace i opis czynności, która go poprzedziła. Zmienianie wielu uprawnień „do testów” nie jest dobrym zamiennikiem: może rozszerzyć dostęp i zamaskować pierwotny błąd. Rzetelne porównanie wymaga jednego ustalonego konta i udokumentowanych uprawnień.

Dlaczego usuwanie configów rzadko jest dobrym początkiem

Plik konfiguracyjny rzeczywiście może być błędny. Wskazują na to na przykład wyraźnie zgłoszony błąd parsowania JSON albo błąd pojawiający się bezpośrednio przy wczytywaniu ustawienia. Błędu kompilatora dotyczącego brakującej metody gry nie naprawisz natomiast, resetując wszystkie configi.

Poradnik Oxide dotyczący konfiguracji ostrzega też przed pluginami, które przy wyładowywaniu zapisują ustawienia z powrotem do pliku. Zmiany wprowadzone podczas działania pluginu mogą wtedy zostać nadpisane. Zrób kopię pliku, postępuj zgodnie z instrukcją pluginu i w razie potrzeby wyładuj go przed edycją.

JSON sprawdzaj najpierw lokalnie odpowiednim walidatorem. Poufne wartości, takie jak dane dostępowe czy adresy webhooków, nie powinny trafiać do publicznych walidatorów online. Poprawny JSON oznacza jednak tylko poprawną składnię: prawidłowo zapisane pole nadal może zawierać niedozwoloną wartość lub należeć do przestarzałego schematu.

Jeśli do porównania potrzebujesz świeżego configu, pracuj w miarę możliwości na odizolowanej kopii. Oryginalny plik zachowaj bez zmian. Następnie porównuj poszczególne ustawienia i przenoś tylko te zmiany, które potrafisz uzasadnić. Pełny reset może zmienić reguły, ceny, powiązania uprawnień lub inne zależne od pluginu założenia, a pierwszy test działania wcale tego nie wykaże.

Wipe nie naprawia pluginów

Wipe dotyczy stanu gry lub wybranych danych postępu. Błąd kompilacji pluginu dotyczy kodu i jego wymagań. To dwie różne warstwy. Nowy świat nie przywróci usuniętej metody API ani nie zainstaluje brakującej biblioteki.

To, że błąd pojawił się w dniu wipe'a, nie dowodzi związku z uszkodzonymi danymi świata. Aktualizacja gry, aktualizacja frameworka, aktualizacja pluginu i wipe często odbywają się w ramach tej samej przerwy technicznej. Rozdziel te zdarzenia na swojej osi czasu. Sprawdź też, czy po restarcie nie została użyta inna tożsamość serwera lub inny katalog danych.

Jeśli naprawdę podejrzewasz problem ze światem lub danymi, potraktuj to jako osobne zadanie diagnostyczne z własną kopią zapasową i własnym kryterium sukcesu. Nie wykonuj go mimochodem jako ostatniego kroku naprawy pluginu. Przed przywróceniem starszego backupu musisz wiedzieć, jaki postęp od tamtej pory przepadnie i czy ten stan jest w ogóle kompatybilny.

Carbon: ta sama logika diagnostyki, własna ścieżka instalacji

Jeśli serwer korzysta z Carbona, zacznij od sprawdzenia jego wersji:

c.version

Konfiguracja Carbona i oficjalne informacje o wydaniach dokumentują funkcje specyficzne dla Carbona oraz informacje o wersjach. Używaj poleceń i ścieżek swojej faktycznej instalacji Carbona. Sam nieudany komunikat po poleceniu Oxide nie dowodzi tam awarii frameworka.

Podstawowe pytania pozostają takie same: czy framework działa? Które rozszerzenia są faktycznie załadowane? Czy zawodzi pojedynczy plugin zależny, czy wspólne wymaganie? Która funkcja została naprawdę sprawdzona? Nie oznacza to jednak, że każdy plugin Oxide działa bez zmian pod każdą wersją Carbona ani że zmiana frameworka jest pozbawioną ryzyka szybką naprawą.

Podczas zawężania przyczyny nie przełączaj się przy okazji między Oxide a Carbonem. Migracja zmienia jednocześnie kilka warunków. Zaplanuj ją osobno, zabezpiecz dane i uprawnienia, a potem przetestuj potrzebne pluginy. Przy pojedynczym błędzie kompilacji najmniejsza pasująca zmiana jest zwykle łatwiejsza do prześledzenia niż pełna zmiana platformy.

Trzy przypadki w bezpośrednim porównaniu

Przypadek
Rozstrzygające ustalenie
Najmniejsza sensowna ingerencja
Co na pewno zostaje bez zmian
Dowód po naprawie
Brak frameworka lub niepasujący framework
Start frameworka niepotwierdzony; problem dotyczy wielu funkcji
Prawidłowa instalacja pasującej wersji frameworka po aktualizacji gry
Świat, configi pluginów i dane użytkowników
Wersja, log startowy, lista pluginów, działanie funkcji
Pojedynczy plugin się nie kompiluje
Framework działa; pierwsza diagnoza wskazuje ten plugin
Wgranie kompatybilnej wersji pluginu lub jego odizolowane wyłączenie
Inne pluginy i zabezpieczone dane
Osobne sprawdzenie kompilacji, załadowania i działania
Brak zależności
Plugin zależny wskazuje wymaganie, którego brakuje lub które zawodzi
Naprawa wymaganego elementu, a potem sprawdzenie pluginu zależnego
Niepowiązane rozszerzenia
Zależność i wspólna funkcja działają

To zestawienie pokazuje przebieg diagnostyki, a nie zmierzone czasy napraw. Nie każdy błąd da się jednoznacznie przypisać do jednego wiersza. Brakująca referencja DLL może na przykład wywołać błąd kompilacji. Kieruj się pierwszą udokumentowaną przyczyną, a nie ostatnim czerwonym komunikatem.

Jak rzetelnie sprawdzić naprawę

Przed zmianą ustal mały test, który uwidacznia pierwotną awarię. W przypadku pluginu z kitami może to być udokumentowane odebranie znanego kitu testowego na przeznaczonym do tego koncie testowym. W przypadku pluginu ochronnego sprawdź w kontrolowanych warunkach ochronę, którą wcześniej obiecano. Nie używaj do tego cudzych budowli ani prawdziwych wartości ekonomicznych.

Następnie porównaj ten sam test przed dokładnie jedną zmianą i po niej. Zapisz typ konta, istotne uprawnienia, wersję pluginu, ustawienia, wykonaną czynność i wynik. Sprawdź też sąsiednią funkcję, która nie była zepsuta. Dzięki temu zauważysz, jeśli naprawa rozwiązała widoczny problem, ale zmieniła inną kluczową regułę.

Sensowne zakończenie obejmuje pięć pytań:

  • Czy oczekiwany framework odpowiada z właściwej instancji serwera?
  • Czy faktycznie załadowane wersje pluginów zgadzają się z zamierzonym stanem?
  • Czy pierwszy błąd zniknął z nowego logu i nie pojawił się zamiast niego inny?
  • Czy konkretny przypadek użycia działa na odpowiednim koncie użytkownika?
  • Czy wynik utrzymuje się po następnym zaplanowanym, kontrolowanym starcie?

Ostatni punkt sprawdza przede wszystkim kolejność instalacji i automatyczne uruchamianie. Nie wymuszaj w tym celu niepotrzebnie kolejnego restartu w trakcie gry. Jeśli tego dowodu jeszcze nie masz, oznacz naprawę w dokumentacji jako sprawdzoną funkcjonalnie, z otwartym potwierdzeniem startu.

Pomocne zgłoszenie błędu

Nie wysyłaj zbioru nieuporządkowanych zrzutów ekranu. Krótki, powtarzalny raport przyspiesza zawężenie problemu. Wskazówki Oxide dotyczące zgłaszania problemów zalecają podanie danych o środowisku, kroków, oczekiwanego i faktycznego wyniku oraz istotnych logów.

Funkcja, której dotyczy problem:
Pierwszy zaobserwowany błąd z datą i strefą czasową:
Wersja Rust i gałąź wydania:
Framework i faktycznie odczytana wersja:
Nazwa pluginu, wersja i źródło pobrania:
Wymagane zależności i ich status:
Ostatnia zmiana przed błędem:
Pierwszy pełny komunikat błędu:
Kroki do odtworzenia:
Oczekiwany wynik / faktyczny wynik:
Wypróbowana pojedyncza zmiana i jej wynik:
Dostępny backup i sposób wycofania zmian:

Usuń z kopii hasła, tokeny, adresy webhooków i niepotrzebne dane osobowe. Niezmieniony oryginał przechowuj u siebie w bezpiecznym miejscu. Oczyszczona kopia logu powinna zachować techniczną przyczynę: uważaj, aby przez przypadek nie usunąć nazwy pliku pluginu ani komunikatu błędu potrzebnego do diagnozy.

Kieruj zgłoszenie we właściwe miejsce. Przy błędnej kolejności instalacji lub frameworku, którego nie da się wybrać, może pomóc support hostingu. Przy powtarzalnym błędzie w pojedynczym pluginie właściwym adresatem jest często jego twórca. Jeśli niejasnych jest kilka warstw, wyślij swoje ustalenia zamiast pochopnie wskazywać winnego.

Przed następną aktualizacją Rust

Prowadź krótką listę swoich kluczowych pluginów i zależności. Zapisz, które zasady gry bez nich nie obowiązują, a które funkcje zapewniają jedynie wygodę. Dzięki temu po aktualizacji sprawdzisz najpierw to, co jest najważniejsze dla waszej społeczności, zamiast przeglądać każde rozszerzenie po kolei w porządku alfabetycznym.

Przed planowanymi zmianami zabezpiecz możliwy do odtworzenia stan serwera i zachowaj powiązane informacje o wersjach. Sprawdź aktualne komunikaty projektu frameworka i twórców najważniejszych pluginów. Nie polegaj na z góry ustalonym czasie oczekiwania: wydanie może pojawić się szybko, ale konkretny plugin nadal może wymagać dostosowania.

Sprawdź też, co automatyzuje twój skrypt startowy lub dostawca. Czy aktualizuje Rust, framework, oba te elementy, czy żaden z nich? W jakiej kolejności? Jeden hosting może robić to przy każdym uruchomieniu, inny za pomocą osobnej funkcji aktualizacji. Instrukcja do cudzego panelu nie opisuje automatycznie twojego serwera.

W przypadku większych społeczności warto przygotować oddzielną procedurę testową ze znanymi danymi testowymi. Próba musi korzystać z tych samych istotnych wersji i ustawień, w przeciwnym razie jej powodzenie ma ograniczoną wartość. Dokumentuj ograniczenia testów, zamiast wyciągać z pustego serwera testowego ogólne obietnice dotyczące stabilności.

FAQ

Czy po każdej aktualizacji pluginu muszę restartować cały serwer?

Niekoniecznie. Oxide obsługuje automatyczne wykrywanie zmian w pluginach i ich selektywne przeładowywanie. Pliki frameworka, rozszerzenia typu Extension i niektóre procesy inicjalizacji mogą natomiast wymagać restartu. Decydująca jest dokumentacja danego komponentu. Po przeładowaniu sprawdź log i działanie funkcji; samo przyjęcie polecenia nie wystarczy.

Brakuje wszystkich pluginów. Czy to na pewno wina Oxide?

Nie. To mocna wskazówka, ale sprawdź kontekst konsoli, pełne uruchomienie, wybór frameworka, instancję serwera i wspólne zależności. Również nieprawidłowy katalog danych lub kilka pluginów o tym samym wymaganiu może wyglądać jak całkowita awaria. Dopiero połączenie wszystkich ustaleń pozwala wiarygodnie zawęzić przyczynę błędu.

Czy restart pomoże, gdy tylko pojawi się nowy framework?

Tylko jeśli twój proces instalacji faktycznie zainstaluje przy tym ten framework lub wcześniej poprawnie go zaktualizowałeś. Przy własnym hostingu sam restart niczego nie pobiera. Porównaj wersję frameworka odczytaną po restarcie z wersją docelową. Jeśli pozostała bez zmian, zbadaj sposób aktualizacji.

Czy mogę usunąć config i pozwolić utworzyć go od nowa?

Nowy config może pomóc w porównaniu na zabezpieczonej kopii testowej. Jako uniwersalna naprawa się nie sprawdza i może zresetować twoje własne zasady. Najpierw poszukaj konkretnego błędu konfiguracji. Zabezpiecz oryginał oraz dane i zwróć uwagę, czy plugin podczas wyładowywania nie zapisuje ustawień z powrotem.

Dlaczego po aktualizacji plugin nadal widnieje jako załadowany, ale nie działa?

Załadowanie to tylko jeden etap. Konkretna funkcja może zawodzić z powodu uprawnień, ustawień, zależności potrzebnej dopiero później lub zmienionego hooka. Sprawdź wyzwalacz w kontrolowanych warunkach i przeczytaj log z tego samego momentu. Nie twierdź, że funkcja została naprawiona, tylko na podstawie wpisu na liście.

Jak długo muszę czekać na Oxide lub poprawkę pluginu?

Nie da się rzetelnie obiecać konkretnego czasu. Sprawdź aktualny kanał wydań i status danego pluginu. Jeśli kluczowe zabezpieczenie jest niedostępne, zdecyduj o bezpiecznym trybie działania serwera, zamiast liczyć na szacowaną godzinę.

Czy mogę po prostu wrócić do starszej wersji?

Tylko ze sprawdzoną, kompatybilną kombinacją i zabezpieczoną drogą powrotu. Stary framework z nowym Rustem może znów zawieść. Nowa wersja pluginu mogła zmienić dane, których starsza wersja nie rozumie. Dodatkowo zabezpiecz obecny stan i przed przywróceniem sprawdź zgodność danych.

Pojęcia, które często pojawiają się w logu

Framework: podstawa dla rozszerzeń, na przykład Oxide lub Carbon. Plugin: pojedyncze rozszerzenie z określoną funkcją. Kompilator: przekształca kod źródłowy pluginu w kod wykonywalny. Zależność: dodatkowy komponent, którego wymaga rozszerzenie. Extension: dodatkowe rozszerzenie frameworka, często w postaci skompilowanej biblioteki z własnym sposobem instalacji. Hook: powiązanie ze zdarzeniem w grze. RCON: autoryzowany zdalny dostęp do konsoli serwera. Rollback: sprawdzone przywrócenie wcześniejszego, spójnego stanu. Wipe: zresetowanie wybranych stanów gry; nie jest to ogólna metoda naprawy pluginów.

Najrozsądniejszy kolejny krok na serwerze, którego dotyczy problem, jest niewielki: zabezpiecz aktualny log startowy, sprawdź faktycznie działający framework i prześledź pierwszy komunikat o błędzie. Dopiero wtedy zdecydujesz, który pojedynczy komponent trzeba zmienić.

Źródła i stan weryfikacji

Stan weryfikacji: informacje o wydaniach sprawdzono 6 listopada 2026 r.; nie przeprowadzono nowego testu funkcjonalnego z Oxide.Rust 2.0.7894. Trzy próby błędów przeprowadzono 29 października 2026 r. na własnym, odizolowanym serwerze testowym z protokołem Rust 2635.289.1 i Oxide.Rust 2.0.7839; serwer testowy został następnie usunięty. Numery wersji z tych historycznych prób po kolejnych aktualizacjach Rust stanowią już tylko przykład.