Instalacja pluginów Rust – poradnik uMod/Oxide

Pluginy Rust instalujesz przez uMod/Oxide, aktywując framework, pobierając odpowiedni plik .cs z oficjalnej strony pluginów uMod i wgrywając go do /oxide/plugins/. Następnie sprawdzasz konfigurację, permissions i konsolę. Ważny jest kontrolowany przebieg, ponieważ wadliwe pluginy mogą wpływać na gameplay, uprawnienia albo stabilność serwera.

Wymagania

Potrzebujesz serwera Rust z dostępem do plików, dostępem do konsoli i możliwym do aktywacji frameworkiem uMod/Oxide. W game-serverhosting typowa kolejność wygląda tak: aktywować framework w panelu, uruchomić serwer, wgrać pliki pluginów, a potem ustawić konfigurację oraz uprawnienia. Nie planuj zmian bezpośrednio w czasie dużej aktywności graczy, tylko w miarę możliwości najpierw przetestuj je z kilkoma graczami albo na osobnym setupie.

Oficjalna strona uMod jest głównym źródłem pluginów Rust i dokumentacji. Do pobierania używaj dostępnego przeglądu pluginów pod umod.org/plugins?game=rust. Dla logiki obsługi uMod kluczowa jest też oficjalna dokumentacja pod umod.org/documentation. Zawsze sprawdzaj tam, czy plugin jest aktywnie utrzymywany oraz jakie permissions albo dependencies są podane.

Jeśli nadal pracujesz nad podstawowym setupem swojego serwera Rust, pomoże ci wewnętrzny poradnik Wynajem i konfiguracja serwera Rust. Informacje o RAM, ustawieniach i planowaniu pluginów znajdziesz dodatkowo w poradniku Wynajem serwera Rust: RAM, ustawienia i pluginy.

Instalacja uMod/Oxide

uMod to framework pluginów dla Rust. Rozszerza serwer o warstwę pluginów, przez którą można ładować, konfigurować i wyposażać w uprawnienia pluginy C#.

1. W Dashboard -> Mods -> aktywować uMod/Oxide
2. Serwer zostanie automatycznie zaktualizowany
3. Pluginy można teraz instalować

Po aktywacji poczekaj, aż serwer w pełni się uruchomi. Dopiero potem wgrywaj pliki do /oxide/plugins/. Jeśli folderów takich jak /oxide/config/, /oxide/data/ albo /oxide/logs/ jeszcze brakuje, uMod mógł nie zostać jeszcze w pełni zainicjalizowany albo serwer musi zostać raz czysto uruchomiony.

Instalacja pluginu

1. Odwiedź umod.org/plugins?game=rust
2. Pobierz plugin (plik .cs)
3. Wgraj do /oxide/plugins/
4. Plugin z reguły ładuje się automatycznie; pełny restart często nie jest potrzebny, ale przy większych zmianach może mieć sens

Zawsze wgrywaj oryginalny plik .cs pluginu i nie zmieniaj niepotrzebnie nazwy pliku. Po uploadzie obserwuj konsolę serwera. uMod zwykle informuje tam, czy plugin został skompilowany i załadowany, czy występują błędy składni, brakujące zależności albo problemy z wersją.

Top 20 pluginów Rust

Poniższa tabela zawiera wybór pluginów dla orientacji; aktualność i kompatybilność trzeba sprawdzić na stronie każdego projektu. Liczby pobrań to migawki albo zaokrąglone publiczne dane i przed instalacją warto je sprawdzić na odpowiedniej stronie pluginu.

Nie instaluj zbyt wielu pluginów naraz. Zacznij od podstawowego zestawu, po każdej instalacji sprawdź konsolę i dokumentuj, który plugin wprowadza jakie komendy, uprawnienia oraz zmiany w gameplayu. Zwłaszcza pluginy do teleportacji, kitów, ekonomii, stawek zbierania albo stref budowy wyraźnie zmieniają odczucia z gry.

Konfiguracja pluginu

Każdy plugin tworzy config w /oxide/config/. Plik powstaje najczęściej przy pierwszym udanym załadowaniu pluginu. Otwórz go dopiero po jednorazowym załadowaniu pluginu i zwróć uwagę, żeby JSON pozostał składniowo poprawny.

// GatherManager.json
{
  "Default Multiplier": 3.0,
  "Quarry Multiplier": 3.0,
  "Pumpjack Multiplier": 3.0
}

Zmieniaj tylko wartości, których znaczenie znasz. Po zmianie możesz przeładować plugin albo zrestartować serwer, zależnie od pluginu i rodzaju zmiany. Jeśli konsola po zapisaniu zgłasza błędy JSON, najpierw sprawdź przecinki, cudzysłowy i nawiasy.

Permissions pluginów

