Wprowadzenie do modów

Mody (modyfikacje) rozszerzają funkcjonalność serwerów ARK, dodając nowe dinozaury, struktury, mechaniki i wiele więcej.

Czym są mody ARK?

Mody to społecznościowe dodatki stworzone przez graczy i twórców, które zmieniają lub rozszerzają podstawową grę ARK.

Przykłady popularnych modów:

• Structures Plus (S+) - Ulepszone budowanie, QoL features
• Awesome Spyglass - Zaawansowany teleskop do sprawdzania statystyk dino
• Classic Flyers - Przywraca system levelowania latających stworzeń
• Ark Additions - Nowe gatunki dinozaurów (Deinosuchus, Concavenator, etc.)
• Editable Server UI (ESUI) - Custom UI dla serwerów

Źródła modów

SGS Hub wspiera dwa główne źródła modów dla ARK:

CurseForge

Zalety:

• ✅ Oficjalna platforma wspierana przez Studio Wildcard
• ✅ Szybkie pobieranie
• ✅ Automatyczne aktualizacje
• ✅ Wersjonowanie (możesz wybrać konkretną wersję moda)
• ✅ Szczegółowe opisy i changelogi

Wady:

• ❌ Mniej modów niż na Steam Workshop (niektóre mody są tylko na Steam)

Jak działa w SGS Hub:

1. SGS Hub łączy się z CurseForge API
2. Pobiera metadane moda (nazwa, autor, wersja)
3. Dodaje mod do kolejki BullMQ
4. Worker pobiera pliki moda w tle
5. Instaluje mod do katalogu serwera
6. Aktualizuje GameUserSettings.ini

ARK Wiki (Steam Workshop)

Zalety:

• ✅ Największa biblioteka modów ARK
• ✅ Darmowe i otwarte dla twórców
• ✅ Integracja ze Steamem

Wady:

• ❌ Wolniejsze pobieranie (Steam API rate limits)
• ❌ Brak oficjalnego API (SGS Hub używa web scrapingu)
• ❌ Czasami outdated metadata

Jak działa w SGS Hub:

1. SGS Hub scrapuje stronę ARK Wiki
2. Pobiera informacje o modzie (Steam Workshop ID, nazwa)
3. Używa SteamCMD do pobrania moda
4. Instaluje i konfiguruje

Która opcja wybrać?

• CurseForge - Pierwsza opcja, szybsze i bardziej niezawodne
• ARK Wiki - Używaj gdy mod nie jest dostępny na CurseForge

Sprawdź CurseForge najpierw. Jeśli mod nie istnieje tam, spróbuj ARK Wiki.

Load Order (kolejność ładowania)

Load order określa kolejność, w jakiej ARK ładuje mody podczas uruchamiania serwera.

Dlaczego load order jest ważny?

Konflikty modów: Jeśli dwa mody modyfikują tę samą część gry (np. crafting recipes), mod załadowany później nadpisze zmiany moda załadowanego wcześniej.

Przykład:

• Mod A: zmienia wymagania crafting dla Metal Wall na 50 Metal
• Mod B: zmienia wymagania crafting dla Metal Wall na 100 Metal
• Load order: A, B → Metal Wall wymaga 100 Metal (B nadpisuje A)
• Load order: B, A → Metal Wall wymaga 50 Metal (A nadpisuje B)

Dependencje: Niektóre mody wymagają innych modów (dependencies). Mod dependency musi być załadowany przed modem głównym.

Przykład:

• "Awesome Spyglass" wymaga "Structures Plus"
• Poprawny load order: Structures Plus, Awesome Spyglass
• Błędny load order: Awesome Spyglass, Structures Plus → Crash serwera!

Ustalanie load order

Ogólne zasady:

1. Base mods (S+, ESUI) - zawsze na początku
2. Dependencies - przed modami, które ich wymagają
3. Content mods (nowe dino, items) - w środku
4. QoL/UI mods - na końcu

