BlueMap — Minecraft를 위한 브라우저 내 인터랙티브 3D 월드 맵 생성 플러그인
브라우저에서 월드의 인터랙티브 3D 맵을 생성하는 Minecraft용 BlueMap 플러그인에 대한 완벽 가이드입니다. 기능, 명령어 및 구성 방법을 설명합니다.
브라우저에서 월드의 인터랙티브 3D 맵을 생성하는 Minecraft용 BlueMap 플러그인에 대한 완벽 가이드입니다. 기능, 명령어 및 구성 방법을 설명합니다.
BlueMap — Minecraft를 위한 브라우저 내 인터랙티브 3D 월드 맵 생성 플러그인
BlueMap은 월드 파일을 읽어 브라우저에서 내장 웹 서버를 통해 접근할 수 있는 3차원 표면 모델을 구축하는 Minecraft 플러그인입니다. 기본 클라이언트는 플레이어 주변의 월드만 렌더링하며 위에서 보거나 외부에서 보는 뷰를 제공하지 않습니다. 이 플러그인은 카메라 회전, 원근법 또는 아이소메트릭(평면) 모드 전환 기능이 있는 완전한 맵을 형성하며, URL로 이동하기만 하면 건축물을 볼 수 있습니다. 게임에 로그인할 필요 없이 서버 월드를 외부에서 볼 수 있다는 하나의 과제를 해결합니다.
렌더링 작동 방식
플러그인은 청크를 타일로 나누고 두 가지 세부 레이어를 생성합니다. 전체 블록 지오메트리가 있는 hires 모델과 원거리 보기용 lowres 맵입니다. Hires는 가까이 확대할 때 활성화되며, 이때 특정 블록, 텍스처 및 높이가 보입니다. 더 멀리 축소하면 생물 군계의 색상 얼룩과 풍경이 있는 단순화된 레이어가 로드됩니다.
웹 인터페이스의 렌더링 프로세스: 확대/축소 시 타일이 점진적으로 로드됩니다.
렌더링은 별도의 스레드 풀에서 비동기적으로 수행됩니다. 이때 Minecraft 서버 스레드는 차단되지 않으므로, CPU에 여유 코어가 있는 한 플레이어는 맵 구축으로 인한 랙을 느끼지 못합니다. 플러그인 자체가 월드의 변경 사항을 추적합니다. BlueMap은 주기적으로 mca 파일을 확인하여 변경된 청크를 파악하고 해당 청크만 다시 렌더링합니다. /bluemap update와 같은 수동 명령어는 진단 목적으로 주로 사용되며 거의 필요하지 않습니다.
1인칭 시점의 웹 인터페이스 렌더링
명령어
플러그인은 하위 명령어가 있는 단일 루트 명령어 /bluemap을 등록합니다. 대부분의 경우 명령어 자체가 필요하지 않으며 렌더링이 자동으로 작동합니다.
명령어 | 기능 | |
| 렌더링 상태 및 대기열을 표시합니다 | |
| 구성을 다시 로드합니다. | |
| 모든 렌더링을 일시 중지하고 다시 시작합니다 (다시 시작한 후에도 유지됨) | |
| 특정 맵을 고정합니다 (업데이트 없음) | |
| 맵 데이터를 완전히 삭제합니다. 다시 렌더링됩니다 | |
| 반경 내에서 변경된 청크의 업데이트를 강제합니다 | |
| 변경 사항이 없더라도 모든 것을 다시 렌더링합니다 | |
| 지정된 지점에서 일반적인 맵 문제를 검색합니다 |
/bluemap 명령어 실행
구성
플러그인 폴더에는 4개의 구성 파일이 포함되어 있습니다. core.conf, plugin.conf, webapp.conf, webserver.conf. 또한 3개의 하위 폴더가 있습니다. maps/(각 월드당 하나의 .conf), packs/(렌더링을 위한 리소스 팩) 및 storages/(파일 시스템용 file.conf, SQL 데이터베이스용 sql.conf).
core.conf
기본 파일입니다. 주요 매개변수는 accept-download이며, 첫 번째 실행 시 true로 설정해야 합니다. render-thread-count 매개변수(기본값 1)는 렌더링 스레드 수를 설정합니다 — 음수 값은 "CPU 코어 수에서 숫자의 절대값을 뺀 값"을 의미합니다. metrics(true)는 익명 통계 전송을 제어합니다.
plugin.conf
맵에서의 플레이어 가시성 및 렌더링 동작을 위한 매개변수:
매개변수 | 기능 |
| 온라인 플레이어의 위치를 웹 애플리케이션으로 전송합니다 |
| 플레이어가 보이지 않는 모드. 값: |
| vanish 플러그인에 의해 숨겨진 플레이어를 숨깁니다 |
| 투명화 물약 효과가 있는 플레이어를 숨깁니다 |
| 웅크리고 있는 플레이어를 숨깁니다 |
| 햇빛 임계값; |
| 블록 빛 임계값 |
| 다른 월드에 있는 플레이어를 목록에서 제거합니다 |
| 마커를 저장소에 저장하는 간격(초); |
| 플레이어 위치를 저장하는 간격(초) |
| 플레이어가 접속할 때 Mojang에서 스킨을 다운로드합니다 |
| 렌더링이 중지되는 온라인 플레이어 수; |
| 누락된 변경 사항에 대한 전체 확인 사이의 시간(분) |
webapp.conf
웹 애플리케이션 설정. default-to-flat-view(false)는 초기 보기를 결정합니다 — 원근법 또는 아이소메트릭. 슬라이더 hires-slider-default(100) 및 lowres-slider-default(2000)는 블록 단위로 상세 및 단순화된 렌더링의 거리를 설정합니다. resolution-default(1)는 0.5, 1 또는 2 값을 허용합니다. scripts 및 styles 배열은 사용자 지정 JS 및 CSS 파일을 연결합니다.
webserver.conf
내장 웹 서버. enabled(true) — 활성화 또는 비활성화. port(8100) — 포트. webroot ("bluemap/web") — 웹 애플리케이션 파일이 있는 디렉토리(webapp.conf의 webroot와 일치해야 함). log 섹션은 HTTP 활동의 파일 기록을 구성합니다.
결론
BlueMap은 카메라 회전 및 자유 비행이 가능한 본격적인 3D 모델 형식으로 월드를 외부에서 볼 수 있는 기회를 제공합니다. 이 플러그인은 플레이어가 좌표를 공유하고 건물을 검사하는 것이 중요한 서바이벌 및 RPG 서버에 적합하며, 영구적인 월드가 없는 미니 게임 서버에는 불필요합니다.
설치
일반적인 설치는 약 5 분 정도 걸려요. 과정은 동일하고, Loader 와 그에 맞는 빌드만 달라요.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
