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

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.

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

Config is created automatically on first run.

Tile layout:

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

API Endpoints

Loader Differences

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.