- Home
- Minecraft World Map Viewers
- Worldlens
Worldlens
What it is
Worldlens is a TypeScript implementation of BlueMap for turning Minecraft worlds into browsable 3D maps. Its Windows desktop app can render local worlds offline through BlueMap’s Java renderer, which requires Java, or connect to remote BlueMap servers through a token-gated proxy. A standalone command-line interface renders and serves the map web app, including a watch mode for updates. Rendering can run locally, in Docker, on another machine over SSH, or through GitHub Actions. The project describes container images for the map web app and browser-based application interface, plus a Wharf desktop app for local or SSH deployment. Target world versions are Minecraft 1.12.2 through 26.x. Documented integrations include GitHub Pages and Home Assistant entities for scheduled settings. Marker and popup HTML is sanitized with DOMPurify. The MIT-licensed project supports offline viewing, server maps, live updates, dimensions, and markers. Windows releases are unsigned.
For and against
For
- Offline local world rendering
- Remote BlueMap server browsing
- Live map update watch mode
- Docker, SSH, and GitHub Actions options
- MIT licensed
Against
- Public 1.0 contract is Windows-only
- Windows releases are unsigned
- Java required for local rendering
- Some features remain future work
The verdict
Worldlens offers several ways to render and browse Minecraft maps, from a Windows desktop app to containers and CLI workflows. Its Windows compatibility contract and unsigned releases are important considerations.
Who it suits
Worldlens suits Minecraft world owners who want offline rendering or browser access to maps served by BlueMap. It also fits users comfortable with Windows, containers, SSH, or command-line workflows.
On the record
- CLI
- The standalone CLI renders and serves the map web app, with a watch mode for map updates.github.com · read 30 Sep 2026
- Compatibility limit
- The project’s public 1.0 compatibility contract is Windows-only.github.com · read 30 Sep 2026
- Containers
- The project describes one container image for the CLI map web app and another that serves the desktop application interface in a browser.github.com · read 30 Sep 2026
- Integrations
- Documented integrations include remote BlueMap servers, Docker, SSH, GitHub Actions, GitHub Pages, and Home Assistant boolean entities for scheduled settings.github.com · read 30 Sep 2026
- Intended users
- The project describes workflows for Minecraft world owners who want to render local worlds or browse maps served by BlueMap servers.github.com · read 30 Sep 2026
- License
- The repository states that Worldlens is MIT licensed.github.com · read 30 Sep 2026
- Local rendering
- The desktop app renders local worlds offline using upstream BlueMap’s Java renderer, which requires Java.ding-ding-projects.github.io · read 30 Sep 2026
- Maker
- The repository is published under the Ding-Ding-Projects GitHub organization; the opened pages do not state a headquarters or founding date.github.com · read 30 Sep 2026
- Minecraft versions
- The stated target world versions are Minecraft 1.12.2 through 26.x.github.com · read 30 Sep 2026
- Notable limits
- The project lists a multi-server dashboard, partial marker authoring, an add-on system, and static export among future work.github.com · read 30 Sep 2026
- Not yet available
- The project lists an add-on system, static export, and multi-server dashboard among future work.github.com · read 30 Sep 2026
- Privacy
- The documentation site says its executable dependencies and assets are served locally and that it has no analytics, advertising, tracking pixel, or runtime network fallback.ding-ding-projects.github.io · read 30 Sep 2026
- Purpose
- Worldlens is a TypeScript port of BlueMap for rendering Minecraft worlds into 3D maps and browsing them.github.com · read 30 Sep 2026
- Release caveat
- The project states that Windows releases are intentionally unsigned and may trigger a SmartScreen unknown-publisher warning.github.com · read 30 Sep 2026
- Release signing
- Windows releases are intentionally unsigned, and the project says SmartScreen may show an unknown-publisher warning.github.com · read 30 Sep 2026
- Remote maps
- The desktop app can connect to remote BlueMap servers and browse maps through a token-gated proxy.github.com · read 30 Sep 2026
- Remote rendering
- Renders can be run on another machine over SSH, in Docker, or through GitHub Actions.github.com · read 30 Sep 2026
- Security
- The project says marker and popup HTML is sanitized with DOMPurify and event listeners are used to support a strict Content Security Policy.github.com · read 30 Sep 2026
