Notatki operatora
Dynmap: mapa serwera Minecraft w przeglądarce (port 8123)
Dynmap to plugin, który renderuje świat serwera do interaktywnej mapy w przeglądarce, z pozycjami graczy na żywo. Dla społeczności to jedna z najbardziej lubianych rzeczy na serwerze, dla operatora zaś temat na trzy pytania: jak otworzyć port, jak zrobić pierwszy render bez zabijania wydajności i ile to zje dysku. Odpowiadamy na wszystkie.
W skrócie: Wgraj .jar do plugins, zrestartuj serwer i otwórz port 8123 (TCP). Mapa działa pod http://IP_SERWERA:8123. Pierwszy pełny render zrób komendą /dynmap fullrender world na pustym serwerze, bo to operacja na godziny. Kafelki mapy potrafią zająć od kilku do kilkudziesięciu GB na dużym świecie. Port i liczbę map zmieniasz w configuration.txt.
Instalacja i pierwsze uruchomienie
Standardowa ścieżka pluginowa: pobierz Dynmap w wersji zgodnej z wersją gry, wgraj .jar do folderu plugins na serwerze Paper, Purpur lub Spigot i zrestartuj serwer. Istnieją też wydania dla serwerów z modami (Fabric, NeoForge, Forge), instalowane do folderu mods.
Po starcie Dynmap uruchamia własny serwer WWW wbudowany w plugin. Nie potrzebujesz Apache ani niczego dodatkowego: mapa jest serwowana bezpośrednio przez proces gry na porcie 8123.
Port 8123: bez tego mapa nie ruszy
Najczęstszy problem z Dynmap w ogóle nie dotyczy pluginu: mapa nie otwiera się, bo port 8123 (TCP) jest zamknięty. W zależności od tego, gdzie stoi serwer:
- Serwer w domu: przekieruj port 8123 na routerze, tak samo jak port gry. Cały proces opisaliśmy w poradniku o przekierowaniu portów.
- VPS: otwórz 8123 w firewallu systemowym (ufw, firewalld) i w panelu dostawcy, jeśli ma osobny firewall.
- Hosting zarządzany: sprawdź w panelu sekcję portów; część hostingów wymaga przypisania dodatkowego portu do usługi i wpisania go w konfiguracji Dynmap.
Mapę otworzysz w przeglądarce pod adresem http://IP_SERWERA:8123. Port zmienisz w pliku plugins/dynmap/configuration.txt, w ustawieniu webserver-port.
Pierwszy render: fullrender na pustym serwerze
Po instalacji mapa jest czarna, bo Dynmap renderuje teren dopiero wtedy, gdy coś się dzieje. Żeby zobaczyć cały dotychczas wygenerowany świat, wykonaj pełny render:
/dynmap fullrender world # cały świat "world"
/dynmap radiusrender 500 # albo tylko 500 kratek wokół ciebie
/dynmap cancelrender world # przerwanie renderu
I tu najważniejsza rada całego wpisu: fullrender dużego świata to operacja na godziny, która mocno obciąża procesor i dysk. Uruchamiaj ją, gdy serwer jest pusty, na przykład na noc. Bieżące zmiany (nowe budowle, wygenerowany teren) Dynmap dorenderowuje już sam, na bieżąco, niskim kosztem.
Z doświadczenia: zamiast renderować cały świat od razu, zrób najpierw radiusrender okolic spawna i głównych baz. Gracze zobaczą użyteczną mapę od pierwszego dnia, a pełny render dokończysz nocami, etapami. Nikt nie zauważy różnicy, a TPS w godzinach szczytu zostaje nietknięty.
Tryby mapy i configuration.txt
Dynmap potrafi utrzymywać kilka map jednocześnie, przełączanych w interfejsie przeglądarki:
| Mapa | Co pokazuje |
|---|---|
| flat | Widok z góry, jak klasyczna mapa 2D |
| surface | Widok izometryczny 3D powierzchni, domyślny wybór graczy |
| cave | Podgląd jaskiń i podziemi (przydatny adminom, niekoniecznie publiczny) |
| Nether / End | Osobne mapy pozostałych wymiarów |
Wszystkim steruje plugins/dynmap/configuration.txt (port, jakość, tempo renderowania) oraz pliki światów w worlds.txt. Dwie rzeczy, które najczęściej warto zmienić: wyłączyć mapy, których nikt nie ogląda (każda mapa to osobny render i osobne kafelki na dysku) oraz w razie potrzeby podnieść jakość renderu dla mapy głównej. Po każdej zmianie konfiguracji zrestartuj serwer albo wykonaj /dynmap reload.
Na mapie możesz też dodawać markery (punkty, obszary, ikony miast czy warpów) komendą /dmarker, a pozycje graczy na żywo są widoczne domyślnie i można je wyłączyć, jeśli społeczność woli prywatność.
Ile to zajmuje dysku
Dynmap zapisuje wyrenderowany świat jako kafelki graficzne. Na małym świecie survivalowym to setki megabajtów, ale duży, w pełni wyrenderowany świat z kilkoma mapami potrafi zająć od kilku do kilkudziesięciu gigabajtów. Jeśli miejsce na hostingu jest ograniczone:
- ogranicz liczbę map (czy naprawdę potrzebujesz osobnej mapy jaskiń i flat obok surface?),
- renderuj tylko obszar faktycznie używany przez graczy zamiast całego wygenerowanego terenu,
- rozważ obniżenie jakości kafelków w konfiguracji,
- duże instalacje mogą trzymać kafelki w bazie MySQL zamiast na plikach, co ułatwia backupy i przenosiny.
Wydajność: czy Dynmap laguje serwer
W codziennej pracy Dynmap jest tani: dorenderowuje tylko zmieniane fragmenty. Kosztowne są pełne rendery i one potrafią realnie zbić TPS na słabszej maszynie. Zasady są proste: fullrender na pustym serwerze, tempo renderowania można ograniczyć w konfiguracji, a jeśli po instalacji serwer zaczął przycinać, zajrzyj do naszego przewodnika po optymalizacji serwera Minecraft i sprawdź w raporcie spark, czy to na pewno Dynmap.
Dynmap, BlueMap czy squaremap
Dynmap ma dziś dwie popularne alternatywy i uczciwie jest o nich wspomnieć. BlueMap renderuje świat jako w pełni trójwymiarową scenę w przeglądarce i robi największe wrażenie wizualne. squaremap idzie w drugą stronę: minimalistyczna, lekka mapa 2D o niskim narzucie. Dynmap pozostaje standardem środka: dojrzały, stabilny, z markerami, wieloma mapami i największą bazą poradników. Wybór sprowadza się do tego, czego oczekuje społeczność; z perspektywy operatora wszystkie trzy instaluje się tak samo (plugin plus port), więc podmiana nie boli.
Najczęstsze problemy
| Objaw | Przyczyna i ratunek |
|---|---|
| Mapa nie otwiera się w przeglądarce | Zamknięty port 8123. Otwórz TCP 8123 w firewallu/routerze/panelu i sprawdź webserver-port w configuration.txt. |
| Mapa jest czarna | Brak pierwszego renderu. Wykonaj /dynmap fullrender world (na pustym serwerze) albo radiusrender. |
| Render trwa wieczność / TPS spada | Normalne przy fullrender dużego świata. Renderuj nocą, etapami, ogranicz tempo w konfiguracji. |
| Dysk się zapełnia | Kafelki map. Ogranicz liczbę map i renderowany obszar, obniż jakość. |
| Po zmianie konfiguracji nic się nie zmienia | Brak przeładowania: /dynmap reload albo restart serwera. |
Najczęstsze pytania
Jak zainstalować Dynmap?
.jar do folderu plugins, restart serwera, otwarcie portu 8123. Mapa działa pod http://IP_SERWERA:8123.
Na jakim porcie działa Dynmap?
Domyślnie TCP 8123. Zmiana w configuration.txt, ustawienie webserver-port.
Jak wyrenderować całą mapę?
/dynmap fullrender world, najlepiej na pustym serwerze, bo to operacja na godziny. Mniejszy obszar: /dynmap radiusrender promień.
Ile miejsca zajmuje Dynmap?
Od setek megabajtów do kilkudziesięciu gigabajtów na dużym, w pełni wyrenderowanym świecie z kilkoma mapami. Ogranicz liczbę map i obszar renderu, jeśli brakuje miejsca.
Dynmap czy BlueMap?
Dynmap to stabilny standard z markerami i największą bazą wiedzy, BlueMap daje widowiskowy widok 3D, squaremap jest najlżejszy. Instalacja wygląda tak samo, więc można bezboleśnie przetestować.
Powiązane
- Przekierowanie portów - jak otworzyć port 8123, gdy serwer stoi w domu.
- Optymalizacja serwera Minecraft - co robić, gdy render zbija TPS.
- Chunky: pre-generacja świata - wygeneruj teren z góry, zanim wyrenderujesz go na mapie.
- CoreProtect: logowanie zmian - drugi obowiązkowy plugin administracyjny.
- Hosting serwera Minecraft: na co zwrócić uwagę - w tym miejsce na dysku pod kafelki mapy.
- Oficjalne źródło: Dynmap na GitHubie.