Instalacja modów

Szczegółowy przewodnik instalacji modów ARK przez panel SGS Hub.

Wymagania wstępne

Przed instalacją modów upewnij się, że:

• ✅ Serwer ARK jest utworzony i widoczny w Dashboardzie
• ✅ Nie osiągnąłeś limitu modów dla swojego planu (zobacz Limity)
• ✅ Serwer ma wystarczająco miejsca na dysku (każdy mod = ~10-1000 MB)

Zaplanuj przed instalacją

Przed instalacją modów:

1. Zrób backup serwera (zakładka Backups → Create Backup)
2. Sprawdź kompatybilność modów (przeczytaj opisy na CurseForge)
3. Ustal load order (które mody mają być załadowane pierwsze)

Wyszukiwanie modów

Przez CurseForge

Krok 1: Otwórz zakładkę Mods

1. Przejdź do panelu serwera ARK
2. Kliknij zakładkę Mods
3. Kliknij przycisk Install Mod

Krok 2: Wyszukaj mod

1. Wybierz źródło: CurseForge (zalecane)
2. Wpisz nazwę moda w pole search
   • Przykład: "Structures Plus"
   • Przykład: "Awesome Spyglass"
3. Kliknij Search lub naciśnij Enter

Wyniki wyszukiwania:

Dla każdego moda zobaczysz:

• Nazwa - Pełna nazwa moda
• Autor - Twórca moda
• Wersja - Najnowsza dostępna wersja
• Downloads - Liczba pobrań (popularność)
• Ostatnia aktualizacja - Data ostatniego update'u
• Krótki opis - O czym jest mod

Krok 3: Sprawdź szczegóły moda

Kliknij mod aby zobaczyć pełne szczegóły:

• Full description - Dokładny opis funkcji
• Changelog - Historia zmian
• Requirements - Wymagane dependencies (inne mody)
• Known issues - Znane problemy
• Author notes - Notatki autora (np. konfiguracja)

Sprawdzaj requirements!

Jeśli mod wymaga innych modów (dependencies), zainstaluj je najpierw! Ignore dependencies = crash serwera.

Przykład: "Awesome Spyglass" wymaga "Structures Plus". Najpierw zainstaluj S+, potem Awesome Spyglass.

Przez ARK Wiki (Steam Workshop)

Kiedy używać: Gdy mod nie jest dostępny na CurseForge lub wolisz wersję ze Steama.

Krok 1: Znajdź Steam Workshop ID

1. Otwórz Steam Workshop dla ARK
2. Znajdź mod, który chcesz zainstalować
3. Kliknij mod aby otworzyć jego stronę
4. Skopiuj Workshop ID z URL
   • URL: https://steamcommunity.com/sharedfiles/filedetails/?id=731604991
   • Workshop ID: 731604991

Krok 2: Zainstaluj przez ARK Wiki

1. W zakładce Mods → Install Mod
2. Wybierz źródło: ARK Wiki
3. Wklej Workshop ID w pole "Mod ID"
4. Kliknij Install

Bulk install

Jeśli masz listę Steam Workshop IDs (np. z innego serwera), możesz wkleić wiele IDs oddzielonych przecinkami:

731604991,848591216,895711211

SGS Hub zainstaluje wszystkie mody jeden po drugim.

Instalacja moda

Proces instalacji:

1. Kliknij Install na wybranym modzie
2. SGS Hub dodaje mod do kolejki instalacji (BullMQ)
3. Status moda zmienia się na PENDING
4. Background worker pobiera request z kolejki
5. Status zmienia się na INSTALLING
6. Worker pobiera pliki moda z CurseForge/Steam
7. Worker instaluje mod do katalogu serwera: /ShooterGame/Content/Mods/
8. Worker aktualizuje GameUserSettings.ini:

   [ServerSettings]
   ActiveMods=731604991,848591216,895711211

9. Status zmienia się na INSTALLED

Czas instalacji:

• Small mod (UI, QoL): ~1-3 minuty
• Medium mod (items, structures): ~3-7 minut
• Large mod (dinos, maps): ~10-20 minut

Nie musisz czekać!

