Zarządzanie modami

Jak zarządzać zainstalowanymi modami, zmieniać kolejność ładowania i rozwiązywać konflikty.

Przeglądanie zainstalowanych modów

W zakładce Mods zobaczysz listę wszystkich zainstalowanych modów.

Informacje o modzie:

• Nazwa - Pełna nazwa moda
• Wersja - Aktualnie zainstalowana wersja
• Źródło - CurseForge lub ARK Wiki
• Rozmiar - Wielkość moda na dysku
• Status - INSTALLED, UPDATING, REMOVING
• Load order - Pozycja w kolejności ładowania (1, 2, 3...)
• Auto-update - Czy włączona automatyczna aktualizacja

Sortowanie i filtrowanie:

• Sortuj według: Nazwa, Rozmiar, Data instalacji, Load order
• Filtruj: Wszystkie, Tylko z auto-update, Tylko outdated

Zmiana load order (Drag & Drop)

Load order określa kolejność ładowania modów. Zobacz Wprowadzenie aby zrozumieć dlaczego to ważne.

Jak zmienić kolejność:

1. W zakładce Mods zobaczysz listę modów z ikonami uchwytu (⋮⋮)
2. Kliknij i przytrzymaj ikonę uchwytu obok moda
3. Przeciągnij mod w górę lub w dół
4. Upuść w nowej pozycji
5. Load order aktualizuje się automatycznie
6. Kliknij Save Changes na dole listy
7. Zrestartuj serwer aby zastosować nową kolejność

Restart jest OBOWIĄZKOWY

Zmiana load order bez restartu może spowodować:

• Konflikty modów
• Crashe serwera
• Korupcję save'ów
• Utratę postępów graczy

Zawsze restartuj serwer po zmianie load order!

Keyboard shortcuts:

• ↑ - Przesuń zaznaczony mod w górę
• ↓ - Przesuń zaznaczony mod w dół
• Home - Przesuń na początek listy
• End - Przesuń na koniec listy

Best practices:

1. Base mods na początku:

   1. Structures Plus (S+)
   2. Editable Server UI (ESUI)

2. Dependencies przed dependents:

   3. Structures Plus (dependency)
   4. Awesome Spyglass (wymaga S+)

3. Content mods w środku:

   5. Ark Additions
   6. Primal Fear

4. QoL/UI mods na końcu:

   7. Classic Flyers
   8. Better Dinos

Usuwanie modów

Usunięcie pojedynczego moda

Krok 1: Przygotuj serwer

Backup przed usunięciem!

Jeśli mod dodał nowe dinozaury, struktury lub przedmioty, ich usunięcie spowoduje permanentną utratę tych elementów z gry.

Zawsze zrób Full Backup przed usunięciem moda, aby móc przywrócić serwer jeśli coś pójdzie nie tak.

1. Zakładka Backups → Create Backup
2. Wybierz Full Backup
3. Poczekaj na zakończenie (~5-15 min)

Krok 2: Usuń mod

1. W zakładce Mods znajdź mod do usunięcia
2. Kliknij ikonę kosza (🗑️) obok moda
3. Pojawi się dialog potwierdzenia:

   Czy na pewno chcesz usunąć "Structures Plus"?
   
   ⚠️ UWAGA:
   - Wszystkie struktury/przedmioty dodane przez ten mod znikną z gry
   - Gracze stracą te przedmioty z inventory
   - Nie można tego cofnąć bez restore z backupu
   
   [ Cancel ] [ Remove Mod ]

4. Kliknij Remove Mod
5. Status zmienia się na REMOVING
6. Po zakończeniu mod znika z listy

Krok 3: Zrestartuj serwer

Zrestartuj serwer aby zastosować zmiany.

Co się dzieje podczas usuwania:

1. SGS Hub aktualizuje GameUserSettings.ini - usuwa Mod ID z ActiveMods
2. Worker usuwa folder moda z /ShooterGame/Content/Mods/
3. Czyści cache i metadata
4. Zwraca przestrzeń dyskową

Czas usuwania: ~30 sekund - 2 minuty

Usunięcie wielu modów naraz

Bulk remove:

1. Zakładka Mods
2. Zaznacz checkboxy obok modów do usunięcia
3. Kliknij Remove Selected (pojawia się po zaznaczeniu)
4. Potwierdź akcję
5. Wszystkie mody zostaną usunięte sekwencyjnie

Czyszczenie po usuniętych modach

Po usunięciu modów, mogą pozostać orphaned files (pliki bez właściciela).

Wyczyść orphaned files:

1. Zakładka Mods → Settings (⚙️)
2. Kliknij Cleanup Orphaned Files
3. SGS Hub skanuje /ShooterGame/Content/Mods/
4. Usuwa foldery modów, które nie są na liście ActiveMods
5. Zwraca przestrzeń dyskową

