Addony Workshop do Garry's Mod instalujesz poprawnie przez kolekcję Steam Workshop, Steam Web API Key i opcjonalnie resource.AddWorkshop() do pobierania po stronie klienta. Dzięki temu konfiguracja serwera pozostaje przejrzysta, addony można centralnie wymieniać, a przy problemach możesz dokładnie sprawdzić, czy błędna jest kolekcja, API Key albo pojedyncze Workshop-ID.
Wymagania
Potrzebujesz dostępu do parametrów startowych swojego serwera Garry's Mod, kolekcji Steam Workshop i Steam Web API Key. Oficjalnym źródłem treści Workshop dla Garry's Mod jest Steam Workshop dla Garry's Mod. API Key utworzysz na oficjalnej stronie Steam steamcommunity.com/dev/apikey.
Dobieraj addony świadomie. Duża kolekcja może wydłużyć start serwera, zmusić klientów do dłuższego pobierania i utrudnić znalezienie błędów. Na serwerach produkcyjnych warto najpierw testować addony pojedynczo albo w małych grupach, zanim dodasz je na stałe do głównej kolekcji. W game-serverhosting taki przebieg dobrze pasuje do kontrolowanego modelu działania: zmiany są dokumentowane, sprawdzane i dopiero potem udostępniane graczom.
Tworzenie kolekcji Workshop
- Przejdź do Steam Workshop
- Utwórz nową kolekcję
- Dodaj wszystkie wybrane addony
- Skopiuj Collection-ID
Collection-ID znajduje się w URL kolekcji Steam. Skopiuj tylko numeryczne ID, nie cały URL. Upewnij się też, że kolekcja jest publiczna albo dostępna dla serwera. Jeśli addon zostanie usunięty, ustawiony jako prywatny albo zaktualizowany przez autora, może to wpłynąć na start serwera lub pobieranie po stronie klienta. Dlatego po większych zmianach zawsze sprawdzaj konsolę serwera.
Ładowanie kolekcji na serwerze
W linii startowej serwera:
+host_workshop_collection <collection_id>
-authkey <steam_web_api_key>
Zastąp <collection_id> ID swojej kolekcji Workshop, a <steam_web_api_key> swoim Steam Web API Key. Parametr +host_workshop_collection każe serwerowi załadować wskazaną kolekcję. Parametr -authkey zapewnia dostęp do usług Steam Web wymaganych do pobierania z Workshop.
Po wpisaniu parametrów startowych uruchom serwer ponownie. Przy pierwszym starcie obserwuj konsolę albo log. Jeśli treści Workshop się nie ładują, przyczyną często jest błędne Collection-ID, brakujący lub nieprawidłowy API Key albo addon, który nie jest już dostępny.
Steam Web API Key
Wymagany do pobierania z Workshop:
- Przejdź do steamcommunity.com/dev/apikey
- Wygeneruj key
- Wpisz go jako
-authkeyw linii startowej
Traktuj API Key jak token dostępu. Nie udostępniaj go publicznie i nie wpisuj go na forach, zrzutach ekranu ani w publicznie dostępnych repozytoriach. Jeśli podejrzewasz, że key został ujawniony, wygeneruj go ponownie w Steam i nie używaj dalej starego keya.
Gracze pobierają addony automatycznie
Aby gracze automatycznie pobierali addony, dodaj w lua/autorun/server/workshop.lua:
resource.AddWorkshop("workshop_id_1")
resource.AddWorkshop("workshop_id_2")
resource.AddWorkshop("workshop_id_3")
resource.AddWorkshop() używa pojedynczych Workshop-ID. Wpisz tutaj addony, które klienci mają automatycznie pobierać podczas łączenia. To szczególnie ważne dla map, modeli, materiałów, dźwięków i innych treści potrzebnych graczom lokalnie. Addony działające wyłącznie po stronie serwera nie muszą koniecznie być dystrybuowane do klientów.
Utrzymuj ten plik w czytelnej strukturze. Możesz grupować addony według celu, na przykład mapy, bronie, playermodels albo HUD-y. Jeśli addon powoduje problemy, tymczasowo zakomentuj odpowiedni wpis i uruchom serwer ponownie. Dzięki temu szybciej znajdziesz konflikty bez rozbierania całej kolekcji.
Popularne kategorie addonów
| Kategoria | Przykłady |
|---|---|
| Mapy | ttt_minecraft, ph_office |
| Bronie | M9K Weapons, TFA Base |
| Playermodels | PM + Playermodel Selector |
| Narzędzia | Wiremod, Precision Tool |
| HUD-y | DarkRP HUD, TTT HUD |
Te kategorie są typowymi przykładami, a nie rekomendacją dla każdej konfiguracji. Serwery DarkRP, TTT, Prop Hunt i Sandbox mają różne wymagania. Kluczowe jest to, aby addony pasowały do trybu gry, były aktywnie utrzymywane i nie dublowały funkcji. Dwie bazy broni, kilka HUD-ów albo kilka narzędzi administracyjnych mogą sobie wzajemnie przeszkadzać.
Jeśli prowadzisz też inne gry z workflow modów, pomogą Ci zasady z poradnika Project Zomboid Workshop i poradnika instalacji modów ARK: najpierw wyjaśnij zależności, potem wpisz ID w czysty sposób, a następnie sprawdź wszystko przez logi i test klienta.
Sprawdzenie wyniku
Po każdej większej zmianie uruchom serwer ponownie i skontroluj trzy punkty. Po pierwsze: konsola nie powinna pokazywać błędów Workshop dotyczących kolekcji ani API Key. Po drugie: wybrane addony powinny być dostępne po stronie serwera, na przykład mapy na liście map albo narzędzia w odpowiednim trybie gry. Po trzecie: klient testowy powinien automatycznie pobierać wymagane treści przy łączeniu albo nie powinien pokazywać problemów z brakującymi teksturami.
Testuj najlepiej klientem, który nie ma jeszcze lokalnie zasubskrybowanych addonów. Inaczej łatwo przeoczysz, że automatyczne pobieranie dla nowych graczy nie działa. Na publicznych serwerach opłaca się też dodać krótką informację w opisie serwera, jeśli trzeba pobrać bardzo duże treści.
Rozwiązywanie problemów
- Addon się nie ładuje: sprawdź Steam Web API Key
- Brakujące tekstury: zainstaluj CSS Content Pack
- Wolne pobieranie: ogranicz kolekcję do minimum
Jeśli cała kolekcja się nie ładuje, najpierw sprawdź literówki w +host_workshop_collection i -authkey. Jeśli brakuje tylko jednego addonu, otwórz jego stronę Workshop i sprawdź, czy nadal jest dostępny. Przy brakujących teksturach rozróżnij treści Workshop i dodatkowy content wymagany z zewnątrz. Serwery Garry's Mod często używają treści, których nie da się automatycznie zastąpić pojedynczym addonem.
Przy długim czasie ładowania usuń nieużywane mapy, zdublowane modele, stare paczki broni i duże kolekcje dźwięków albo materiałów. Mniejsza kolekcja jest łatwiejsza w utrzymaniu i zmniejsza prawdopodobieństwo, że gracze przerwą pierwszy join.
Sprawdzenie, ograniczenia i bezpieczny powrót
Instrukcja „Instalacja addonów Workshop do Garry's Mod” 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ą różnić się po aktualizacjach. Dlatego nie przenoś żadnych wartości bez sprawdzenia na inną wersję gry, loadera albo serwera.
Przed zmianami w świecie, zapisie gry, konfiguracji albo rozszerzeniach utwórz backup objętych plików. Następnie zmieniaj tylko jeden powiązany krok naraz i sprawdzaj go tą samą wersją klienta i serwera, na której chcesz później grać.
| Punkt kontroli | Oczekiwany wynik | Przerwanie i powrót |
|---|---|---|
| Start serwera | Serwer osiąga stan gotowości bez nowych komunikatów o błędach. | Przy błędach startu cofnij zmianę i wgraj ostatni backup. |
| Test połączenia | Konto testowe może połączyć się przez adres pokazany w panelu. | Przy błędach wersji lub połączenia ponownie porównaj wersję, port i odblokowania. |
| Test funkcji | Konkretnie zmieniona funkcja działa bez uszkadzania istniejącego świata lub danych gry. | Przy skutkach ubocznych zatrzymaj serwer i przywróć zabezpieczone pliki. |
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 wynik testu, aby później móc odtworzyć przyczyny odchyleń.
FAQ
Czy zawsze potrzebuję kolekcji Workshop?
Dla serwera z wieloma addonami kolekcja jest najczystszą drogą, bo zarządzasz wyborem centralnie w Steam. Pojedyncze Workshop-ID w resource.AddWorkshop() nadal są ważne, aby klienci automatycznie pobierali wymagane treści.
Jaka jest różnica między Collection-ID a Workshop-ID?
Collection-ID wskazuje kolekcję wielu addonów. Workshop-ID wskazuje pojedynczy addon. W linii startowej używasz Collection-ID, a w resource.AddWorkshop() wpisujesz pojedyncze Workshop-ID.
Dlaczego gracze widzą brakujące tekstury?
Brakujące tekstury powstają najczęściej wtedy, gdy treści klienta nie zostały załadowane albo potrzebny jest dodatkowy content. Sprawdź resource.AddWorkshop(), ID addonów i to, czy dotknięty addon odwołuje się do dalszego contentu.
Czy muszę restartować serwer po każdej zmianie addonu?
Przy zmianach parametrów startowych, kolekcji Workshop albo serwerowych plików Lua powinieneś wykonać restart. Tylko tak niezawodnie sprawdzisz, czy serwer poprawnie ładuje kolekcję i rejestruje zasoby klienta.
Jak duża powinna być kolekcja?
Tak mała, jak to możliwe, i tak duża, jak to konieczne. Usuń addony, których Twój tryb gry aktywnie nie używa. To ułatwia szukanie błędów, utrzymuje pobieranie w rozsądnych granicach i pozwala lepiej kontrolować zmiany podczas działania serwera.