Możesz zamknąć panel serwera i zajmować się czymś innym. Workers działają w tle. Otrzymasz notyfikację (opcjonalnie email) gdy instalacja się zakończy.

Możesz także instalować wiele modów naraz - wszystkie pójdą do kolejki i będą instalowane po kolei przez dostępne workery.

Monitorowanie instalacji

Status moda

W zakładce Mods zobaczysz status każdego moda:

Status	Opis	Akcja
PENDING	Mod w kolejce, czeka na worker	Czekaj
INSTALLING	Worker pobiera i instaluje mod	Czekaj (1-20 min)
INSTALLED	Mod zainstalowany pomyślnie	Zrestartuj serwer
FAILED	Instalacja nie powiodła się	Sprawdź logi, spróbuj ponownie
REMOVING	Mod jest usuwany	Czekaj

Progress bar: Podczas INSTALLING, zobaczysz progress bar pokazujący:

• Pobieranie plików (0-70%)
• Rozpakowywanie (70-90%)
• Konfiguracja (90-100%)

Logi instalacji

Jeśli instalacja się nie powiedzie:

1. Kliknij mod ze statusem FAILED
2. Zobaczysz szczegóły błędu:
   • Error message - Komunikat błędu
   • Timestamp - Kiedy wystąpił błąd
   • Retry button - Spróbuj ponownie

Popularne błędy:

"Mod not found on CurseForge"

• Przyczyna: Mod został usunięty lub ID jest nieprawidłowe
• Rozwiązanie: Spróbuj ARK Wiki zamiast CurseForge

"Download failed: timeout"

• Przyczyna: CurseForge API rate limit lub problem z siecią
• Rozwiązanie: Poczekaj 5-10 minut i spróbuj ponownie

"Disk space full"

• Przyczyna: Brak miejsca na dysku
• Rozwiązanie: Usuń stare backupy lub nieużywane mody, lub upgrade planu

"Mod version incompatible"

• Przyczyna: Mod nie jest kompatybilny z Twoją wersją ARK (ASE vs ASA)
• Rozwiązanie: Sprawdź czy masz właściwą wersję moda

Restart serwera po instalacji

WAŻNE: Mody nie będą aktywne dopóki nie zrestartujesz serwera!

Po instalacji modów:

1. Sprawdź czy wszystkie mody mają status INSTALLED
2. Upewnij się, że load order jest poprawny (zobacz Wprowadzenie)
3. Kliknij przycisk Restart w headerze panelu
4. Poczekaj ~5-15 minut (serwer ładuje mody)
5. Sprawdź Console - szukaj wpisów Loaded mod: <ModName>

Nie zatrzymuj serwera podczas ładowania modów

Pierwsze ładowanie modów może zająć 10-20 minut dla serwerów z wieloma modami. Nie klikaj Stop podczas tego procesu! Może spowodować korupcję save'ów.

Obserwuj Console - poczekaj aż zobaczysz Server started lub Day 1, 00:00:00: Server Started.

Aktualizacja modów

SGS Hub automatycznie sprawdza aktualizacje modów co 24 godziny.

Automatyczna aktualizacja (zalecane)

Wymagania: Plan Starter lub wyższy

Włącz auto-update:

1. Zakładka Mods
2. Kliknij ikonę settings (⚙️) obok moda
3. Włącz toggle Auto-update
4. Kliknij Save

Co się dzieje:

• SGS Hub sprawdza CurseForge/Steam co 24h
• Jeśli jest nowa wersja, automatycznie pobiera
• Status moda zmienia się na UPDATING
• Po aktualizacji, serwer automatycznie restartuje o ustalonej godzinie (np. 4:00 AM)

Auto-restart

Auto-update zrestartuje serwer bez ostrzeżenia dla graczy! Ustaw godzinę restartu na czas niskiego ruchu (np. 3-5 AM).

Konfiguruj w: Mods → Auto-update Settings → Restart Time

Ręczna aktualizacja

Krok 1: Sprawdź dostępne aktualizacje

W zakładce Mods zobaczysz badge "Update available" obok modów z nowymi wersjami.

Krok 2: Zaktualizuj mod