Kiedy używać:

• Po ręcznej edycji GameUserSettings.ini
• Gdy podejrzewasz, że mody nie zostały kompletnie usunięte
• Przed Full Backup (aby nie backupować śmieciowych plików)

Rozwiązywanie konfliktów modów

Identyfikacja konfliktu

Objawy konfliktu:

• ✗ Serwer crashuje podczas ładowania
• ✗ Serwer ładuje się, ale niektóre features modów nie działają
• ✗ Gracze widzą missing textures (różowe/czarne tekstury)
• ✗ Console pokazuje błędy typu "Mod conflict" lub "Failed to load asset"
• ✗ Serwer działa bardzo wolno (FPS drop)

Jak zdiagnozować:

1. Sprawdź Console podczas uruchamiania serwera
2. Szukaj wpisów:

   ERROR: Mod conflict detected
   WARNING: Asset override by multiple mods
   FAILED: Could not load mod XYZ

3. Notuj które mody są wymienione w błędach

Rozwiązanie konfliktu - metoda eliminacji

Metoda 1: Disable po jednym

1. Zrób backup aktualnej listy modów (screenshot lub notatka)
2. Usuń połowę modów
3. Zrestartuj serwer
4. Czy problem zniknął?
   • TAK → Konflikt jest w usuniętych modach
   • NIE → Konflikt jest w pozostałych modach
5. Przywróć połowę usuniętych, usuń połowę pozostałych
6. Powtarzaj aż znajdziesz problematyczny mod

Metoda 2: Fresh start

1. Usuń wszystkie mody
2. Zrestartuj serwer - upewnij się że działa
3. Dodawaj mody pojedynczo w kolejności load order
4. Po dodaniu każdego moda, zrestartuj i testuj
5. Gdy serwer crashnie, ostatnio dodany mod jest winowajcem

Metoda 3: Sprawdź known conflicts

1. Przejdź na stronę CurseForge każdego moda
2. Szukaj sekcji "Known Issues" lub "Incompatibilities"
3. Sprawdź Discord serwera moda
4. Wyszukaj Google: "<mod1>" "<mod2>" conflict

Popularne konflikty:

Mod A	Mod B	Problem	Rozwiązanie
Structures Plus	Awesome Spyglass v1.x	S+ overrides spyglass features	Użyj Awesome Spyglass v2.0+
Primal Fear	Ark Additions	Dino spawn conflicts	Zmień spawn weights w Game.ini
Total conversion mods	Dowolny inny mod	Total conversion mods nie są kompatybilne z innymi	Nie używaj innych modów
Extinction Core	Classic Flyers	Mechanic override	Nie łącz razem

Patchowanie konfliktów

Niektóre konflikty można rozwiązać przez konfigurację w INI.

Przykład: Dino spawn conflict

Jeśli dwa mody dodają różne dinozaury do tej samej mapy:

1. Otwórz Game.ini w zakładce Files
2. Dodaj custom spawn weights:

   [/Script/ShooterGame.ShooterGameMode]
   # Mod A dinos
   DinoSpawnWeightMultipliers=(DinoNameTag="ModA_Rex",SpawnWeightMultiplier=0.5)
   # Mod B dinos
   DinoSpawnWeightMultipliers=(DinoNameTag="ModB_Spino",SpawnWeightMultiplier=0.5)

3. Zapisz, zrestartuj serwer

Przykład: Engram conflict

Jeśli dwa mody dodają różne receptury dla tego samego przedmiotu:

1. Otwórz Game.ini
2. Użyj RemoveEngramEntry aby usunąć konfliktowy engram:

   RemoveEngramEntry=(EngramClassName="EngramEntry_Metal_Wall_C")

3. Pozostaw tylko jeden mod z tym engramem aktywny

Patches w opisach modów

Wielu autorów modów publikuje compatibility patches dla popularnych kombinacji modów. Sprawdzaj sekcję "Files" na CurseForge - mogą być dodatkowe pliki .ini do skopiowania.

Monitorowanie wydajności modów

Mody wpływają na wydajność serwera. Monitoruj metryki aby zidentyfikować problematyczne mody.

Metryki per mod (Zaawansowane)

SGS Hub nie oferuje jeszcze per-mod metrics, ale możesz monitorować ogólną wydajność:

Przed zainstalowaniem nowego moda:

1. Zanotuj: CPU usage, RAM usage, Uptime, FPS (jeśli masz dostęp)
2. Zainstaluj mod i zrestartuj
3. Poczekaj 1-2 godziny na stabilizację
4. Porównaj metryki:
   • RAM wzrosło >500MB → Mod jest resource-heavy
   • CPU wzrosło >15% → Mod jest CPU-intensive
   • FPS spadło >10 → Mod wpływa na wydajność graczy

