Ten przewodnik opisuje, jak zainstalować framework modyfikacji Oxide/uMod lub Carbon na serwerze Rust, dodawać wtyczki społecznościowe oraz zarządzać nimi z poziomu konsoli. Ogólne informacje o konfiguracji serwera i zmiennych startowych znajdziesz w Przewodniku po konfiguracji serwera Rust.

Instalacja Oxide/uMod lub Carbon

Oxide (obecnie utrzymywany jako uMod) oraz Carbon to frameworki modyfikacji dla Rust, które umożliwiają instalację wtyczek tworzonych przez społeczność. Frameworki te dodają funkcje takie jak systemy ekonomii, niestandardowe zestawy, nagrody za głosowanie, strefy ochrony PvE i wiele więcej.

Nie musisz ręcznie przesyłać żadnych plików. Framework modyfikacji jest instalowany automatycznie przez ustawienie jednej zmiennej startowej:

1. Zatrzymaj serwer z karty Console w GPanel.
2. Zaloguj się do GPanel i przejdź do karty Startup.
3. Znajdź zmienną FRAMEWORK i ustaw ją na:
   • oxide — dla Oxide/uMod (najszerzej używany framework, z największą biblioteką wtyczek)
   • carbon — dla frameworku Carbon (alternatywa z własnym ekosystemem wtyczek)
   • vanilla — aby uruchomić serwer bez żadnego frameworku modyfikacji
4. Uruchom serwer. Pliki frameworku są pobierane i stosowane automatycznie. Przy pierwszym uruchomieniu z Oxide generowana jest struktura katalogów oxide/.
5. Sprawdź dziennik konsoli pod kątem wiersza takiego jak Loaded plugin Oxide.Core, aby potwierdzić, że Oxide jest aktywny.

Instalacja wtyczek

Wtyczki są dystrybuowane jako pliki .cs (kod źródłowy C#). Oxide kompiluje je na serwerze w czasie działania — wstępna kompilacja nie jest wymagana.

1. Pobierz plik wtyczki .cs z umod.org lub innego zaufanego źródła.
2. Prześlij plik .cs do katalogu oxide/plugins/ na serwerze za pomocą SFTP lub menedżera plików GPanel. Pomoc dotyczącą SFTP znajdziesz w artykule Jak przesyłać pliki przez SFTP.
3. Jeśli serwer jest uruchomiony, wtyczka zostanie wykryta i skompilowana automatycznie w ciągu kilku sekund. W konsoli zobaczysz komunikat potwierdzający jej załadowanie, np. Loaded plugin MyPlugin v1.2.3 by Author.
4. Jeśli serwer nie jest uruchomiony, wtyczka zostanie załadowana przy następnym uruchomieniu.

Struktura katalogów Oxide

oxide/
  plugins/
    MyPlugin.cs       <- place plugin files here
    AnotherPlugin.cs
  config/             <- auto-generated plugin config files
  data/               <- plugin data files
  logs/               <- plugin log files

Konfiguracja wtyczek

Większość wtyczek generuje plik konfiguracyjny JSON w oxide/config/ przy pierwszym załadowaniu. Aby dostosować wtyczkę:

1. Pozwól wtyczce załadować się co najmniej raz, aby wygenerowała domyślny plik konfiguracyjny.
2. Zatrzymaj serwer (lub pamiętaj, że niektóre wtyczki obsługują przeładowanie konfiguracji na żywo).
3. Otwórz plik konfiguracyjny wtyczki w oxide/config/PluginName.json za pomocą menedżera plików GPanel lub SFTP.
4. Edytuj ustawienia i zapisz plik.
5. Przeładuj wtyczkę poleceniem oxide.reload PluginName lub uruchom ponownie serwer.

Zarządzanie wtyczkami z poziomu konsoli

Te polecenia można uruchamiać z konsoli GPanel lub za pomocą klienta RCON. Konfigurację RCON opisuje artykuł Dostęp RCON i polecenia administracyjne w Rust.

Aktualizacja wtyczek

Aby zaktualizować wtyczkę do nowszej wersji:

1. Pobierz zaktualizowany plik .cs ze strony wtyczki na umod.org.
2. Prześlij nowy plik do oxide/plugins/, nadpisując istniejący plik.
3. Jeśli serwer jest uruchomiony, Oxide wykrywa zmianę pliku i automatycznie rekompiluje oraz przeładowuje wtyczkę. Alternatywnie uruchom polecenie oxide.reload PluginName.
4. Sprawdź konsolę pod kątem błędów. Niektóre aktualizacje wtyczek mogą wymagać zmian w pliku konfiguracyjnym w oxide/config/.

Usuwanie wtyczek

Aby całkowicie usunąć wtyczkę:

1. Uruchom polecenie oxide.unload PluginName, aby wyładować wtyczkę podczas działania serwera.
2. Usuń plik .cs z oxide/plugins/.
3. Opcjonalnie usuń plik konfiguracyjny wtyczki z oxide/config/ oraz pliki danych z oxide/data/, jeśli już ich nie potrzebujesz.

Popularne wtyczki

Rozwiązywanie problemów z wtyczkami

Jeśli wtyczki się nie ładują, sprawdź następujące rzeczy:

• Potwierdź, że Oxide jest zainstalowany i aktywny. W karcie Startup w GPanel zmienna FRAMEWORK musi być ustawiona na oxide. Dziennik konsoli powinien podczas uruchamiania pokazywać Loaded plugin Oxide.Core.
• Pliki wtyczek muszą być umieszczone bezpośrednio w oxide/plugins/ z dokładnym rozszerzeniem .cs. Pliki w podkatalogach lub z błędnymi rozszerzeniami są ignorowane.
• Sprawdź konsolę oraz oxide/logs/ pod kątem błędów kompilacji. Wtyczka z błędem składni nie załaduje się, a komunikat o błędzie opisze problem.
• Niektóre wtyczki mają zależności od innych wtyczek (np. wiele wtyczek sklepowych wymaga Economics). Najpierw zainstaluj wszystkie wymagane zależności.

Inne częste problemy z serwerem opisuje artykuł Rozwiązywanie problemów z serwerem Rust.

Potrzebujesz pomocy?

Jeśli napotkasz problem nieopisany w tym przewodniku, nasz zespół wsparcia jest dostępny, aby pomóc. Wyślij zgłoszenie do pomocy technicznej i dołącz identyfikator serwera, opis problemu oraz wszelkie istotne dane wyjściowe konsoli.