Instalacja modów Don't Starve Together – serwer i klient

Mody do Don't Starve Together instalujesz na Dedicated Server w dwóch krokach: najpierw pozwalasz serwerowi pobrać wybrane mody z Workshopu przez ich ID, a potem aktywujesz i konfigurujesz je w odpowiednim pliku modoverrides.lua. Ważne jest, aby traktować Shard Master i Caves osobno oraz po każdej zmianie sprawdzać restart.

Wymagania

Potrzebujesz dostępu do plików konfiguracyjnych swojego serwera Don't Starve Together i przed zmianami powinieneś zatrzymać serwer. W game-serverhosting sensowny przebieg pracy wygląda tak: edytujesz pliki, zapisujesz zmianę, restartujesz serwer, sprawdzasz log i dopiero potem dodajesz kolejne mody. Dzięki temu da się ustalić, który mod odpowiada za problemy.

Oficjalnym punktem odniesienia dla działania Dedicated Server jest poradnik Klei na forum producenta: Dokumentacja na forums.kleientertainment.com. Przy modach istotna jest też konkretna strona w Steam Workshop, bo znajdują się tam autor moda, Workshop-ID, zależności oraz wskazówki dotyczące użycia po stronie serwera lub klienta.

Jeśli najpierw konfigurujesz sam serwer, pasuje wewnętrzny poradnik Wynajem i konfiguracja serwera Don't Starve Together. Dla podobnych procesów z modami w innych grach dobrymi punktami porównania są Instalacja modów Factorio na serwerze oraz Instalacja modów V Rising z BepInEx.

Znajdowanie Workshop-ID

Każdy mod ze Steam Workshop ma numeryczne ID. Znajdziesz je w URL strony Workshopu, zwykle jako wartość po id=. Przykład: w URL takim jak steamcommunity.com/sharedfiles/filedetails/?id=378160973 wartość 378160973 to Workshop-ID.

Zapisuj tylko te mody, których naprawdę chcesz używać na serwerze. Wiele modów poprawiających wygodę działa wyłącznie po stronie klienta i nie należy ich dodawać do konfiguracji serwera. Inne mody zmieniają świat, balans, interfejs albo ekwipunek i muszą zostać aktywowane po stronie serwera. Dlatego zawsze sprawdzaj opis moda oraz wskazówki autora.

Konfiguracja modów przez Workshop

Wpisz mody, które serwer ma pobrać, do dedicated_server_mods_setup.lua. Ten plik jest listą pobierania. Nie aktywuje jeszcze modów w twoim świecie, tylko najpierw zapewnia, że Dedicated Server zna zawartość z Workshopu.

-- Mody, które mają zostać pobrane
ServerModSetup("378160973")    -- Global Positions
ServerModSetup("462434129")    -- Wormhole Marks
ServerModSetup("458587300")    -- Season Clock
ServerModSetup("375850593")    -- Extra Equip Slots

Zwróć uwagę na poprawne cudzysłowy, brak dodatkowych spacji w ID i brak podwójnych wpisów. Komentarze za liniami są przydatne, bo później od razu widzisz, które ID należy do którego moda.

Aktywacja i konfiguracja modów

Mody aktywuje się w modoverrides.lua. Ten plik określa, które pobrane mody z Workshopu są aktywne w świecie. Na serwerze z Caves potrzebujesz konfiguracji dla Master i Caves, bo oba Shardy mogą używać własnych ustawień.

W modoverrides.lua (dla Master i Caves):

return {
  ["workshop-378160973"] = { enabled = true },
  ["workshop-462434129"] = { enabled = true },
  ["workshop-458587300"] = {
    enabled = true,
    configuration_options = {
      clock_style = "analog"
    }
  }
}

Klucz składa się z workshop- plus Workshop-ID. enabled = true aktywuje moda. Jeśli mod obsługuje własne opcje, należą one do configuration_options. To, które opcje są poprawne, nie jest ustalone ogólnie, tylko zależy od konkretnego moda. Dlatego przejmuj tylko te opcje, które pojawiają się w opisie Workshopu, w istniejących przykładowych konfiguracjach albo w konfiguracji wygenerowanej przez grę.

Popularne mody

Poniższa tabela zachowuje istniejące przykładowe mody. Nie jest to lista rekomendacji z obietnicami wydajności lub stabilności, lecz praktyczny punkt startowy dla często używanych typów modów.

