Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Worldlens

github.com

  • Free plan
  • Windows
  • Linux
  • Web
  • API
  • Self-hosted
7.5 Club score Visit github.com

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.