Wiele pluginów Rust jest zainstalowanych bez poprawnie ustawionych uprawnień, ale gracze nie mogą z nich korzystać. uMod pracuje z permissions dla użytkowników i grup. Strona pluginu często podaje, które permission trzeba przyznać.

oxide.grant user <steamid> <permission>
oxide.grant group default <permission>
oxide.revoke user <steamid> <permission>

user nadaje się dla pojedynczych administratorów albo testerów. group default zasadniczo dotyczy zwykłych graczy i należy używać go ostrożnie. Nadawaj uprawnienia tylko tak szeroko, jak to potrzebne, szczególnie przy funkcjach admina, teleportacji, kitów, usuwania albo ekonomii.

Sprawdzenie wyniku

Po instalacji sprawdź trzy rzeczy: po pierwsze plugin musi załadować się w konsoli bez błędów kompilacji. Po drugie oxide.plugins powinno pokazać plugin na liście załadowanych pluginów. Po trzecie odpowiednia komenda w grze albo efekt musi działać na koncie testowym.

Sprawdź też, czy pod /oxide/config/ powstał plik konfiguracyjny i czy pliki logów zawierają wskazówki o błędach. Jeśli zmieniono kilka pluginów jednocześnie, testuj je pojedynczo. Tak szybciej ustalisz, czy problem pochodzi z samego pluginu, z permission, z wadliwego configu albo z konfliktu.

Rozwiązywanie problemów

• Plugin się nie ładuje: Sprawdź wersję Oxide, wersję serwera Rust i wskazówki na stronie pluginu.
• Błąd w konsoli: Przeczytaj konkretny komunikat błędu i sprawdź, czy plugin jest aktualny. Przy błędach pluginu odpowiednim punktem wyjścia jest właściwa strona na umod.org.
• Wydajność: oxide.plugins pokazuje wszystkie załadowane pluginy. Usuń testowo niepotrzebne pluginy, jeśli lagi pojawiają się po zmianie.
• Konflikty: Testuj pluginy pojedynczo, szczególnie jeśli kilka pluginów zmienia czat, teleportację, kity, strefy albo ekwipunek.
• Config jest nadpisywany: Zatrzymaj serwer, zmień config, zapisz plik, a potem uruchom ponownie albo celowo przeładuj plugin.
• Gracze nie mogą używać komend: Sprawdź nazwy permissions na stronie pluginu i poprawnie nadaj je przez oxide.grant.

Kontrola, ograniczenia i bezpieczny powrót

Instrukcja „Instalacja pluginów Rust – poradnik uMod/Oxide” dotyczy typu serwera opisanego w artykule oraz stanu wersji widocznego w momencie kontroli. Nazwy menu, dostępne wersje, kompatybilność modów lub pluginów oraz wymagane zasoby mogą się różnić po aktualizacjach. Dlatego nie przenoś żadnych wartości bez sprawdzenia na inną wersję gry, loadera albo serwera.

Przed zmianami w świecie, stanie gry, konfiguracji albo rozszerzeniach utwórz backup dotkniętych plików. Następnie zmieniaj tylko jeden powiązany krok naraz i sprawdzaj go z tą samą wersją klienta oraz serwera, na której chcesz później grać.

Udany test pojedynczy nie jest gwarancją wydajności ani dostępności. Rozmiar świata, mody, pluginy, liczba graczy, ścieżka sieciowa i jednoczesne obciążenie mogą zmienić wynik. Dokumentuj wersję, zmianę i rezultat testu, żeby móc później zrozumieć odchylenia.

FAQ

Czy muszę restartować serwer Rust po każdym pluginie?

Nie zawsze. Wiele pluginów uMod ładuje się automatycznie po uploadzie do /oxide/plugins/. Przy większych zmianach, zależnościach albo niewyjaśnionych błędach kontrolowany restart mimo wszystko ma sens.

Gdzie znajdę pliki config?

Większość konfiguracji pluginów znajduje się pod /oxide/config/. Zwykle są tworzone po pierwszym udanym załadowaniu pluginu.

Dlaczego komenda pluginu nie działa w grze?

Najczęściej brakuje permission albo komenda nazywa się inaczej, niż oczekiwano. Sprawdź stronę pluginu, ustaw uprawnienia przez oxide.grant, a potem skontroluj konsolę.

Czy mogę instalować kilka pluginów Rust jednocześnie?

Technicznie tak, ale praktycznie lepiej działać krok po kroku. Zainstaluj jeden plugin, sprawdź konsolę i funkcję, a dopiero potem przejdź do następnego.

Co zrobić przy problemach z wydajnością po instalacji?

Dezaktywuj ostatnio zainstalowane pluginy pojedynczo, obserwuj konsolę serwera i sprawdź oxide.plugins. Tak zawęzisz, czy przyczyną jest konkretny plugin, czy ich kombinacja.