LiveMap is a high-performance, minimalistic world map viewer for Minecraft
servers. Built as the official evolution of Pl3xMap, it delivers crisp, vanilla-style 2D
rendering with a fraction of the resource overhead found in traditional map plugins.

🚀 Features

• ⚡ Near-instant generation:
     Renders complete in minutes rather than days, minimizing initial setup, update times, and server CPU overhead.

• 🗺️ Vanilla-inspired 2D UI:
     Features a lightweight, top-down perspective optimized for clear world navigation without the performance tax of 3D rendering.

• 👥 Real-time player tracking:
     Displays player markers with precise yaw rotation, health, and armor statuses.

• 🎨 Extensible render types:
     Includes multiple built-in map styles out of the box, including Fancy, Basic, Biomes, Inhabited, and Flowermap.

• 🌐 Modern Leaflet frontend:
     Built on a highly responsive, up-to-date Leaflet.js framework for a fast, modern browser experience.

• 🔌 Robust developer API:
     Provides a powerful API interface to build custom addons or seamless third-party plugin integrations with ease.

Contact

Join me on Discord!

⬇️ Downloads

Downloads are available on Modrinth.

🌐 Live Demo

See LiveMap in action and compare its performance side-by-side with alternative map viewers:

🔗 Live Demo hosted by @Roan-V - not implemented yet

Temporary live demo: https://livemap.pl3x.net

📊 Data Collection & Telemetry

This plugin uses bStats to anonymously collect usage data. This data helps me understand how the plugin is being used and what features to focus on in future updates.

• 📈 What is collected: General server information such as server software version, system architecture, core count, Java version, online mode, player count, and plugin-specific metrics (e.g., config settings).

• ❌ What is NOT collected: Strictly no personally identifiable information (PII) is ever tracked. bStats explicitly prohibits and strips IP addresses, player names, chat logs, or UUIDs.

• 🚫 How to opt out: You can easily disable telemetry globally by navigating to your server's /plugins/bStats/config.yml file and setting enabled: false.

License

All code is licensed under MIT license, unless otherwise noted.

🫶 Special Thanks To:

YourKit supports open source projects with innovative and intelligent tools for monitoring and profiling Java and .NET applications. YourKit is the creator of YourKit Java Profiler, YourKit .NET Profiler, and YourKit YouMonitor.

👨‍💻 Developers

To use LiveMap in your own project,

🪶 Maven

<repository>
  <id>pl3x-releases</id>
  <name>Pl3x Repository</name>
  <url>https://repo.pl3x.net/releases</url>
</repository>
<dependency>
  <groupId>net.pl3x</groupId>
  <artifactId>livemap</artifactId>
  <version>[4.0.0,)</version>
  <scope>provided</scope>
</dependency>

🐘 Gradle (Groovy DSL)

repositories {
  maven {
    name "pl3x-releases"
    url "https://repo.pl3x.net/releases"
  }
}
dependencies {
  compileOnly "net.pl3x:livemap:[4.0.0,)"
}

⚙️ Gradle (Kotlin DSL)

repositories {
  maven {
    name = "pl3x-releases"
    url = uri("https://repo.pl3x.net/releases")
  }
}
dependencies {
  compileOnly("net.pl3x:livemap:[4.0.0,)")
}

🛠️ Building from source

Requires JDK 25.

Just run the following command:

./gradlew build

The compiled jars will be in /build/libs/