Dynmap은 Minecraft 서버를 위한 실시간 웹 기반 지도를 제공하는 Minecraft 플러그인 및 모드 패밀리입니다. 로드된 월드의 맵 타일을 렌더링하고, 마커, 구역, 선, 실시간 플레이어 위치, 채팅 말풍선을 표시할 수 있는 인터랙티브 지도 인터페이스를 제공합니다. Dynmap은 내부 webserver를 실행하거나 외부 호스팅용으로 맵 데이터를 내보내는 기능을 지원하며, 여러 저장소 백엔드를 제공합니다.

🎯 목적

Dynmap의 핵심 목적은 서버 관리자와 플레이어에게 브라우저를 통해 서버 지형과 활동을 실시간으로 탐색할 수 있는 시야를 제공하는 것입니다. 월드 구조를 시각화하고, 플레이어 위치를 추적하고, 서버 지도를 사용자에게 공개하고, 마커와 구역이 포함된 주석 지도를 만드는 문제를 해결합니다.

⚙️ 기능

서버 월드의 실시간 타일 렌더링(여러 지도 보기와 렌더 모드).
플레이어나 스태프를 위해 지도를 주석 처리할 수 있는 설정 가능한 마커, 구역, 선.
실시간 플레이어 추적과 선택적 채팅 말풍선 / web-to-game 채팅 연동.
여러 저장소 백엔드: flat files, MySQL/SQLite/PostgreSQL/MariaDB, 그리고 맵/web 저장용 AWS S3 지원.
지도를 제공하는 내장 webserver; 외부 저장소로 정적 사이트 콘텐츠를 게시/업로드하도록 조정할 수 있습니다.
크로스 플랫폼 빌드: Spigot/Paper, Forge, Fabric용 전용 아티팩트가 있습니다.

🧩 대상

자신의 월드(들)를 탐색 가능한 지도로 보고 싶은 서버 소유자와 관리자.
플레이어에게 지도를 공개하는 공개 SMP 및 생존 서버.
주석 지도, 스폰 마커, 구역 오버레이가 필요한 미니게임 또는 롤플레잉 서버.
큰 지도에 대해 유연한 저장소/백엔드 옵션(SQL 또는 S3)이 필요한 호스트.

🏗️ 사용 예시

플레이어가 온라인에서 볼 수 있도록 오버월드의 실시간 지도를 렌더링하고 공개하기.
사용자 지정 마커와 영역 윤곽으로 마을, 상점, 눈에 띄는 랜드마크 표시하기.
새로 탐험한 청크에 대해 예약 또는 수동 렌더링 실행하기(반경 렌더 또는 전체 월드 렌더).

⌨️ 명령어

Command	Description	Permission	Access
`/dynmap render`	지도 타일 또는 지도의 수동 렌더/업데이트를 요청합니다.	`dynmap.render`	Admin
`/dynmap radiusrender <radius> [mapname]`	지정된 지도에 대해 플레이어 주변 반경 내의 지도 타일을 렌더합니다.	`dynmap.render`	Admin

(참고: Dynmap은 공식 문서에서 더 많은 지도 및 설정 명령어를 제공합니다.)

🔐 권한

Permission	Description	Default
`dynmap.render`	`/dynmap render`와 같은 렌더링 관련 명령어 사용을 허용합니다.	not specified

⚙️ 설치

📥 설정

서버 플랫폼에 맞는 공식 Dynmap JAR를 다운로드하여 서버의 plugins/ 디렉터리(Forge/Fabric의 경우 mods/)에 넣습니다.
서버를 재시작하고 콘솔에서 Dynmap이 로드되었고 설정 및 맵 폴더를 생성했는지 확인합니다.
첫 실행 시 생성되는 Dynmap 설정 파일에서 지도, 마커, 저장소 백엔드, webserver 옵션을 구성합니다.

📦 의존성

Dynmap 빌드에는 많은 Spigot/Paper 배포판에서 JDBC 드라이버 지원이 포함되어 있습니다. 다른 플랫폼에서는 SQL 백엔드용 추가 드라이버나 호환성 모드가 필요할 수 있습니다.
연동 플러그인(예: WorldGuard, Towny, Citizens)은 별도의 Dynmap 연동을 통해 제공되며, 필수 런타임 의존성은 아닙니다.

🧾 설정

Dynmap은 최초 시작 시 생성되는 YAML 설정 파일을 사용합니다. 설정은 지도, 렌더링 설정, 마커 세트, 저장소 백엔드, webserver 동작을 제어합니다.
지원되는 저장소 백엔드에는 flat files, MySQL, SQLite, PostgreSQL, MariaDB, 그리고 맵 데이터 호스팅용 선택적 AWS S3 저장소가 포함됩니다.

🧠 기술 노트

공식 프로젝트 소스는 Spigot/Paper, Forge, Fabric용 플랫폼별 빌드를 제공합니다.
Dynmap의 코드베이스는 Apache-2.0 라이선스로 배포됩니다.
이 프로젝트는 런타임에서 Java 8 실행을 지원하며, 빌드 요구 사항은 대상에 따라 다르고 최신 빌드에는 더 새로운 JDK 버전이 필요할 수 있습니다.
Dynmap은 연동 플러그인에서 사용하는 공개 API(DynmapCoreAPI 및 dynmap-api)를 제공합니다. 이는 서드파티 확장을 위한 안정적인 인터페이스입니다.