Dodawaj nowe mody pojedynczo i testuj po każdym restarcie. Szczególnie mody zmieniające ekwipunek, walkę, generowanie świata albo interfejs użytkownika mogą wpływać na siebie nawzajem. Stopniowe podejście wyraźnie oszczędza czas przy konfliktach.

Mody klienta vs. mody serwera

• Mody serwera: Muszą być zainstalowane na serwerze
• Mody klienta: Muszą być zainstalowane u gracza
• Obustronne: Muszą być zainstalowane po obu stronach

Większość modów jest obustronna – gracze pobierają je automatycznie podczas łączenia. Mimo to nie zakładaj, że każdy mod zadziała bez dodatkowych działań. Niektóre mody wymagają określonych ustawień klienta, inne są przeznaczone tylko do lokalnych funkcji wygody i nie powinny trafiać do plików serwera.

Sprawdzanie wyniku

Po zmianie zrestartuj serwer i obserwuj proces uruchamiania. Poprawny test składa się z trzech części: serwer startuje bez błędów Lua, świat jest dostępny, a gracz może się połączyć bez utknięcia w pętli pobierania moda lub błędów.

Następnie sprawdź w grze, czy żądana funkcja faktycznie jest aktywna. Przy Global Positions powinieneś na przykład zobaczyć, czy pozycje graczy pojawiają się na mapie zgodnie z oczekiwaniami. Przy Caves dodatkowo testujesz przejście między powierzchnią a jaskiniami, bo błąd często jest widoczny tylko w jednym Shardzie.

Rozwiązywanie problemów

• Mody się nie ładują: Sprawdź Workshop-ID
• Crash: Dezaktywuj mody pojedynczo
• Mody Caves: modoverrides.lua w OBU folderach Shardów!

Jeśli serwer po dodaniu nowego moda już się nie uruchamia, najpierw usuń ostatnio zmienioną linię z modoverrides.lua i uruchom ponownie. Jeśli błąd zostaje, sprawdź też dedicated_server_mods_setup.lua, zwłaszcza nawiasy, cudzysłowy i przecinki w tabelach Lua.

Jeśli gracze zawieszają się podczas łączenia, mod może być nieaktualny, może brakować zależności albo może być wymagana część po stronie klienta. Otwórz wtedy stronę moda w Workshopie i sprawdź wskazówki autora. Przy kilku nowych modach nie dezaktywuj ich wszystkich na stałe, tylko testowo dziel listę na pół, aż zawęzisz źródło problemu.

Przy problemach z Caves najczęstszą przyczyną jest różna konfiguracja między Shardem Master i Caves. Nie kopiuj ustawień na ślepo, tylko sprawdź, czy mod jest przeznaczony dla obu Shardów. Mody generowania świata często należą do innej kategorii niż czyste mody interfejsu lub wygody.

Kontrola, ograniczenia i bezpieczny powrót

Poradnik „Instalacja modów Don't Starve Together – serwer i klient” dotyczy typu serwera opisanego w artykule oraz wersji widocznej w momencie sprawdzania. Nazwy menu, dostępne wersje, kompatybilność modów lub pluginów i wymagane zasoby mogą się zmienić po aktualizacjach. Dlatego nie przenoś żadnych wartości bez sprawdzenia na inną wersję gry, loadera lub serwera.

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

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

FAQ

Czy muszę restartować serwer po każdej zmianie moda?

Tak. Zmiany w dedicated_server_mods_setup.lua i modoverrides.lua działają niezawodnie dopiero po restarcie serwera.

Gdzie wpisuję Workshop-ID?

Czysta lista pobierania trafia do dedicated_server_mods_setup.lua. Następnie mod aktywuje się w modoverrides.lua przez klucz workshop-ID, na przykład workshop-378160973.

Czy potrzebuję tego samego modoverrides.lua dla Caves?

Jeśli twój serwer używa Caves, musisz uwzględnić konfigurację modów dla obu Shardów. Wiele konfiguracji potrzebuje jednego modoverrides.lua w folderze Master i drugiego w folderze Caves.

Czy gracze automatycznie pobierają mody serwera?

Przy wielu modach obustronnych klient automatycznie pobiera potrzebną zawartość podczas łączenia. Nie zastępuje to jednak sprawdzenia, czy mod jest aktualny, pasuje do serwera i nie ma dodatkowych wskazówek od autora moda.

Co zrobić, jeśli mod powoduje crash serwera?

Najpierw dezaktywuj ostatnio dodanego moda i zrestartuj serwer. Jeśli jednocześnie zmieniono kilka modów, testuj je pojedynczo albo w małych grupach, aż konflikt będzie jasny.