Troubleshooting: Mody

Rozwiązywanie problemów z instalacją i zarządzaniem modami.

Instalacja moda nie kończy się

Problem: Status "INSTALLING" przez długi czas (>30 minut)

Oczekiwany czas instalacji:

• Małe mody (<100 MB): 2-5 minut
• Średnie mody (100-500 MB): 5-15 minut
• Duże mody (>500 MB): 15-30 minut

Jeśli przekroczyłeś te czasy:

Krok 1: Sprawdź postęp

Dashboard → Servers → [Serwer] → Mods
Kliknij mod → sprawdź "Progress: X%"

Krok 2: Sprawdź czy worker działa

• Jeśli progress = 0% przez >10 min → worker crashed
• Rozwiązanie: Cancel instalację → Install ponownie

Krok 3: Sprawdź dostępność CurseForge

• Odwiedź curseforge.com
• Jeśli strona nie działa → API CurseForge down
• Poczekaj 30-60 min i spróbuj ponownie

Krok 4: Cancel i retry

Dashboard → Mods → [Mod] → ⋮ → Cancel Installation
Poczekaj 1 minutę → Install ponownie

Problem: Status zmienia się na "FAILED"

Sprawdź szczegóły błędu:

Dashboard → Mods → [Mod z failed] → kliknij
Error message: "..."

Częste błędy:

Error message	Przyczyna	Rozwiązanie
Mod not found (404)	Mod usunięty z CurseForge lub błędne ID	Sprawdź ID moda na CurseForge, wpisz ponownie
Download failed (timeout)	Wolne połączenie lub CDN problem	Retry instalacji za 5-10 minut
Insufficient storage	Brak miejsca na dysku	Usuń stare backupy lub ulepsz plan
Mod incompatible with ARK ASA	Mod tylko dla ARK ASE	Znajdź wersję ASA moda lub alternatywę
File extraction failed	Corrupted download	Remove mod → Install ponownie

Uniwersalne rozwiązanie:

1. Dashboard → Mods → Remove failed mod
2. Poczekaj 30 sekund
3. Install mod ponownie
4. Jeśli 3x failed → skontaktuj się z supportem (podaj mod ID)

Konflikt modów

Problem: Serwer nie startuje po zainstalowaniu nowego moda

Diagnoza:

Krok 1: Identyfikuj winny mod

Dashboard → Mods → sprawdź który mod zainstalowałeś jako ostatni

Krok 2: Sprawdź znane konflikty

Popularne konflikty ARK:

Mod A	Konfliktuje z	Dlaczego	Rozwiązanie
Structures Plus	Eco's RP Decor	Oba modyfikują system budowania	Wybierz jeden lub użyj S+ jako pierwszy
Classic Flyers	Awesome Spyglass (niektóre wersje)	Konflikt stat calculations	Zaktualizuj oba do najnowszych wersji
Super Structures	Structures Plus	Duplicate functionality	Nigdy nie używaj razem, wybierz jeden
Dino Storage v2	ARK Additions (niektóre dinos)	Konflikt cryo mechanics	Użyj soul balls TYLKO dla vanilla dinos

Krok 3: Test eliminacji

1. Dashboard → Mods → Disable ostatnio dodany mod
2. Restart serwera
3. Jeśli startuje → znalazłeś winnego
4. Remove mod lub szukaj aktualizacji/alternatywy

Problem: Mody działają, ale gracze crashują przy join

Przyczyna: Gracze nie mają zainstalowanych tych samych modów co serwer.

Rozwiązanie dla graczy:

ARK (Steam Workshop):

1. Znajdź mod IDs serwera (Dashboard → Mods → lista mod IDs)
2. Gracze subskrybują każdy mod w Steam Workshop:

   Steam → Community → Workshop → ARK
   Wpisz mod ID → Subscribe

3. Uruchom ARK (mody pobiorą się automatycznie)
4. Join server

ARK (CurseForge):

• Gracze muszą zainstalować CurseForge App
• Lub użyć manual download z CurseForge

FiveM:

• Mody pobierają się automatycznie z serwera
• Jeśli crash → sprawdź czy mod wymaga client-side plików

Kolejność ładowania (Load Order)

Problem: "Mod X must be loaded before mod Y"

Przyczyna: Niektóre mody muszą być w określonej kolejności.

Ogólne zasady load order:

0. Core mods (S+, Ultra Stacks)
1. Map mods (custom maps)
2. Creature mods (Dino additions)
3. Item/weapon mods
4. Quality of Life mods
5. Cosmetic mods (last)

Przykład dobrej kolejności:

Order 0: Structures Plus
Order 1: ARK Additions - The Collection
Order 2: Awesome Spyglass
Order 3: Dino Storage v2
Order 4: Ultra Stacks
Order 5: Editable Server UI

Jak zmienić kolejność:

Dashboard → Mods → Drag & drop mody (przeciągnij)
Lub:
Kliknij mod → Change Order → wpisz numer → Save

Po zmianie kolejności:

1. Save changes
2. Restart serwera (obowiązkowe!)

Problem: Mod ładuje się, ale features nie działają

Przykład: S+ zainstalowane, ale enhanced snap points nie działają.

Przyczyny:

1. Mod nie aktywowany w GameUserSettings.ini

Niektóre mody wymagają dodania do INI:

Dashboard → Files → GameUserSettings.ini

[ServerSettings]
ActiveMods=928990,1404697612,731604991

[Dodaj na końcu pliku]

2. Mod wymaga konkretnych ustawień

Przykład dla Structures Plus:

[/Script/ShooterGame.ShooterGameMode]
bAllowUnlimitedRespecs=True
bAllowPlatformSaddleMultiFloors=True

Sprawdź dokumentację moda (CurseForge → Files → Description).

3. Mod outdated

Dashboard → Mods → [Mod] → Check for Updates
Jeśli dostępna: Update → Restart serwera

Mod zużywa za dużo zasobów

Problem: Po dodaniu moda serwer laguje (high CPU/RAM)

Heavy mods (znane z high resource usage):

• Primal Fear - +2-3 GB RAM
• Ark Eternal - +3-4 GB RAM
• Structures Plus - +500 MB RAM
• Ultra Stacks - +200 MB RAM (minimal impact)

Rozwiązania:

1. Sprawdź resource usage per mod

Dashboard → Mods → [Mod] → kliknij
Estimated RAM: ~500 MB  (jeśli pokazane)

2. Zwiększ RAM jeśli możliwe

Dashboard → Settings → Resources
Memory: 8GB → 12GB (jeśli plan pozwala)

3. Znajdź lightweight alternative

Heavy mod	Lightweight alternative
Structures Plus	Vanilla building + Quality of Life tweaks
Primal Fear	Ark Additions (mniej creatures)
Automation mod	Simple manual automation

4. Ogranicz mod scope

Niektóre mody mają config:

Files → Mods → [ModName] → config.json
Wyłącz niepotrzebne features

Auto-update modów

Problem: Mod auto-update zepsuł serwer

Symptom: Serwer działał, po auto-update nie startuje.

Wyłącz auto-update dla problematycznego moda:

Dashboard → Mods → [Mod] → ⋮ → Settings
Auto-update: OFF
Save

Przywróć poprzednią wersję:

Dashboard → Mods → [Mod] → Version History
Wybierz poprzednią wersję → Install
Restart serwera

Najlepsze praktyki:

1. Wyłącz auto-update dla core modów (S+, ARK Additions)
2. Testuj updates na dev serwerze przed produkcją
3. Utwórz backup przed manual update:

   Dashboard → Backups → Create Backup (THIN)
   Mods → Update mod → Restart
   Test → jeśli OK, usuń backup

Gracze widzą różne itemy niż serwer

Problem: Mismatch modów między serwerem a klientem

Przyczyna: Mod IDs różne lub mod niepobrany przez gracza.

Rozwiązanie:

1. Wyeksportuj listę modów:

Dashboard → Mods → Export → Copy to Clipboard
Wyślij graczom (Discord, etc.)

2. Gracze weryfikują swoje mody:

ARK folder → ShooterGame → Content → Mods
Sprawdź czy są foldery z tymi samymi ID

3. Force mod refresh (gracze):

Steam → Library → ARK → Right-click → Properties
Local Files → Verify Integrity of Game Files

4. Manual mod list (serwer):

Dashboard → Files → GameUserSettings.ini
[ServerSettings]
ActiveMods=928990,1404697612  (bez spacji!)

Powiązane strony

• Guides: Instalacja modów
• Guides: Zarządzanie modami
• Troubleshooting: Serwery
• FAQ