BlueMap

BlueMap 소개

BlueMap은 마인크래프트 월드 파일을 읽어 지도를 만들고, 웹 브라우저에서 그 지도를 볼 수 있게 해 주는 맵 도구입니다. 평면 지도만 그리는 데서 그치지 않고 월드 표면 전체를 3D 모델로 만들어 주기 때문에, 브라우저 화면에서도 마치 게임 안에 들어가 있는 것처럼 건물과 지형을 둘러볼 수 있습니다. 멀리서 내려다보며 서버 전체의 모습을 한눈에 살펴보는 것도 가능합니다.

BlueMap은 Spigot·Paper 또는 Sponge용 플러그인, Fabric·Forge용 모드로 제공되며, 서버 없이 명령줄에서 단독으로 실행하는 도구로도 쓸 수 있습니다. 플러그인이나 모드로 설치했을 때는 렌더링이 마인크래프트 서버 스레드와 비동기로 진행됩니다. 즉 지도 생성 작업이 서버 스레드를 직접 막지 않으므로, CPU가 완전히 바쁘지만 않다면 렌더링 중에도 서버가 느려지지 않도록 설계되어 있습니다.

멀티 서버에서는 플레이어들이 "우리 서버가 지금 어떤 모습인지" 궁금해하기 마련인데, BlueMap은 그 답을 웹 페이지 하나로 보여 줍니다. 2022년 Modrinth에 공개된 이후 꾸준히 업데이트되어 26.3 버전까지 지원 범위를 넓혀 왔습니다.

BlueMap 정보

항목	내용
종류	마인크래프트 플러그인 (3D 웹 지도)
제작자	BlueColored
지원 버전	1.13 ~ 26.3
지원 플랫폼	Fabric, Folia, Forge, NeoForge, Paper, Purpur, Spigot, Sponge
카테고리	어드벤처, 관리, 유틸리티
다운로드	약 51만 회
최초 공개	2022-05-10
최근 업데이트	2026-09-25
라이선스	MIT
배포처	Modrinth

주요 특징

• 3D 월드 모델 - 지도뿐 아니라 월드 표면 전체를 입체 모델로 생성합니다.
• 브라우저 뷰어 - 웹 앱으로 게임을 켜지 않고도 월드를 자유롭게 둘러볼 수 있습니다.
• 비동기 렌더링 - 서버 스레드를 막지 않고 백그라운드에서 지도를 그립니다.
• 내장 웹 서버 - 별도 웹 서버 없이 플러그인이 직접 지도 페이지를 제공합니다.
• 다양한 실행 방식 - 플러그인, 모드, 명령줄 단독 도구 중 환경에 맞게 고를 수 있습니다.

서버 설정과 사용 방법

BlueMap의 웹 서버는 핵심 기능이라 기본으로 켜져 있으며, 필요하면 플러그인 설정에서 끌 수 있습니다. 기본값으로는 모든 네트워크 인터페이스(0.0.0.0)의 8100번 포트에 연결되어 ./bluemap/web/ 폴더의 내용을 제공합니다. 따라서 외부 플레이어가 지도를 보게 하려면 서버 호스팅 환경에서 해당 포트를 열어 두어야 합니다.

BlueMap은 bStats와 자체 통계 시스템을 사용합니다. 자체 통계는 구현 종류와 플러그인 버전 정도만 담은 아주 작은 보고서이며, 모든 통계 전송은 플러그인 설정에서 끌 수 있습니다. 운영 정책상 외부 전송을 원하지 않는다면 설치 후 설정 파일을 먼저 확인하세요.

• 처음 렌더링은 월드 크기에 따라 시간이 오래 걸릴 수 있으니 접속자가 적은 시간대에 진행하는 것이 좋습니다.
• 3D 지도는 저장 공간을 꽤 차지하는 편이므로 서버 디스크 여유를 확인해 두세요.
• 웹 페이지를 공개할 때는 방화벽과 포트 설정을 함께 점검하는 것이 안전합니다.

플러그인·모드·단독 도구 중 무엇을 고를까

Paper나 Spigot으로 서버를 운영하고 있다면 플러그인 버전이 가장 자연스러운 선택입니다. 서버가 켜져 있는 동안 월드 변화를 따라 지도를 갱신하고, 내장 웹 서버로 바로 공개할 수 있기 때문입니다. Fabric·Forge 기반 모드 서버라면 같은 역할을 하는 모드 버전을 쓰면 됩니다. 반대로 서버 없이 혼자 플레이한 월드를 지도로 남겨 두고 싶거나, 운영 중인 서버에 부담을 전혀 주고 싶지 않다면 월드 파일을 복사해 명령줄 단독 도구로 렌더링하는 방법도 있습니다. 어떤 방식을 고르든 결과물은 브라우저에서 보는 같은 형태의 3D 지도이므로, 환경과 운영 방식에 맞춰 선택하면 됩니다.

이런 분께 추천합니다

BlueMap은 서버의 모습을 외부에 보여 주고 싶은 운영자에게 특히 잘 맞습니다.

• 서버 홍보용으로 월드 전경을 웹에서 보여 주고 싶은 운영자
• 평면 지도보다 입체감 있는 지도를 원하는 분
• 지도 렌더링 때문에 서버가 느려지는 것을 걱정하는 분
• 서버 없이 싱글 월드 지도를 명령줄로 만들어 보고 싶은 분

다운로드 및 설치 방법

1. Paper·Spigot·Sponge 등 지원 플랫폼으로 서버를 준비합니다.
2. 페이지의 Modrinth에서 다운로드 버튼으로 이동해 서버 버전과 플랫폼에 맞는 BlueMap 파일을 받습니다.
3. .jar 파일을 서버의 plugins 폴더에 넣고 서버를 재시작합니다.
4. plugins\BlueMap 폴더에 생성된 설정 파일을 확인하고 필요한 항목을 조정합니다.
5. 브라우저에서 서버 주소와 8100번 포트로 접속해 지도를 확인합니다.

Fabric·Forge·NeoForge 서버라면 플러그인 대신 모드 버전을 mods 폴더에 넣어 사용합니다. 플러그인 형태는 서버용이며 싱글플레이 클라이언트에 넣는 방식이 아닙니다.

자주 묻는 질문

BlueMap이 서버 렉을 유발하나요?

렌더링이 서버 스레드와 비동기로 진행되어 직접 막지 않도록 만들어졌습니다. 다만 CPU를 모두 사용할 정도로 부하가 크면 영향이 있을 수 있습니다.

지도 페이지에 접속이 안 돼요.

기본 포트는 8100번입니다. 호스팅 업체나 공유기에서 이 포트가 열려 있는지, 설정에서 웹 서버가 꺼져 있지 않은지 확인하세요.

통계 전송을 끌 수 있나요?

네. bStats와 자체 통계 모두 플러그인 설정에서 비활성화할 수 있습니다.

서버가 없어도 쓸 수 있나요?

BlueMap은 명령줄 단독 도구로도 제공되므로 서버 없이 월드 파일만으로 지도를 만들 수 있습니다.

마무리

BlueMap은 마인크래프트 월드를 3D로 재현해 브라우저에서 보여 주는 지도 도구입니다. 비동기 렌더링 덕분에 운영 중인 서버에도 부담 없이 붙일 수 있고, 내장 웹 서버로 설정도 간단합니다. 서버 버전에 맞는 파일을 설치하고 우리 서버의 전경을 지도로 공유해 보세요.