Przykładowy load order:

1. Structures Plus (S+)           [BASE]
2. Awesome SpyGlass                [wymaga S+]
3. Ark Additions: The Collection  [content]
4. Classic Flyers                  [mechanika]
5. Editable Server UI (ESUI)      [UI]

Restart po zmianie load order

Zawsze restartuj serwer po zmianie kolejności modów! Zmiana load order bez restartu może spowodować korupcję save'ów.

Kompatybilność modów

ARK ASE vs ARK ASA

Ważne: Mody dla ARK: Survival Evolved (ASE) NIE są kompatybilne z ARK: Survival Ascended (ASA) i odwrotnie!

• ARK ASE używa Unreal Engine 4
• ARK ASA używa Unreal Engine 5
• Mody muszą być przepisane dla nowej wersji gry

W SGS Hub: Podczas wyszukiwania modów, system automatycznie filtruje wyniki według wersji gry Twojego serwera (ASE lub ASA).

Konflikty modów

Jak rozpoznać konflikt:

• Serwer crashuje podczas ładowania
• Logi pokazują "Mod conflict" lub "Failed to load mod"
• Niektóre features modów nie działają
• Gracze widzą missing textures lub błędy

Jak rozwiązać:

1. Sprawdź opisy modów na CurseForge/Steam - często autor wymienia incompatible mody
2. Testuj mody pojedynczo - dodawaj po jednym i testuj restart
3. Sprawdź load order - upewnij się że dependencies są poprawnie ustawione
4. Skontaktuj się z autorem moda (Discord, CurseForge comments)

Popularne konflikty:

• Structures Plus + Classic Flyers - znany konflikt, wymaga specjalnej konfiguracji
• Total conversion mods (Primitive+, Extinction Core) - nie używaj z innymi modami content

Testuj mody na serwerze testowym

Jeśli planujesz zainstalować wiele nowych modów, stwórz testowy serwer (clone głównego), przetestuj mody tam najpierw, następnie zastosuj na production. Zapobiega to przestojom i niezadowolonym graczom.

Wydajność i mody

Każdy mod zwiększa zużycie zasobów serwera.

Wpływ na zasoby:

Typ moda	RAM	CPU	Disk	Load time
Small (UI, QoL)	+50-200 MB	+5%	+10-50 MB	+10s
Medium (items, structures)	+200-500 MB	+10-15%	+50-200 MB	+30s
Large (dinos, maps)	+500-1500 MB	+20-30%	+200-1000 MB	+60-120s
Total conversion	+1-3 GB	+30-50%	+1-5 GB	+2-5 min

Przykład: Serwer z 20 modami może wymagać dodatkowe 2-4 GB RAM i 5-10 minut na pierwsze uruchomienie.

Best practices:

• Używaj tylko modów, które rzeczywiście potrzebujesz
• Regularnie sprawdzaj czy gracze używają features danego moda
• Usuń nieużywane mody
• Monitoruj RAM usage w panelu serwera

Licencje i prawo autorskie

Ważne uwagi prawne:

• ✅ Mody z CurseForge i Steam Workshop są bezpłatne dla serwerów prywatnych i publicznych
• ❌ Nie modyfikuj plików modów (naruszenie ToS)
• ❌ Nie redistrybuuj modów (hostuj je samodzielnie)
• ✅ Możesz używać modów na serwerach komercyjnych (z reklamami, donations), ale sprawdź licencję konkretnego moda
• ✅ Respektuj autorów - daj credits w server description

Mods jako własność autora

Autorzy modów zachowują pełne prawa autorskie. Jeśli autor zdecyduje usunąć mod z CurseForge/Steam, Twój serwer może przestać działać po następnej aktualizacji. Zawsze miej backup!

Następne kroki

Przejdź do Instalacji modów aby dowiedzieć się jak wyszukiwać i instalować mody w SGS Hub.