Pl3xMap is the original minimalistic and lightweight world map viewer
for Minecraft servers using the vanilla Minecraft rendering style.
Downloads are available on Modrinth.
You can demo Pl3xMap (and it's top competitors) at:
granny on:
* GitHub Sponsors
BillyGalbreath on:
* GitHub Sponsors
* Patreon
* Ko-Fi
JLyne on:
* Ko-Fi
Maven
<repository>
<id>modrinth-repo</id>
<url>https://api.modrinth.com/maven/</url>
</repository>
<dependency>
<groupId>maven.modrinth</groupId>
<artifactId>pl3xmap</artifactId>
<version>1.20.4-476</version>
<scope>provided</scope>
</dependency>
Gradle
repositories {
exclusiveContent {
forRepository { maven { url = "https://api.modrinth.com/maven" } }
filter { includeGroup "maven.modrinth" }
}
}
dependencies {
compileOnly 'maven.modrinth:pl3xmap:1.20.4-476'
}
Just run the following command:
./gradlew build
The compiled jars will be in build/libs/
Optional
Required
Terms for using, modifying and redistributing this product.
29.07.2026 · Modrinth
use community updated bukkit platform impl, closes #162
Screenshots and images from the original Modrinth page.


Published versions and original Modrinth files.
29.07.2026 · 2 549 downloads
use community updated bukkit platform impl, closes #162
11.07.2026 · 1 187 downloads
Update Adventure API back to version 5 (#161)
11.07.2026 · 32 downloads
add missing 26.2 blocks
09.07.2026 · 361 downloads
Update to 26.2 (#158)
21.06.2026 · 1 910 downloads
bump fabric api version
11.06.2026 · 827 downloads
fix nether/end maps not generating correctly on spigot, closes #157
10.06.2026 · 32 downloads
Replace the QuerzNBT with the BlueNBT library (#153)
21.05.2026 · 1 470 downloads
Downgrade adventure version to 4.25.0 (#151)
04.05.2026 · 1 088 downloads
update adventure fabric dependency version
24.04.2026 · 600 downloads
Update to 26.1.2 (#145)
21.03.2026 · 5 661 downloads
Revert "hide player if in world that is disabled"
This reverts commit 2a82b403459a4363bba6a03ec6e55445703d123c.
20.03.2026 · 126 downloads
hide player if in world that is disabled
19.03.2026 · 121 downloads
make max threads allowed not clamped to half
27.02.2026 · 1 398 downloads
implement show hidden players in sidebar option, closes #88
adds settings.hide.show-hidden-players-in-sidebar option to PlayersLayer config
This includes some changes to the webmap files. If you made any changes to them, please back them up and set settings.web-directory.read-only to false in the config to allow for the new changes to take effect.
05.01.2026 · 4 074 downloads
fix resolving the player from command context
01.01.2026 · 720 downloads
Update to 1.21.11 (#124)
23.11.2025 · 3 883 downloads
Improve allocation rates by ~50% (#121)
A significant portion of the allocations performed by
Pl3xMap came from boxing an int as an Integer when using the Sampler
Functional Interface. No boxing should be
required here. This should improve allocation rates by ~40-50%
14.10.2025 · 3 184 downloads
auto download node when running build
14.10.2025 · 96 downloads
fix ArrayIndexOutOfBoundsException when loading certain chunks
updated based off of https://github.com/BlueMap-Minecraft/BlueMap/blob/HEAD/core/src/main/java/de/bluecolored/bluemap/core/world/mca/PackedIntArrayAccess.java
13.10.2025 · 213 downloads
Update to 1.21.10 (skipping 1.21.9 on purpose) (#114)
20.07.2025 · 6 263 downloads
bump minecraft version to 1.21.8
11.07.2025 · 1 246 downloads
fix broken heightmap on maps with modified dimension heights
Co-authored-by: BillyGalbreath blake.galbreath@gmail.com
07.07.2025 · 363 downloads
fix typo
07.07.2025 · 170 downloads
update to 1.21.7
07.07.2025 · 555 downloads
use self-published adventure-bukkit
07.07.2025 · 84 downloads
Update to 1.21.6 (#100)
Co-authored-by: 12emin34 macanovic.emin@gmail.com
09.06.2025 · 2 567 downloads
fix zoom speed issue on linux with chrome based browsers (#99)
starting with chrome v109 on linux they doubled the scrollwheel delta, so now the browser scrolls too fast. this was an intentional change and people are happy with it, however it create a lot of unintentional bugs. one bug is that leaflet now zooms in/out too fast again (it jumps 2 zoom levels instead of 1). other bugs include scrolling content way too quickly, like a select box scrolling so fast you miss some options (it goes from 1-4 to 8-11 with one mousewheel tick lol)
anyways, long story short is the fix in leaflet from years ago needs to be removed. until then we can workaround it by doubling the ratio in the map options on our end when we detect linux+chrome combination.
27.05.2025 · 668 downloads
need to check if it compiles before pushing changes...
18.05.2025 · 2 915 downloads
Update to 1.21.5 (#89)
18.05.2025 · 2 513 downloads
bump undertow version, potentially fixes #94
24.04.2025 · 1 150 downloads
check for world keys that have the colon replaced with a dash in sse endpoint, closes #91
07.04.2025 · 982 downloads
fix: use reflection for retrieving levelStorageAccess, closes #80
23.03.2025 · 708 downloads
Add language file for Japanese (#82)
23.03.2025 · 131 downloads
Add language file for Simplified Chinese (#85)
10.03.2025 · 624 downloads
perf: don't pass null to Integer.valueof() in BlockState ctor
This caused a huge amount of memory allocation (and wasted performance) towards creating NumberFormatException objects which were being ignored, since most blocks don't have any properties or any age/moisture/power values.
02.02.2025 · 1 525 downloads
bump gradle wrapper to 8.12
update dependencies (remove support for spigot for now)
25.12.2024 · 1 853 downloads
fix(blockinfo): update block indexes for blocks with no index
25.12.2024 · 170 downloads
fix(blockinfo): increase blocks that can be registered by reducing biome amount
25.12.2024 · 90 downloads
chore: bump paperweight to 2.0.0
Fix reversed byte order in custom file protocol
Before, the packed integer was being turned into a reversed byte array. This isn't really an issue as long as it's converted back into a packed integer using the same logic.
settings.web-directory.read-only will need to be set to false in the config when updating Pl3xMap to the version with this fix, since it includes changes to the webmap files.
fix map size on load
fixes android browser url bar pushing page off-screen
https://chanind.github.io/javascript/2019/09/28/avoid-100vh-on-mobile-web.html
17.12.2024 · 766 downloads
fix(fabric): render world arguments as dimensions
12.12.2024 · 301 downloads
support worlds with whitespace in command input, closes #60
12.12.2024 · 87 downloads
document renderer icon usage in config, closes #55
12.12.2024 · 76 downloads
add missing blocks and block colors
closes #68
closes #73
12.12.2024 · 96 downloads
[ci skip] bump gradle wrapper and fabric versions
register blocks/biomes even if max index is reached
04.12.2024 · 734 downloads
update to 1.21.4
04.12.2024 · 1 041 downloads
fix incorrect max build height value
solves the problem with the lines of air that would appear in the end
04.11.2024 · 1 716 downloads
fix compilation error for bukkit servers
iterate down from max build height for nether roof renderer, closes #64
27.10.2024 · 549 downloads
update to 1.21.3
23.08.2024 · 6 171 downloads
bump gradle wrapper to 8.8
update to 1.21.1
24.07.2024 · 4 262 downloads
[ci skip] minor cleanup
convert any number type received from Section Y key as ints
24.07.2024 · 127 downloads
apply hotfix for worlds being registered twice when running resetmap command
22.07.2024 · 300 downloads
stop basing the nether roof off of the vanilla renderer, closes #51
22.07.2024 · 158 downloads
add a message to the fullrender command if there's no region files to load
22.07.2024 · 92 downloads
update cloud confirmation processor, closes #52
temporarily disable the reset map command when ran as player
22.07.2024 · 143 downloads
move settings file I/O into it's own thread, closes #38
21.06.2024 · 1 379 downloads
[ci skip] some dependency changes
fix plugin not registering properly on spigot
17.06.2024 · 1 066 downloads
update to 1.21 (#49)
17.06.2024 · 1 051 downloads
shallow list copy in hashcode, closes #48
01.06.2024 · 485 downloads
remove unnecessary global scheduler cancellation
we only cancel it ourselves when the plugin is disabled, but that's already handled for us. This removes the call to a paper-only class, which should allow pl3xmap to run properly on spigot
01.06.2024 · 129 downloads
support uncompressed data, closes #45
27.05.2024 · 209 downloads
support the LZ4 compression type, closes #44
13.05.2024 · 363 downloads
use a shallow copy of the points in json wrapper, closes #42
12.05.2024 · 149 downloads
Add Folia Support (#40)
02.05.2024 · 610 downloads
Starting with build #493, the version of Minecraft that Pl3xMap supports has changed to 1.20.6. Listed out below are some of the changes that come with this build.
This means that all markers (like moving player icons and the like) will now update in realtime through the use of Server Sent Events. The file-based marker updates still exist as both a fallback in case realtime updating fails, and as a way to have custom/plugin markers continue existing even when the map is viewed while the server is offline (if you have a reverse proxy set up).
Each layer config now has an additional live-update option. This option controls whether or not the specified layer should be pushed in realtime to end-users. If, for example, you like that player markers get updated every second, you could disable this option in the layers/players.yml config to keep old functionality.
There are two additional options related to live updates under settings.performance in the main config (config.yml). settings.performance.live-update.threads handles how many threads are used to push marker updates. settings.performance.live-update.enabled determines if the live update system is used.
Internally, layers used to update in a per-second basis, which meant everything was configured in seconds. This PR changes that so everything runs in ticks instead. I tried to make sure that all API methods that state "seconds" correctly return or set the update interval as seconds, so that addons don't end up unexpectedly breaking/running faster than they should.
isLiveUpdate() and setLiveUpdate(boolean liveUpdate) were added to the Layer class. Any created layers will by default return false when isLiveUpdate() is called, which will stop the layer's markers from being pushed in realtime. If you believe that your custom layers should be able to update in realtime, then call setLiveUpdate(true) when creating your layer. (Ideally you'd make this configurable from your addon).
Thank you for your patience with how long it took to release the realtime marker system and pl3xmap for 1.20.6. If you run into any issues with this new build, or have any suggestions for new features or improvements, please do so in my discord server: https://granny.dev/discord
12.04.2024 · 4 539 downloads
throw away unused SpiFix class
05.04.2024 · 546 downloads
update adventure version
02.04.2024 · 278 downloads
prevent duplicate appearance of failed icon registration stacktrace
replace printStackTrace with log
30.03.2024 · 1 781 downloads
Add resume command (#32)
30.03.2024 · 87 downloads
Make 'unknown' block/biome hard-coded values configurable (#30)
26.03.2024 · 199 downloads
keep making codefactor happy
refactor NetherRoofRenderer
25.03.2024 · 62 downloads
make codefactor happy
nitpick: replace static imports
25.03.2024 · 74 downloads
update pirate talk translation values
add polish translation
20.02.2024 · 1 408 downloads
13.02.2024 · 315 downloads
add <world>.center.[x|z] option, closes #20, supersedes #25
09.02.2024 · 217 downloads
this should be break, not continue
08.02.2024 · 60 downloads
ticket can still be null when reloading plugin
08.02.2024 · 80 downloads
Nether Roof Renderer (#24)
06.01.2024 · 933 downloads
it will actually compile this time
26.12.2023 · 281 downloads
inline the use of printstacktrace
only print stacktrace in warn logs if debug option is enabled
handle the url connection separately from everything else, closes #18
22.12.2023 · 108 downloads
add missing blocks and their colors
22.12.2023 · 350 downloads
update to 1.20.4, closes #17
09.11.2023 · 1 639 downloads
add update interval option to built-in layers
05.11.2023 · 231 downloads
update bukkit version of adventure, fixes #11
31.10.2023 · 235 downloads
test build number counter
25.10.2023 · 297 downloads
24.10.2023 · 1 294 downloads
This build is offered as a courtesy. No support will be given for the use of this build.
24.10.2023 · 498 downloads
This build is offered as a courtesy. No support will be given for the use of this build.
24.10.2023 · 6 607 downloads
This build is offered as a courtesy. No support will be given for the use of this build.