Jak instalować i diagnozować mody do Vintage Story

Zanim pobierzesz mod

Oficjalna baza modów Vintage Story jest główną witryną do wyszukiwania i dystrybucji modów, zalecaną przez wiki utrzymywaną przez społeczność i hostowaną w oficjalnej infrastrukturze Vintage Story. Popularność moda nie gwarantuje, że będzie bezpieczny w twojej konfiguracji. Przeczytaj opis, listę zależności, oznaczenie strony klient/serwer, obsługiwane wersje gry, historię plików oraz najnowsze zgłoszenia problemów.

Kontrola	Co potwierdzić dla wersji 1.22.5
Zgodność z grą	Wybrany plik wymienia obsługę 1.22.5 albo zgodnego zakresu 1.22.x wskazanego przez autora
Zależności	Każda wymagana biblioteka lub mod towarzyszący jest zainstalowany w zgodnej wersji
Strona klienta/serwera	Mod zainstalowano tam, gdzie według strony w bazie musi działać
Nakładanie się funkcji	Inny włączony mod nie zastępuje tych samych mechanik, zasobów ani rejestracji
Wpływ na świat	Rozumiesz, czy późniejsze usunięcie moda może skasować bloki, przedmioty, jednostki lub dane świata
Kopia zapasowa	Kopia zmienianego zapisu znajduje się poza folderem aktywnego świata

Nie zakładaj, że najnowszy plik moda jest właściwy. Oficjalny poradnik rozwiązywania problemów wyraźnie ostrzega, że nowsza wersja moda może być przeznaczona dla innego wydania gry. Karta Files jest rozstrzygającym miejscem do dopasowania kompilacji moda do faktycznie uruchamianej wersji.

Instalacja moda w grze jednoosobowej

Pobierz wybrany plik z jego strony w oficjalnej bazie modów.
Pozostaw mod w archiwum .zip, chyba że autor wyraźnie poda inne instrukcje. Standardowa instalacja nie wymaga rozpakowania archiwum.
Uruchom Vintage Story i z głównego menu otwórz Mod Manager.
Wybierz Open Mods Folder. Pozwala to uniknąć zgadywania, którego folderu danych użytkownika używa bieżąca instalacja.
Skopiuj lub przenieś plik .zip moda do otwartego folderu.
Wróć do menedżera i wybierz Reload Mods albo zamknij i ponownie uruchom grę.
Upewnij się, że mod pojawia się na liście i jest włączony. Pozostaw włączone wbudowane pozycje Essentials, Survival i Creative Mode; razem składają się na standardową grę.
Przetestuj zmianę w nowym świecie albo jednorazowej kopii, zanim otworzysz cenny, długo rozwijany zapis.

W systemie Windows domyślna ścieżka modów użytkownika to %appdata%\VintagestoryData\Mods. Dla Linuksa oficjalny poradnik podaje ~/.config/VintagestoryData/Mods. Przycisk menedżera modów jest bezpieczniejszy, jeśli zmieniono ścieżkę danych albo przeniesiono instalację.

Kopie zapasowe i aktualizacje

Oficjalny poradnik zaleca wykonanie kopii zapisów przed dodaniem moda, usunięciem moda lub aktualizacją Vintage Story. Tę samą zasadę stosuj przed dużymi aktualizacjami modów. Kopia zapasowa powinna być osobnym egzemplarzem, a nie kolejnym plikiem wewnątrz aktywnego folderu zapisu.

Podczas aktualizacji moda:

Zakończ grę i zamknij klienta lub serwer.
Przeczytaj listę zmian moda, zwracając uwagę na instrukcje migracji i zmiany niezgodne wstecz.
Wykonaj kopię świata i odpowiednich plików konfiguracyjnych.
Usuń stare, powielone archiwum, jeżeli nowy plik ma inną nazwę.
Zainstaluj zgodny zamiennik i potwierdź, że aktywna jest tylko jedna kopia.
Najpierw wczytaj kopię testową i sprawdź bloki, ekwipunki, jednostki oraz receptury dodawane przez mod.

