README.md

squaremap

What is squaremap

squaremap is a minimalistic and lightweight live world map viewer for Minecraft servers.

squaremap hooks into your Minecraft server as a plugin or mod on a supported platform, then generates and manages a live map of your server, viewable in any web browser.

Features

• Ultra fast render times. Get your map rendered today, not next week.
• Simple vanilla-like top down 2D view, designed for navigation.
• Player markers showing yaw rotation, health, and armor.
• Easy to setup and configure.
• Up to date Leaflet front-end.
• Addons and integrations for many popular plugins.

Supported platforms

• Paper
• Fabric (requires Fabric API)
• NeoForge
• Sponge

Downloads

Downloads can be obtained from the releases section.

Development builds

Development builds are available at https://jenkins.jpenilla.xyz/job/squaremap/

Demo

Official squaremap demo: https://squaremap-demo.jpenilla.xyz/

License

This project is licensed under the MIT license

Leaflet (the web ui frontend) is licensed under 2-clause BSD License

API

squaremap provides simple APIs to draw markers, shapes, icons, and etc. on rendered maps. Javadocs are hosted on the maven repository alongside the binaries, and should be automatically downloaded by your IDE.

Dependency Information

Releases are published to Maven Central

Using snapshot builds

Snapshot builds are available on the Sonatype snapshots maven repository: https://s01.oss.sonatype.org/content/repositories/snapshots/

Consult your build tool's documentation for details on adding maven repositories to your project.

Maven

<dependency>
    <groupId>xyz.jpenilla</groupId>
    <artifactId>squaremap-api</artifactId>
    <version>1.3.3</version>
    <scope>provided</scope>
</dependency>

Gradle

repositories {
    mavenCentral()
}

dependencies {
    compileOnly("xyz.jpenilla", "squaremap-api", "1.3.3")
}

Building from source

Build squaremap by invoking the build task with Gradle.

./gradlew build

bStats

Usage stats for the Paper platform