Worldlens
github.com
- Free plan
- Windows
- Linux
- Web
- API
- Self-hosted
What Worldlens is
Worldlens is a free TypeScript port of BlueMap for rendering Minecraft worlds as 3D maps and browsing them. 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 CLI renders and serves the map web app, including a watch mode for live updates. The project also describes two container images and a Wharf desktop app for local or SSH deployment. Rendering can run on another machine over SSH, in Docker, or through GitHub Actions. Documented integrations include GitHub Pages and Home Assistant boolean entities for scheduled settings. Target world versions span Minecraft 1.12.2 through 26.x. The repository is MIT licensed. Documentation covers features, configuration, failure modes, security, and verification. Windows releases are unsigned, and the public 1.0 compatibility contract is Windows-only. Add-ons, static export, and a multi-server dashboard are future work.
Who it suits
Worldlens suits Minecraft world owners who need offline rendering or browser access to maps served by BlueMap. It also fits users deploying rendering through containers, SSH, Docker, or automation services.
Good to know, and what to watch
- Offline local-world rendering
- Remote BlueMap server support
- CLI watch mode for updates
- Docker and SSH deployment
- MIT licensed
- Java required for local rendering
- Public 1.0 contract is Windows-only
- Windows releases are unsigned
- Several features remain future work
The verdict
Worldlens offers multiple ways to render and browse Minecraft maps, from an offline desktop app to CLI, containers, and remote workflows. Check the Windows compatibility contract, Java requirement, unsigned releases, and unfinished features before adopting it.
What the maker publishes
- CLI
- The standalone CLI renders and serves the map web app, with a watch mode for map updates. source
- Compatibility limit
- The project’s public 1.0 compatibility contract is Windows-only. source
- Containers
- The project describes one container image for the CLI map web app and another that serves the desktop application interface in a browser. source
- Integrations
- Documented integrations include remote BlueMap servers, Docker, SSH, GitHub Actions, GitHub Pages, and Home Assistant boolean entities for scheduled settings. source
- Intended users
- The project describes workflows for Minecraft world owners who want to render local worlds or browse maps served by BlueMap servers. source
- License
- The repository states that Worldlens is MIT licensed. source
- Local rendering
- The desktop app renders local worlds offline using upstream BlueMap’s Java renderer, which requires Java. source
- Maker
- The repository is published under the Ding-Ding-Projects GitHub organization; the opened pages do not state a headquarters or founding date. source
- Minecraft versions
- The stated target world versions are Minecraft 1.12.2 through 26.x. source
- Notable limits
- The project lists a multi-server dashboard, partial marker authoring, an add-on system, and static export among future work. source
- Not yet available
- The project lists an add-on system, static export, and multi-server dashboard among future work. source
- 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. source
- Purpose
- Worldlens is a TypeScript port of BlueMap for rendering Minecraft worlds into 3D maps and browsing them. source
- Release caveat
- The project states that Windows releases are intentionally unsigned and may trigger a SmartScreen unknown-publisher warning. source
- Release signing
- Windows releases are intentionally unsigned, and the project says SmartScreen may show an unknown-publisher warning. source
- Remote maps
- The desktop app can connect to remote BlueMap servers and browse maps through a token-gated proxy. source
- Remote rendering
- Renders can be run on another machine over SSH, in Docker, or through GitHub Actions. source
- Security
- The project says marker and popup HTML is sanitized with DOMPurify and event listeners are used to support a strict Content Security Policy. source
- Site privacy
- The documentation site says its dependencies and media are served locally and that it has no CDN, analytics, advertising, tracking pixel, or runtime network fallback. source
- Support and documentation
- The documentation site says it provides an article for every feature, covering behavior, configuration, failure modes, security considerations, and verification. source
- Ways to run
- The project describes a Windows desktop app, two container images, and a separate Wharf desktop app for deploying a container locally or over SSH. source
- Web maps
- The standalone CLI can render and serve the map web app to browsers, and the project also describes a hosted container image for its application interface. source
Checked against the maker's pages on 30 Sept 2026.