1. Kliknij mod z dostępną aktualizacją
2. Kliknij przycisk Update
3. Poczekaj na zakończenie (status: UPDATING → INSTALLED)
4. Zrestartuj serwer

Krok 3: Sprawdź changelog

Po aktualizacji:

1. Kliknij mod → View Details
2. Przeczytaj Changelog aby zobaczyć co się zmieniło
3. Sprawdź czy są breaking changes (mogą wymagać dodatkowej konfiguracji)

Testuj aktualizacje modów

Duże aktualizacje modów mogą wprowadzać bugi lub breaking changes. Jeśli to możliwe:

1. Zrób Full Backup przed aktualizacją
2. Przetestuj na serwerze testowym
3. Po 24h bez problemów, zastosuj na production

Instalacja wielu modów naraz

Bulk install

Metoda 1: Przez listę

1. Zakładka Mods → Install Mod
2. Kliknij Bulk Install
3. Wklej listę Mod IDs (jeden per linijka):

   731604991
   848591216
   895711211

4. Kliknij Install All

Metoda 2: Import z pliku

1. Przygotuj plik mods.txt:

   731604991 | Structures Plus
   848591216 | Awesome Spyglass
   895711211 | Classic Flyers

2. Zakładka Mods → Import
3. Wybierz plik mods.txt
4. SGS Hub zaimportuje wszystkie mody

Metoda 3: Clone z innego serwera

1. Zakładka Mods → Clone from Server
2. Wybierz serwer źródłowy (z listy Twoich serwerów)
3. SGS Hub skopiuje wszystkie mody i load order
4. Kliknij Clone

Kolejność instalacji

Przy bulk install, mody instalują się po kolei (nie równolegle). Jeśli masz 10 modów po 5 minut każdy, całość zajmie ~50 minut.

Workery przetwarzają mody sekwencyjnie aby uniknąć race conditions w systemie plików.

Troubleshooting

Mod nie pojawia się w grze po restarcie

Sprawdź:

1. Console → Szukaj Loaded mod: <ModName> - jeśli nie ma, mod nie załadował się
2. Files → GameUserSettings.ini → Sprawdź sekcję ActiveMods - czy ID moda jest tam?
3. Files → /ShooterGame/Content/Mods/ → Czy folder moda istnieje?

Rozwiązanie:

• Jeśli brak w ActiveMods: Usuń i zainstaluj mod ponownie
• Jeśli brak folderu: Sprawdź logi instalacji, może download się nie powiódł
• Jeśli jest w ActiveMods i folder istnieje, ale nie ładuje: Konflikt z innym modem - sprawdź load order

Serwer crashuje po instalacji moda

Najczęstsze przyczyny:

1. Dependency brakuje - Zainstaluj wymagane mody
2. Load order nieprawidłowy - Uporządkuj zgodnie z instrukcjami autora moda
3. Mod incompatible - Sprawdź czy mod wspiera Twoją wersję ARK (ASE/ASA)
4. Corrupted download - Usuń mod i zainstaluj ponownie

Kroki debugowania:

1. Sprawdź Console podczas ładowania serwera
2. Szukaj wpisów ERROR lub FAILED
3. Skopiuj błąd i wyszukaj w Google lub Discord społeczności moda
4. Jeśli nic nie pomaga, usuń ostatnio zainstalowany mod

Mod zainstalował się, ale features nie działają

Możliwe przyczyny:

1. Mod wymaga konfiguracji - Sprawdź opis moda na CurseForge, może wymagać dodania linii do Game.ini
2. Permissions - Niektóre mody wymagają admin permissions w grze
3. Load order - Mod jest nadpisywany przez inny mod załadowany później

Rozwiązanie:

1. Przeczytaj dokładnie opis moda i sekcję "Configuration"
2. Sprawdź Game.ini i GameUserSettings.ini - może wymagają dodatkowych linii
3. Skontaktuj się z autorem moda (CurseForge comments, Discord)

Następne kroki

Po instalacji modów, przejdź do Zarządzania modami aby nauczyć się:

• Zmieniać load order
• Usuwać mody
• Rozwiązywać konflikty
• Monitorować wydajność