Lista diagnostyczna

Objaw	Pierwsze kontrole	Bezpieczny następny krok
Mod nie pojawia się na liście	Zły folder Mods, nieprawidłowe archiwum, nieaktualne niestandardowe `modPaths`	Otwórz folder z menedżera; jeśli zmieniła się nazwa użytkownika systemu, przy zamkniętej grze sprawdź ścieżki w `clientsettings.json` i `serverconfig.json`
Gra przestaje działać po aktualizacji	Mod nie obsługuje 1.22.5	Wyłącz mody spoza standardowej gry i zainstaluj wersje wyraźnie zgodne z bieżącym wydaniem
Brak bloków lub wyjątki przy uruchamianiu	Powielone wersje tego samego moda kodowego	Przeszukaj wszystkie skonfigurowane ścieżki i pozostaw tylko zamierzoną kopię
Awaria występuje wyłącznie przy kilku modach	Konflikt między dwoma modami	Odtwórz problem w świecie testowym i wyłączaj połowę zestawu, aż wyizolujesz winowajcę
Świat działa bez modów, ale nie z nimi	Niezgodna zależność, wersja albo strona ładowania	Sprawdź kartę Files, zależności oraz wymagania klienta i serwera
Serwer z modami zachowuje stary plik	Plik w pamięci podręcznej dla danego serwera ma tę samą nazwę	Opuść serwer, usuń jego folder w `ModsByServer`, a następnie połącz się ponownie, aby pobrać zestaw serwera

Konflikty badaj w nowym świecie lub kopii. Wielokrotne włączanie i wyłączanie modów dodających zawartość w jedynym egzemplarzu ważnego świata może usunąć albo przemapować dane i utrudnić odnalezienie pierwotnego problemu.

Mody w trybie wieloosobowym

Współczesne klienty Vintage Story tworzą dla każdego serwera osobny folder w ModsByServer, gdy gracz dołącza do zmodyfikowanego serwera. Mody serwerowe lub uniwersalne udostępniane przez serwer mogą zostać pobrane do tego zestawu bez mieszania ich ze zwykłym folderem Mods używanym w grze jednoosobowej. Mody działające wyłącznie po stronie klienta mogą nadal wymagać ręcznej instalacji, zależnie od moda i zasad serwera.

Właściciel serwera powinien utrzymywać zgodność wersji serwera, modów i łączących się klientów. Zestaw modów zmieniaj przy wyłączonym serwerze, najpierw wykonuj kopię świata i testuj całość lokalnie przed ponownym otwarciem publicznej instancji. Ścieżki danych, porty i bezpieczne aktualizacje opisuje poradnik trybu wieloosobowego.

Często zadawane pytania

Czy należy rozpakować mod do Vintage Story?

Zwykle nie. Oficjalna instrukcja instalacji mówi, że większość modów pobiera się jako pliki .zip i umieszcza bezpośrednio w folderze Mods.

Czy mod do starszej wersji może działać w 1.22.5?

Być może, ale nie zgaduj. Kieruj się zgodnością podaną na karcie Files oraz instrukcjami autora moda.

Dlaczego Essentials, Survival i Creative Mode widnieją jako mody?

Vintage Story buduje standardową grę za pośrednictwem własnego systemu modów. Te trzy wpisy składają się na grę podstawową i zwykle powinny pozostać włączone.

Jak znaleźć mod powodujący awarię?

Przygotuj powtarzalny test w nowym świecie lub kopii zapisu, wyłącz połowę modów spoza gry podstawowej, a następnie dalej dziel podejrzaną grupę na pół. Takie wyszukiwanie binarne jest znacznie szybsze niż przypadkowe testowanie długiej listy po jednej pozycji.

Jak instalować mody do Vintage Story

Zrób kopię, zachowaj pakiet, odizoluj konflikt

Skopiuj świat

Zachowaj .zip

Odizoluj