# Wgrywanie paczek modów (CurseForge / Modrinth)

Paczki modów (tzw. modpacki, np. *All The Mods*, *Better MC*, *RLCraft*) potrafią całkowicie odmienić rozgrywkę w Minecraft. Jednak uruchomienie paczki modów na serwerze różni się od instalacji w launcherze na komputerze.

> ⚠️ **Najczęstszy błąd - Client Pack vs Server Pack:**  
> Klikając główny przycisk **Download** na stronie modpacka w CurseForge lub Modrinth, pobierasz paczkę dla klienta gry (zawierającą mody graficzne, shadery, interfejs i resource packi). Taka paczka nie posiada plików serwera i spowoduje crash. Na serwer należy pobrać dedykowany **Server Pack** (tzw. *Server Files*).

## 1. Pobierz dedykowany Server Pack

* **CurseForge:** wejdź na stronę modpacka, otwórz zakładkę **Files**, kliknij wersję paczki, zjedź na dół do sekcji **Additional Files** i pobierz plik oznaczony jako **Server Files**.
* **Modrinth:** wejdź w zakładkę **Versions**, kliknij wybraną wersję i z listy plików pobierz **Server Pack**.

## 2. Dobierz silnik i wersję Javy w panelu

W panelu BlackHost ustaw odpowiedni silnik (najczęściej **Forge**, **Fabric** lub **NeoForge**) oraz wersję gry dopasowaną do paczki:

   ![Wybór silnika](/public/wyborsilnika.png)

Dopasuj wersję środowiska Java do wersji Minecrafta:

* **Minecraft 1.12.2 i starsze:** Java 8
* **Minecraft 1.16.5:** Java 8 lub Java 11
* **Minecraft 1.17.x:** Java 16
* **Minecraft 1.18 - 1.20.4:** Java 17
* **Minecraft 1.20.5 i nowsze:** Java 21

## 3. Prześlij pliki na serwer przez SFTP

1. Rozpakuj pobrane archiwum Server Pack na swoim komputerze.
2. Połącz się z serwerem przez SFTP (zgodnie z poradnikiem [Łączenie się poprzez SFTP](/dashboard/sftp)).
3. Jeśli serwer był wcześniej uruchamiany, usuń stare foldery `mods` oraz `config`.
4. Prześlij zawartość rozpakowanego folderu bezpośrednio do głównego katalogu serwera.

   ![Pliki na serwerze](/public/sftpready.png)

## 4. Zaakceptuj EULA i uruchom serwer

1. Przejdź do zakładki **Konsola** i uruchom serwer.
2. Jeśli serwer zatrzyma się z komunikatem o licencji EULA, otwórz plik `eula.txt` w **Menedżerze plików**, zmień `eula=false` na `eula=true` i zapisz plik.
3. Ponownie uruchom serwer.

> ⏳ **Uwaga:** Duże paczki modów przy pierwszym uruchomieniu generują konfiguracje i pobierają biblioteki. Pierwszy start może zająć od 5 do 15 minut.

---

## 💡 Najczęściej zadawane pytania (FAQ)

**❔ Serwer crashuje z błędem "Mod X attempted to register client only class" - co zrobić?**  
W folderze `mods/` znajduje się modyfikacja wyłącznie kliencka (np. Oculus, Rubidium, shadery). Odszukaj plik `.jar` wskazanego moda i usuń go z serwera.

**❔ Błąd "Out of Memory" przy starcie - jak naprawić?**  
Większość nowszych paczek modów (1.18+) wymaga co najmniej 6-8 GB pamięci RAM do stabilnego działania. Upewnij się, że Twój pakiet serwera dysponuje odpowiednią ilością pamięci.