# World Web Map – Minecraft 1.20.1 Server Web Map Mod<\/p>\n
Server-side Minecraft 1.20.1 web map mod for Forge and Fabric.<\/p>\n
World Web Map renders a 2D top-down map of your Minecraft world and serves it in a browser:<\/p>\n
“`
\nhttp:\/\/server-ip:8123
\n“`<\/p>\n
No client mods are required. Players only need a browser.<\/p>\n
—<\/p>\n
## Versions and Requirements<\/p>\n
| Loader | Version | Minecraft | Loader version | Extra dependency | Java | Jar |
\n|——–|———|———–|—————-|——————|——|—–|
\n| Forge | 0.2.1 | 1.20.1 | Forge 47.x, tested on 47.2.0 | none | 17 | `forgewebmap-0.2.1.jar` |
\n| 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` |<\/p>\n
—<\/p>\n
## Features<\/p>\n
– 2D top-down map with height shading.
\n– Live player markers with names, updated every 2 seconds.
\n– Biome name shown under the cursor or mobile center point.
\n– Dimension switcher for Overworld, Nether, and The End.
\n– Auto-render as players explore, with chunk-load debounce.
\n– Robust compositing so previously rendered pixels survive re-renders.
\n– PNG tile writes are atomic and skipped when unchanged.
\n– Leaflet 1.9.4 browser UI with zoom, pan, dark styling, and mobile controls.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
All commands require operator level 2. Syntax is the same for Forge and Fabric.<\/p>\n
| Command | Description | Tile coordinates:<\/p>\n “` Example:<\/p>\n “` This renders blocks `0..255 x 0..255`.<\/p>\n —<\/p>\n ## Config and Storage<\/p>\n | Aspect | Forge | Fabric | Config is created automatically on first run.<\/p>\n | Key | Default | Description | Tile layout:<\/p>\n “` —<\/p>\n ## API Endpoints<\/p>\n | Method | Path | Description | —<\/p>\n ## Loader Differences<\/p>\n | Aspect | Forge | Fabric | Behavior is intended to be identical across both loaders.<\/p>\n —<\/p>\n ## Known Limitations<\/p>\n – 2D only: no 3D, isometric, or cave map yet. 1.20.1 mod: live 2D world map in browser with player markers & auto-render on chunk load.<\/p>\n","protected":false},"featured_media":100524,"template":"","meta":{"_minecraft_slug":"mentalitys-world-web-map","_minecraft_project_id":"79Wh7vd2","_minecraft_author":"Mentality","_minecraft_license":"MIT","_minecraft_downloads":15,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mentalitys-world-web-map.zip","_minecraft_size_bytes":289694,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T12:45:56.065921Z","_minecraft_date_created":"2026-05-09T11:05:48.603931Z","_minecraft_date_modified":"2026-05-01T16:58:43.586541Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mentalitys-world-web-map","_minecraft_icon_attachment_id":100524,"_minecraft_imported_at":"2026-06-05T18:40:13+00:00","_minecraft_import_hash":"e580c1e108fe128e1a985d2f96ea45cd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,126,123,869],"mod_loader":[99,106],"minecraft_version":[36],"class_list":["post-100523","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-management","mod_category-technology","mod_category-transportation","mod_loader-fabric","mod_loader-forge","minecraft_version-1-20-1"],"yoast_head":"\n
\n|———|————-|
\n| `\/webmap status` | Show web server status, queue size, worker count, and rendered tile count |
\n| `\/webmap render
\n| `\/webmap render-area
\n| `\/webmap fullrender
\n| `\/webmap stoprender` | Clear the render queue |
\n| `\/webmap reload` | Reload config and restart the web server if bind or port changed |<\/p>\n
\ntileX = floor(blockX \/ 256)
\ntileZ = floor(blockZ \/ 256)
\n“`<\/p>\n
\n\/webmap render 0 0
\n“`<\/p>\n
\n|——–|——-|——–|
\n| Config file | `config\/forgewebmap-common.properties` | `config\/fabricwebmap-common.properties` |
\n| Tile path | `world\/forgewebmap\/tiles\/` | `world\/fabricwebmap\/tiles\/` |
\n| Static web files | packaged under `\/web\/` in the mod jar | packaged under `\/web\/` in the mod jar |<\/p>\n
\n|—–|———|————-|
\n| `enabled` | `true` | Enable the mod |
\n| `bindAddress` | `0.0.0.0` | HTTP bind address; use `127.0.0.1` for local-only access |
\n| `port` | `8123` | HTTP port |
\n| `tileSize` | `256` | Tile size in blocks and pixels |
\n| `renderThreads` | `1` | Background PNG render worker threads |
\n| `maxTilesPerTick` | `1` | Max tiles sampled per render interval |
\n| `ticksBetweenRenders` | `20` | Server ticks between queue processing steps |
\n| `enablePlayerMarkers` | `true` | Show players on the map |
\n| `enableAutoRender` | `true` | Queue tile renders when chunks load |
\n| `chunkRenderDebounceMs` | `5000` | Delay after the last chunk-load event before rendering that tile |
\n| `renderRadiusAroundPlayers` | `4` | Reserved for player-radius rendering behavior |
\n| `saveTilesInsideWorldFolder` | `true` | Store tiles under the world folder |
\n| `tilesDirectory` | loader-specific | Relative tile output directory |
\n| `logRenderProgress` | `true` | Log every 50 rendered tiles |<\/p>\n
\nworld\/
\n\u251c\u2500\u2500 overworld\/
\n\u2502 \u2514\u2500\u2500 0\/
\n\u2502 \u251c\u2500\u2500 0_0.png
\n\u2502 \u2514\u2500\u2500 …
\n\u251c\u2500\u2500 the_nether\/
\n\u2502 \u2514\u2500\u2500 0\/
\n\u2514\u2500\u2500 the_end\/
\n \u2514\u2500\u2500 0\/
\n“`<\/p>\n
\n|——–|——|————-|
\n| `GET` | `\/` | Web map frontend |
\n| `GET` | `\/app.js` | Frontend JavaScript |
\n| `GET` | `\/style.css` | Frontend CSS |
\n| `GET` | `\/tiles\/{dim}\/{zoom}\/{x}\/{z}.png` | PNG map tile |
\n| `GET` | `\/api\/status` | Mod status, queue size, worker count, rendered tile count |
\n| `GET` | `\/api\/players` | Online players with name, dimension, coordinates, and yaw |
\n| `GET` | `\/api\/config` | Tile size, zoom range, and available dimensions |
\n| `GET` | `\/api\/biome?dim=overworld&x=100&z=200` | Biome display name and registry ID |<\/p>\n
\n|——–|——-|——–|
\n| Mod entrypoint | `@Mod` class | `ModInitializer.onInitialize()` |
\n| Lifecycle hooks | Forge server events | `ServerLifecycleEvents` |
\n| Tick hook | `TickEvent.ServerTickEvent` | `ServerTickEvents.END_SERVER_TICK` |
\n| Chunk-load hook | `ChunkEvent.Load` | `ServerChunkEvents.CHUNK_LOAD` |
\n| Command hook | `RegisterCommandsEvent` | `CommandRegistrationCallback.EVENT` |
\n| Logging | Forge `LogUtils` | SLF4J `LoggerFactory` |<\/p>\n
\n– Simple block-color palette: no resource pack textures or biome tinting yet.
\n– Render commands currently target Overworld only, although tile storage supports all three vanilla dimensions.
\n– `fullrender` renders a square around spawn, not every existing region file.
\n– Unloaded or ungenerated chunks stay transparent until rendered\/generated; previously rendered pixels are preserved during re-renders.
\n– No authentication and no HTTPS; anyone with network access to port 8123 can view the map.
\n– Only zoom level `0` is rendered natively; Leaflet scales it visually for other zoom levels.<\/p>\n","protected":false},"excerpt":{"rendered":"