Skip to content
SPECIFICTION
Get listed

Worldlens

github.com

WebWindowsLinuxAPISelf-hosted
Visit github.com
Spec score 7.1 #20 of 22 in Minecraft World Map Viewers

What it is

Worldlens is a TypeScript port of BlueMap for rendering Minecraft worlds into 3D maps and browsing them. The project describes a Windows desktop app, two container images, and a separate Wharf desktop app for deploying a container locally or over SSH. The desktop app can render local worlds offline using 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, with a watch mode for map updates. Rendering can also run on another machine over SSH, in Docker, or through GitHub Actions. Documented integrations include Docker, SSH, GitHub Actions, GitHub Pages, remote BlueMap servers, and Home Assistant boolean entities for scheduled settings. The stated target world versions range from Minecraft 1.12.2 through 26.x. The repository is MIT licensed. Its public 1.0 compatibility contract is Windows-only, and Windows releases are unsigned and may prompt a SmartScreen unknown-publisher warning. An add-on system, static export, and multi-server dashboard are listed as future work.

Spec sheet

Purpose
Worldlens is a TypeScript port of BlueMap for rendering Minecraft worlds into 3D maps and browsing them.Read 30 Sep 2026 · github.com
Intended users
The project describes workflows for Minecraft world owners who want to render local worlds or browse maps served by BlueMap servers.Read 30 Sep 2026 · github.com
Integrations
Documented integrations include remote BlueMap servers, Docker, SSH, GitHub Actions, GitHub Pages, and Home Assistant boolean entities for scheduled settings.Read 30 Sep 2026 · github.com
Security
The project says marker and popup HTML is sanitized with DOMPurify and event listeners are used to support a strict Content Security Policy.Read 30 Sep 2026 · github.com
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.Read 30 Sep 2026 · ding-ding-projects.github.io
License
The repository states that Worldlens is MIT licensed.Read 30 Sep 2026 · github.com
Maker
The repository is published under the Ding-Ding-Projects GitHub organization; the opened pages do not state a headquarters or founding date.Read 30 Sep 2026 · github.com
CLI
The standalone CLI renders and serves the map web app, with a watch mode for map updates.Read 30 Sep 2026 · github.com
Compatibility limit
The project’s public 1.0 compatibility contract is Windows-only.Read 30 Sep 2026 · github.com
Containers
The project describes one container image for the CLI map web app and another that serves the desktop application interface in a browser.Read 30 Sep 2026 · github.com
Local rendering
The desktop app renders local worlds offline using upstream BlueMap’s Java renderer, which requires Java.Read 30 Sep 2026 · ding-ding-projects.github.io
Minecraft versions
The stated target world versions are Minecraft 1.12.2 through 26.x.Read 30 Sep 2026 · github.com
Not yet available
The project lists an add-on system, static export, and multi-server dashboard among future work.Read 30 Sep 2026 · github.com
Notable limits
The project lists a multi-server dashboard, partial marker authoring, an add-on system, and static export among future work.Read 30 Sep 2026 · github.com
Release caveat
The project states that Windows releases are intentionally unsigned and may trigger a SmartScreen unknown-publisher warning.Read 30 Sep 2026 · github.com
Release signing
Windows releases are intentionally unsigned, and the project says SmartScreen may show an unknown-publisher warning.Read 30 Sep 2026 · github.com
Remote maps
The desktop app can connect to remote BlueMap servers and browse maps through a token-gated proxy.Read 30 Sep 2026 · github.com
Remote rendering
Renders can be run on another machine over SSH, in Docker, or through GitHub Actions.Read 30 Sep 2026 · github.com
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.Read 30 Sep 2026 · ding-ding-projects.github.io
Support and documentation
The documentation site says it provides an article for every feature, covering behavior, configuration, failure modes, security considerations, and verification.Read 30 Sep 2026 · ding-ding-projects.github.io
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.Read 30 Sep 2026 · github.com
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.Read 30 Sep 2026 · github.com

Strong points and limits

Strong points

  • Local worlds can be rendered offline.
  • Remote BlueMap maps can be browsed through a token-gated proxy.
  • CLI watch mode supports map updates.
  • Rendering can run via SSH, Docker, or GitHub Actions.
  • Repository is MIT licensed.

Limits

  • Public 1.0 compatibility contract is Windows-only.
  • Local rendering requires Java.
  • Windows releases are unsigned and may prompt a warning.
  • Static export and a multi-server dashboard are future work.

Who it suits

Worldlens suits Minecraft world owners who want to render local worlds or browse maps provided by BlueMap servers. Its desktop, CLI, and container approaches address different ways to render and serve maps.

Verdict

Worldlens offers several ways to render or serve Minecraft maps, including offline desktop rendering and CLI workflows. Note the Windows-only 1.0 compatibility contract and unsigned Windows releases before installing.

Where Specifiction places it

Alternatives to WorldlensAll alternatives →