squaremap - минималистичная карта мира для Minecraft

squaremap - это лёгкий и быстрый инструмент для просмотра карты твоего сервера прямо в браузере. В отличие от тяжеловесных Dynmap или BlueMap, он использует простой ванильный стиль отрисовки сверху (top-down 2D), без излишеств. По факту, это идеальный вариант, если тебе нужна просто карта для навигации, а не 3D-панорамы.

Зачем это нужно

На любом сервере рано или поздно встаёт вопрос: как игрокам ориентироваться в мире без телепортации? Особенно на выживании или в больших проектах. squaremap решает эту проблему - любой игрок может открыть страницу в браузере и увидеть, где находятся базы, спавн, деревни и другие игроки. Всё в реальном времени, без задержек.

Особенности

• Молниеносный рендер - карта генерируется за минуты, а не дни. Никаких очередей на неделю.
• Простой ванильный вид - ровно то, что ты видишь на карте в игре, только на весь экран браузера.
• Маркеры игроков - показывает поворот головы (yaw), здоровье и броню. Удобно, чтобы понять, кто чем занят.
• Лёгкая настройка - конфиг в пару строк, и карта уже работает.
• Современный Leaflet - фронтенд на актуальной версии Leaflet, всё плавно и быстро.
• Аддоны и интеграции - подключается к популярным плагинам через API.

Поддерживаемые платформы

• Paper
• Sponge
• Fabric (нужен Fabric API)
• NeoForge

То есть squaremap работает как плагин на серверах Paper/Sponge, или как мод на Fabric/NeoForge. Выбирай под свою сборку.

Как это выглядит

Карта рендерится в браузере, никаких модов на клиенте не нужно. Просто открываешь ссылку - и видишь весь мир сверху. Стиль - как у обычной карты в Майнкрафт, без излишней детализации. Это сделано специально для удобства навигации, а не для красивых скриншотов.

API и расширения

squaremap предоставляет простое API для рисования маркеров, фигур, иконок и прочего на карте. Javadocs лежат прямо в maven-репозитории, IDE подтянет их автоматически. Если хочешь добавить свои метки (например, точки интереса или магазины) - это делается через API. Подробнее в README и Wiki.

Лицензия

Проект распространяется под лицензией MIT. Leaflet (фронтенд) - под 2-clause BSD License. Всё открыто, можно использовать и модифицировать.

Скачать squaremap

Скачать плагин/мод squaremap можно на Modrinth или на GitHub releases. Для разработческих сборок есть отдельный Jenkins. Если собираешь сервер и хочешь простую, быструю и ненагруженную карту - squaremap отличный выбор. На слабом железе он тоже работает нормально, в отличие от более тяжёлых аналогов.

Короче, squaremap - это must-have для любого сервера, где игроки исследуют мир и хотят видеть карту в реальном времени. Без лишних свистелок, но со своей задачей справляется на ура.