Akcje gdy mod obniża wydajność:

• Sprawdź settings moda - może ma opcje optymalizacji
• Zmniejsz spawn rates lub limits w Game.ini
• Rozważ alternatywny mod z podobnymi features
• Upgrade planu subskrypcji (więcej RAM/CPU)

Mod size vs performance

Ogólna reguła:

Rozmiar moda	RAM impact	CPU impact	Typowe przykłady
<50 MB	Minimalny (+50-100 MB)	Minimalny (+2-5%)	UI mods, small QoL
50-200 MB	Średni (+200-400 MB)	Średni (+5-10%)	Structure packs, item mods
200-500 MB	Wysoki (+400-800 MB)	Wysoki (+10-20%)	Dino mods, map extensions
>500 MB	Bardzo wysoki (+1-2 GB)	Bardzo wysoki (+20-40%)	Total conversions, large map mods

Zalecenia:

• Plan Starter (4GB RAM): Maks. 5-10 small mods
• Plan Pro (8GB RAM): Maks. 10-20 mods (mixed sizes)
• Plan Enterprise (16GB RAM): 30+ mods lub large total conversion

Eksport i import konfiguracji modów

Eksport listy modów

Przydatne gdy chcesz przenieść mody na inny serwer lub udostępnić innym.

Krok 1: Eksport

1. Zakładka Mods → Export
2. Wybierz format:
   • JSON - Pełna konfiguracja (IDs, versions, load order)
   • TXT - Prosta lista Mod IDs (jeden per linia)
   • CSV - Tabela (ID, Name, Version, Source)
3. Kliknij Download

Przykład JSON:

{
  "mods": [
    {
      "id": "731604991",
      "name": "Structures Plus (S+)",
      "version": "2.54",
      "source": "CURSEFORGE",
      "loadOrder": 1
    },
    {
      "id": "848591216",
      "name": "Awesome Spyglass",
      "version": "3.2",
      "source": "ARK_WIKI",
      "loadOrder": 2
    }
  ]
}

Przykład TXT:

731604991
848591216
895711211

Import listy modów

Krok 1: Przygotuj plik

Przygotuj plik w jednym z formatów powyżej.

Krok 2: Import

1. Zakładka Mods → Import
2. Wybierz plik (JSON, TXT lub CSV)
3. SGS Hub parsuje plik i pokazuje preview:

   Znaleziono 15 modów do zaimportowania:
   ✓ Structures Plus - Found on CurseForge
   ✓ Awesome Spyglass - Found on ARK Wiki
   ✗ Unknown Mod (ID: 12345678) - Not found
   
   [ Cancel ] [ Import 14 Valid Mods ]

4. Kliknij Import X Valid Mods
5. Mody instalują się automatycznie w tle
6. Poczekaj na zakończenie (status: INSTALLING → INSTALLED)
7. Zrestartuj serwer

Backup przed importem

Import może zainstalować wiele modów naraz. Zrób backup przed importem, aby móc szybko przywrócić serwer jeśli coś pójdzie nie tak.

Best practices zarządzania modami

Do's ✅

• ✅ Zawsze rób backup przed zmianami - Full Backup przed dodaniem/usunięciem modów
• ✅ Testuj mody na serwerze testowym - Clone serwera, testuj tam najpierw
• ✅ Czytaj changelogi przy aktualizacjach - Autor może wprowadzić breaking changes
• ✅ Używaj auto-update ostrożnie - Włączaj tylko dla stabilnych, trusted modów
• ✅ Dokumentuj load order - Zanotuj dlaczego mody są w tej kolejności
• ✅ Monitoruj wydajność - Sprawdzaj RAM/CPU po każdej zmianie
• ✅ Informuj graczy - Ostrzegaj przed restartem związanym z modami

Don'ts ❌

• ❌ Nie zmieniaj load order bez restartu - Grozi korupcją save'ów
• ❌ Nie instaluj za dużo modów naraz - Trudno zidentyfikować problemy
• ❌ Nie używaj total conversion + innych modów - Konflikty gwarantowane
• ❌ Nie ignoruj warnings w Console - Wczesne wykrycie problemów
• ❌ Nie usuwaj modów bez backupu - Ryzyko utraty danych
• ❌ Nie aktualizuj modów w środku eventu - Gracze będą niezadowoleni z przestoju
• ❌ Nie mieszaj ASE i ASA modów - Kompletnie incompatible

Następne kroki

• FiveM Resources - Zarządzanie resources dla serwerów FiveM
• Pliki i backupy - System plików i kopie zapasowe
• Troubleshooting - Rozwiązywanie problemów z modami