# Wgrywanie własnej mapy na serwer

Wgranie własnego świata pozwala przenieść mapę z trybu jednoosobowego (singleplayer), z innego hostingu lub wgrać pobraną mapę przygodową (adventure / escape room / lobby).

Poniższy poradnik pokazuje, jak poprawnie przesłać świat na serwer w BlackHost, uwzględniając różnice w strukturze plików między silnikami Paper/Spigot a Fabric/Forge.

## 1. Przygotuj pliki mapy

Jeśli przenosisz mapę ze swojego komputera:

1. Wciśnij skrót `Win + R`, wpisz `%appdata%\.minecraft\saves` i zatwierdź enterem.
2. Odszukaj folder ze swoim światem.
3. Upewnij się, że wewnątrz folderu znajduje się plik `level.dat` – jest to plik nagłówkowy świata. Bez niego serwer nie rozpozna mapy i wygeneruje nowy, pusty świat.

## 2. Zatrzymaj serwer

Przejdź do zakładki **Konsola** w panelu i kliknij **Zatrzymaj**.

> ⚠️ **Ważne:** Nigdy nie podmieniaj plików świata na działającym serwerze. Spowoduje to uszkodzenie chunków lub natychmiastowe nadpisanie Twoich plików przez serwer.

## 3. Zwróć uwagę na strukturę silnika

Struktura folderów świata różni się w zależności od tego, jakiego silnika używasz:

* **Silniki Vanilla / Fabric / Forge:**  
  Wszystkie wymiary znajdują się wewnątrz jednego głównego folderu `world`:
  * `world/` – świat zwykły (Overworld)
  * `world/DIM-1/` – Nether
  * `world/DIM1/` – End
* **Silniki Paper / Purpur / Spigot:**  
  Silniki te domyślnie rozdzielają wymiary na trzy osobne foldery w głównym katalogu serwera:
  * `world/` – Overworld
  * `world_nether/` – Nether
  * `world_the_end/` – End

## 4. Prześlij mapę przez SFTP

1. Połącz się z serwerem za pomocą klienta SFTP (np. WinSCP) zgodnie z poradnikiem [Łączenie się poprzez SFTP](/dashboard/sftp).
2. Jeśli na serwerze istnieje już stary folder `world`, zmień jego nazwę (np. na `world_old`) lub usuń go.
3. Prześlij przygotowany folder z mapą bezpośrednio do głównego katalogu serwera i upewnij się, że jego nazwa to `world`.

   ![Przesyłanie plików SFTP](/public/sftpready.png)

## 5. Sprawdź nazwę świata w server.properties

1. W **Menedżerze plików** otwórz plik `server.properties`.
2. Odszukaj parametr `level-name` i upewnij się, że jego wartość odpowiada nazwie przesłanego folderu:
   ```properties
   level-name=world
   ```
3. Zapisz plik.

## 6. Uruchom serwer

Wróć do konsoli i uruchom serwer. Serwer załaduje wgrany świat wraz ze strukturami, koordynatami i poziomem trudności.

---

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

**❔ Serwer zignorował wgraną mapę i wygenerował losowy świat – dlaczego?**  
Najczęstszą przyczyną jest brak pliku `level.dat` w głównym katalogu wgranego folderu (często zdarza się zagnieżdżenie folderu w folderze, np. `world/NazwaMapy/level.dat` zamiast bezpośrednio `world/level.dat`).

**❔ Jak zresetować tylko Nether lub End bez usuwania głównego świata?**  
Wyłącz serwer, przejdź do SFTP i usuń folder `world_nether` (w Paper/Spigot) lub podfolder `DIM-1` (w Fabric/Forge). Przy kolejnym uruchomieniu serwer wygeneruje świeży wymiar z nowymi surowcami.