Przejdź do treści
Wróć do bazy wiedzy

Instalacja pluginów na serwerze SCP: Secret Laboratory

Zainstaluj plugin LabAPI albo EXILED: gdzie wgrać plik .dll i jego zależności, jak sprawdzić, czy się wczytał, i gdzie zmienić jego ustawienia.

Pluginy dodają do serwera SCP: Secret Laboratory nowe funkcje, np. własne przedmioty, role albo integrację z Discordem. Plugin to plik .dll, który wgrywasz do odpowiedniego folderu w zakładce Pliki.

LabAPI czy EXILED

Każdy plugin jest pisany pod jeden z dwóch frameworków. Sprawdź to w jego opisie, zanim go pobierzesz.

  • LabAPI: oficjalny framework od Northwood, wbudowany w grę. Plugin LabAPI działa na każdym serwerze, także z silnikiem EXILED.
  • EXILED: framework społeczności. Plugin EXILED działa tylko na serwerze z silnikiem EXILED. Jak go włączyć, opisuje artykuł Pierwsza konfiguracja.

Niektóre pluginy mają osobny plik pod każdy framework, np. UncomplicatedCustomItems-LabApi.dll i UncomplicatedCustomItems-Exiled.dll. Pobierz ten, który pasuje do silnika serwera.

Pluginy LabAPI znajdziesz w katalogu pluginów SCP: SL (otwiera się w nowej karcie), a pluginy EXILED zwykle na GitHubie, w sekcji Releases repozytorium pluginu.

Plugin LabAPI

LabAPI trzyma pluginy w folderze .config/SCP Secret Laboratory/LabAPI. Każdy rodzaj plików ma tam dwa podfoldery:

  • global: wczytywane na każdym porcie,
  • <port>: wczytywane tylko na serwerze z tym portem, np. 7777. Port znajdziesz w zakładce Przegląd.

Na jednym serwerze oba działają tak samo. Jeśli instrukcja pluginu nie mówi inaczej, używaj folderu z numerem portu.

  1. Wgraj zależności

    Jeśli plugin ma zależności, czyli dodatkowe pliki .dll, często spakowane jako dependencies.zip, otwórz folder LabAPI/dependencies/<port> i kliknij Wgraj plik. Archiwum rozpakujesz w panelu: kliknij trzy kropki przy pliku i wybierz Rozpakuj. Pliki .dll pojawią się w tym samym folderze.

  2. Wgraj plugin

    Otwórz folder LabAPI/plugins/<port>, kliknij Wgraj plik i wybierz plik .dll pluginu.

  3. Uruchom serwer ponownie

    Pluginy wczytują się przy starcie. W zakładce Konsola pojawi się linia [LabApi] [LOADER] Successfully loaded z nazwą pluginu.

Ustawienia pluginu pojawią się po pierwszym starcie w folderze LabAPI/configs/<port>/<nazwa pluginu>, zwykle jako config.yml.

Plugin EXILED

  1. Wgraj plugin

    Otwórz folder .config/EXILED/Plugins, kliknij Wgraj plik i wybierz plik .dll pluginu. Zależności, jeśli plugin ich wymaga, wgraj do .config/EXILED/Plugins/dependencies.

  2. Uruchom serwer ponownie

    W konsoli pojawi się linia [Exiled.Loader] Loaded plugin z nazwą i wersją pluginu.

Ustawienia pluginu EXILED tworzy przy pierwszym starcie w .config/EXILED/Configs/Plugins/<nazwa pluginu>/<port>.yml. Konsola wypisuje wtedy ostrzeżenie doesn't have default configs, generating..., które nie oznacza błędu. Uprawnienia pluginów ustawisz w .config/EXILED/Configs/permissions.yml, co opisuje artykuł Rangi i uprawnienia.

Zmiana ustawień i usuwanie

  • Ustawienia: otwórz plik konfiguracyjny pluginu w zakładce Pliki, zmień wartości, kliknij Zapisz plik i uruchom serwer ponownie.
  • Usunięcie: usuń plik .dll pluginu i uruchom serwer ponownie. Folder z ustawieniami możesz zostawić na wypadek powrotu do pluginu albo też go usunąć.

Najczęstsze problemy

Pluginu nie ma w konsoli po restarcie

Sprawdź, czy plik leży we właściwym folderze. Plugin LabAPI musi być w LabAPI/plugins/global albo LabAPI/plugins/<port>, a plugin EXILED w .config/EXILED/Plugins. Plugin EXILED nie wczyta się też na serwerze z silnikiem LocalAdmin.

Plugin wczytuje się, ale zaraz potem jest błąd

Najczęściej plugin potrzebuje ustawień, których nie ma w domyślnym pliku, np. tokenu bota albo ID kanału. Przeczytaj w konsoli linie z nazwą pluginu w nawiasach kwadratowych i uzupełnij plik konfiguracyjny według instrukcji autora.

Błąd o brakującym pliku albo zależności

Plugin nie znalazł swojej zależności. Wgraj pliki .dll z archiwum zależności do LabAPI/dependencies/<port> (LabAPI) albo .config/EXILED/Plugins/dependencies (EXILED).

Plugin przestał działać po aktualizacji gry

Plugin zbudowany pod starszą wersję LabAPI albo EXILED może nie działać z nową wersją gry. Pobierz najnowsze wydanie pluginu. Jeśli autor go jeszcze nie zaktualizował, usuń plugin do czasu poprawki.