squaremap

squaremap 소개

squaremap은 마인크래프트 서버의 월드를 웹 브라우저에서 볼 수 있는 실시간 지도로 만들어 주는 가볍고 간결한 지도 뷰어입니다. 서버에 플러그인이나 모드로 설치하면 월드를 바탕으로 지도를 생성하고 계속 관리해 주며, 플레이어는 별도 프로그램 없이 브라우저만 열면 서버 전체를 내려다볼 수 있습니다.

지도 모양은 바닐라 지도 아이템처럼 위에서 내려다본 단순한 2D 방식입니다. 화려한 3D 렌더링 대신 길 찾기에 초점을 맞춘 디자인이라 렌더링 속도가 매우 빠르다는 점이 장점입니다. 제작자는 "다음 주가 아니라 오늘 지도를 완성하라"는 표현으로 렌더링 속도를 강조하고 있습니다.

웹 화면은 최신 Leaflet 프런트엔드를 사용하며, 많은 인기 플러그인과 연동하는 애드온도 마련되어 있어 서버 운영 도구로 활용 폭이 넓습니다.

squaremap 정보

항목	내용
종류	마인크래프트 플러그인 (웹 지도, 모드 겸용)
제작자	jpenilla
지원 버전	1.19.3 ~ 26.3
로더·플랫폼	Fabric, Folia, Forge, NeoForge, Paper, Sponge
카테고리	장식, 관리, 소셜, 유틸리티
다운로드	약 15만 3천 회
최초 공개	2023-02-26
최근 업데이트	2026-09-17
라이선스	MIT (웹 UI의 Leaflet은 2-clause BSD)
배포처	Modrinth

주요 특징

• 매우 빠른 렌더링 - 큰 월드도 짧은 시간 안에 지도로 만들어 낼 수 있도록 설계되었습니다.
• 바닐라풍 2D 지도 - 위에서 내려다본 단순한 화면으로 길 찾기에 알맞습니다.
• 플레이어 마커 - 접속한 플레이어의 바라보는 방향, 체력, 방어구 상태를 지도에 표시합니다.
• 쉬운 설정 - 설치와 설정이 간단해 처음 웹 지도를 운영하는 서버도 부담이 적습니다.
• 연동과 API - 인기 플러그인용 애드온이 있고, 개발자는 API로 마커·도형·아이콘을 지도에 그릴 수 있습니다.

서버 설정과 사용 방법

squaremap은 Paper와 Sponge 서버, 그리고 Fabric·NeoForge 환경을 공식 지원 플랫폼으로 안내합니다. 로더 목록에는 Folia와 Forge도 포함되어 있으니, 해당 환경이라면 배포처의 버전 목록에서 파일이 있는지 확인하세요. Fabric에서 쓸 때는 Fabric API가 필요합니다.

설치 후 서버를 실행하면 squaremap이 월드를 렌더링하고 내장 웹 서버를 통해 지도를 제공하는 방식이 일반적입니다. 외부에서 접속하려면 지도용 포트를 열어 두어야 하는 경우가 많으므로, 호스팅 업체를 쓰고 있다면 포트 개방 방법을 함께 확인하는 것이 좋습니다. 구체적인 명령어와 설정 항목은 자료에 정리되어 있지 않으므로 생성되는 설정 파일과 공식 위키를 참고하세요.

• 처음에는 작은 월드나 테스트 서버에서 렌더링 시간을 확인해 봅니다.
• 월드가 매우 크다면 접속자가 적은 시간에 전체 렌더링을 돌리는 것이 일반적으로 무난합니다.
• 개발자용 Javadoc은 메이븐 저장소에 함께 올라가 있어 IDE에서 자동으로 받을 수 있습니다.

이런 분께 추천합니다

squaremap은 플레이어가 서버의 지형과 건축물을 한눈에 보게 하고 싶은 서버에 잘 맞습니다.

• 서버 홈페이지나 커뮤니티에 실시간 지도를 띄우고 싶은 관리자
• 무거운 3D 지도보다 빠르고 가벼운 지도를 원하는 분
• 넓은 서바이벌 월드에서 길 찾기를 돕고 싶은 서버
• 자체 플러그인에서 지도에 마커를 표시하려는 개발자

다운로드 및 설치 방법

1. 페이지의 Modrinth에서 다운로드 버튼으로 이동해 서버 플랫폼과 게임 버전에 맞는 squaremap 파일을 받습니다.
2. Paper·Folia·Sponge 서버는 plugins 폴더에, Fabric·NeoForge 서버는 mods 폴더에 넣습니다.
3. Fabric이라면 Fabric API도 함께 설치합니다.
4. 서버를 재시작하고 생성된 설정 파일을 확인한 뒤, 브라우저에서 지도 주소로 접속해 렌더링 상태를 봅니다.

첫 실행 때 plugins 안에 squaremap 폴더와 설정 파일이 만들어집니다. squaremap은 서버에 설치하는 도구이므로 일반 플레이어는 따로 설치할 필요가 없습니다.

자주 묻는 질문

플레이어도 설치해야 하나요?

아닙니다. 서버에만 설치하면 되고, 플레이어는 웹 브라우저로 지도에 접속하면 됩니다.

3D 지도도 볼 수 있나요?

squaremap은 바닐라 지도처럼 위에서 내려다본 2D 지도를 목표로 합니다. 대신 렌더링이 빠르고 가볍습니다.

지도에 다른 플러그인 정보를 표시할 수 있나요?

여러 인기 플러그인용 애드온과 연동 기능이 있으며, API를 이용하면 마커·도형·아이콘을 직접 그릴 수도 있습니다.

개발 빌드도 받을 수 있나요?

정식 파일은 Modrinth와 GitHub 릴리스에서 받을 수 있고, 별도의 개발 빌드도 제공된다고 안내되어 있습니다.

Forge나 Folia에서도 쓸 수 있나요?

배포처의 로더 목록에는 Forge와 Folia도 들어 있지만, 제작자 설명의 지원 플랫폼 목록은 Paper, Sponge, Fabric, NeoForge입니다. Forge나 Folia 서버라면 원하는 게임 버전용 파일이 실제로 올라와 있는지 배포처에서 먼저 확인하세요.

지도가 서버 성능에 영향을 주나요?

squaremap은 가볍게 동작하도록 만들어졌지만, 일반적으로 처음 월드 전체를 렌더링할 때는 서버에 부하가 생길 수 있습니다. 접속자가 적은 시간에 렌더링을 돌리고, 이후에는 바뀐 부분만 갱신되도록 두는 방식이 무난합니다.

웹 지도 주소는 어떻게 알 수 있나요?

내장 웹 서버를 쓰는 지도 플러그인은 보통 서버 주소에 설정 파일에 적힌 포트를 붙여 접속합니다. 정확한 값은 squaremap 설정 파일에서 확인하세요.

마무리

squaremap은 서버 월드를 브라우저에서 빠르게 훑어볼 수 있게 해 주는 실용적인 지도 도구입니다. 바닐라 감성의 2D 지도, 플레이어 마커, 다양한 연동 기능을 갖추고도 가볍게 동작합니다. 서버 플랫폼에 맞는 파일을 설치하고 우리 서버만의 실시간 지도를 열어 보세요.