BlueMap — wtyczka do generowania interaktywnej mapy 3D świata w przeglądarce dla Minecraft

BlueMap — wtyczka do generowania interaktywnej mapy 3D świata w przeglądarce dla Minecraft

BlueMap to wtyczka dla Minecraft, która odczytuje pliki świata i buduje z nich trójwymiarowy model powierzchni dostępny w przeglądarce za pośrednictwem wbudowanego serwera WWW. Standardowy klient renderuje świat tylko wokół gracza i nie daje widoku z góry ani z zewnątrz. Wtyczka tworzy pełną mapę z możliwością obracania kamery, przełączania w tryb perspektywiczny lub izometryczny (flat) oraz oglądania struktur poprzez zwykłe przejście pod adres URL. Rozwiązuje jeden problem: zewnętrzne oglądanie świata na serwerze bez konieczności logowania się do gry.

Jak działa renderowanie

Wtyczka dzieli chunki na kafelki i generuje dwie warstwy szczegółowości: modele hires z pełną geometrią bloków oraz mapę lowres do widoku z daleka. Hires jest aktywny przy dużym przybliżeniu — wtedy widoczne są konkretne bloki, tekstury i wysokości. Przy dalszym oddaleniu ładuje się uproszczona warstwa z kolorowymi plamami biomów i krajobrazem.

Proces renderowania w interfejsie WWW: kafelki ładują się stopniowo podczas przybliżania. 

Renderowanie wykonywane jest asynchronicznie w oddzielnej puli wątków. Główny wątek serwera Minecraft nie jest przy tym blokowany — dopóki procesor ma wolne rdzenie, gracze nie odczują opóźnień z powodu budowania mapy. Wtyczka sama śledzi zmiany w świecie: BlueMap okresowo sprawdza pliki mca, wykrywa zmienione chunki i ponownie renderuje tylko te. Ręczne komendy typu /bluemap update są rzadko potrzebne — głównie do diagnostyki.

Render w interfejsie WWW z perspektywy pierwszej osoby 

Komendy

Wtyczka rejestruje jedną komendę główną /bluemap z podkomendami. Większość przypadków nie wymaga żadnej komendy — renderowanie działa automatycznie.

Wykonywanie komendy /bluemap 

Konfiguracja

Folder wtyczki zawiera cztery pliki konfiguracyjne: core.conf, plugin.conf, webapp.conf, webserver.conf. A także trzy podfoldery: maps/ (po jednym .conf dla każdego świata), packs/ (paczki zasobów dla renderowania) i storages/ (file.conf dla systemu plików, sql.conf dla bazy SQL).

core.conf

Główny plik. Kluczowy parametr to accept-download, który musi być ustawiony na true przy pierwszym uruchomieniu. Parametr render-thread-count (domyślnie 1) ustawia liczbę wątków renderowania — wartość ujemna oznacza «liczbę rdzeni procesora minus wartość bezwzględna liczby». metrics (true) kontroluje wysyłanie anonimowych statystyk.

plugin.conf

Parametry widoczności graczy na mapie i zachowania renderowania:

webapp.conf

Ustawienia aplikacji WWW. default-to-flat-view (false) określa widok początkowy — perspektywiczny lub izometryczny. Suwaki hires-slider-default (100) oraz lowres-slider-default (2000) ustalają dystans szczegółowego i uproszczonego renderowania w blokach. resolution-default (1) przyjmuje wartości 0.5, 1 lub 2. Tablice scripts i styles dołączają niestandardowe pliki JS i CSS.

webserver.conf

Wbudowany serwer WWW. enabled (true) — włącz lub wyłącz. port (8100) — port. webroot ("bluemap/web") — katalog z plikami aplikacji WWW (musi się zgadzać z webroot w webapp.conf). Sekcja log konfiguruje zapis aktywności HTTP do pliku.

Podsumowanie

BlueMap daje możliwość zewnętrznego oglądania świata w formie pełnoprawnego modelu 3D z obrotem kamery i swobodnym lotem. Wtyczka dobrze sprawdza się na serwerach survival i RPG, gdzie gracze mogą dzielić się koordynatami i podziwiać budowle; dla serwerów minigier bez stałego świata jest zbędna.