World Web Map - Minecraft 1.20.1 Server Web Map Mod

Server-side Minecraft 1.20.1 web map mod for Forge and Fabric.

World Web Map renders a 2D top-down map of your Minecraft world and serves it in a browser:

http://server-ip:8123

No client mods are required. Players only need a browser.

---

Versions and Requirements

Loader	Version	Minecraft	Loader version	Extra dependency	Java	Jar
Forge	0.2.1	1.20.1	Forge 47.x, tested on 47.2.0	none	17	forgewebmap-0.2.1.jar
Fabric	0.2.1	1.20.1	Fabric Loader 0.15.11+	Fabric API 0.92.2+1.20.1	17	fabricwebmap-0.2.1.jar

---

Features

• 2D top-down map with height shading.
• Live player markers with names, updated every 2 seconds.
• Biome name shown under the cursor or mobile center point.
• Dimension switcher for Overworld, Nether, and The End.
• Auto-render as players explore, with chunk-load debounce.
• Robust compositing so previously rendered pixels survive re-renders.
• PNG tile writes are atomic and skipped when unchanged.
• Leaflet 1.9.4 browser UI with zoom, pan, dark styling, and mobile controls.

---

Commands

All commands require operator level 2. Syntax is the same for Forge and Fabric.

Command	Description
/webmap status	Show web server status, queue size, worker count, and rendered tile count
/webmap render <tileX> <tileZ>	Render one Overworld tile; tile coords are floor(blockCoord / 256)
/webmap render-area <minX> <minZ> <maxX> <maxZ>	Queue a rectangular Overworld area, max 10,000 tiles
/webmap fullrender <radius>	Render a square around spawn, radius in tiles
/webmap stoprender	Clear the render queue
/webmap reload	Reload config and restart the web server if bind or port changed

Tile coordinates:

tileX = floor(blockX / 256)
tileZ = floor(blockZ / 256)

Example:

/webmap render 0 0

This renders blocks 0..255 x 0..255.

---

Config and Storage

Aspect	Forge	Fabric
Config file	config/forgewebmap-common.properties	config/fabricwebmap-common.properties
Tile path	world/forgewebmap/tiles/	world/fabricwebmap/tiles/
Static web files	packaged under /web/ in the mod jar	packaged under /web/ in the mod jar

Config is created automatically on first run.

Key	Default	Description
enabled	true	Enable the mod
bindAddress	0.0.0.0	HTTP bind address; use 127.0.0.1 for local-only access
port	8123	HTTP port
tileSize	256	Tile size in blocks and pixels
renderThreads	1	Background PNG render worker threads
maxTilesPerTick	1	Max tiles sampled per render interval
ticksBetweenRenders	20	Server ticks between queue processing steps
enablePlayerMarkers	true	Show players on the map
enableAutoRender	true	Queue tile renders when chunks load
chunkRenderDebounceMs	5000	Delay after the last chunk-load event before rendering that tile
renderRadiusAroundPlayers	4	Reserved for player-radius rendering behavior
saveTilesInsideWorldFolder	true	Store tiles under the world folder
tilesDirectory	loader-specific	Relative tile output directory
logRenderProgress	true	Log every 50 rendered tiles

Tile layout:

world/<loader-webmap>/tiles/
├── overworld/
│   └── 0/
│       ├── 0_0.png
│       └── ...
├── the_nether/
│   └── 0/
└── the_end/
    └── 0/

---

API Endpoints

Method	Path	Description
GET	/	Web map frontend
GET	/app.js	Frontend JavaScript
GET	/style.css	Frontend CSS
GET	/tiles/{dim}/{zoom}/{x}/{z}.png	PNG map tile
GET	/api/status	Mod status, queue size, worker count, rendered tile count
GET	/api/players	Online players with name, dimension, coordinates, and yaw
GET	/api/config	Tile size, zoom range, and available dimensions
GET	/api/biome?dim=overworld&x=100&z=200	Biome display name and registry ID

---

Loader Differences

Aspect	Forge	Fabric
Mod entrypoint	@Mod class	ModInitializer.onInitialize()
Lifecycle hooks	Forge server events	ServerLifecycleEvents
Tick hook	TickEvent.ServerTickEvent	ServerTickEvents.END_SERVER_TICK
Chunk-load hook	ChunkEvent.Load	ServerChunkEvents.CHUNK_LOAD
Command hook	RegisterCommandsEvent	CommandRegistrationCallback.EVENT
Logging	Forge LogUtils	SLF4J LoggerFactory

Behavior is intended to be identical across both loaders.

---

Known Limitations

• 2D only: no 3D, isometric, or cave map yet.
• Simple block-color palette: no resource pack textures or biome tinting yet.
• Render commands currently target Overworld only, although tile storage supports all three vanilla dimensions.
• fullrender renders a square around spawn, not every existing region file.
• Unloaded or ungenerated chunks stay transparent until rendered/generated; previously rendered pixels are preserved during re-renders.
• No authentication and no HTTPS; anyone with network access to port 8123 can view the map.
• Only zoom level 0 is rendered natively; Leaflet scales it visually for other zoom levels.