BlueMap — 用于在浏览器中生成Minecraft交互式3D世界地图的插件

BlueMap — 用于在浏览器中生成Minecraft交互式3D世界地图的插件

BlueMap是一个Minecraft插件，它读取世界文件并据此构建一个三维表面模型，可以通过内置的Web服务器在浏览器中访问。标准客户端只渲染玩家周围的世界，不提供自上而下或从外部观看的视图。该插件形成了一个完整的地图，能够旋转相机、切换到透视或等距（平面）模式，只需访问一个URL即可查看结构。它解决了一个问题：无需登录游戏即可从外部查看服务器世界。

渲染如何工作

该插件将区块分成图块（tiles），并生成两个详细图层：具有完整方块几何形状的hires模型和用于远距离查看的lowres地图。在近距离缩放时，Hires处于激活状态 — 此时可以看到特定的方块、纹理和高度。在进一步缩小时，会加载一个带有生物群系色块和景观的简化图层。

Web界面中的渲染过程：在缩放期间逐渐加载图块。 

渲染在单独的线程池中异步执行。此时不会阻塞Minecraft服务器线程 — 只要CPU有空闲内核，玩家就不会因为构建地图而感到卡顿。插件本身会跟踪世界中的变化：BlueMap定期检查mca文件，发现更改的区块并仅重新渲染它们。像 /bluemap update 这样的手动命令很少需要 — 主要是用于诊断。

在Web界面中以第一人称进行渲染 

命令

插件注册了一个带有子命令的根命令 /bluemap。在大多数情况下，根本不需要任何命令 — 渲染会自动进行。

执行 /bluemap 命令 

配置

插件文件夹包含四个配置文件：core.conf、plugin.conf、webapp.conf、webserver.conf。以及三个子文件夹：maps/（每个世界一个 .conf）、packs/（用于渲染的资源包）和 storages/（file.conf 用于文件系统，sql.conf 用于SQL数据库）。

core.conf

主文件。关键参数是 accept-download，在第一次启动时需要将其设置为 true。参数 render-thread-count（默认 1）设置渲染线程数 — 负值表示“CPU核心数减去该数字的绝对值”。metrics (true) 控制匿名统计信息的发送。

plugin.conf

玩家在地图上的可见性和渲染行为的参数：

webapp.conf

Web应用程序设置。default-to-flat-view (false) 决定初始视图 — 透视或等距。滑块 hires-slider-default (100) 和 lowres-slider-default (2000) 以方块为单位设置详细和简化渲染的距离。resolution-default (1) 接受值 0.5、1 或 2。数组 scripts 和 styles 连接自定义的JS和CSS文件。

webserver.conf

内置Web服务器。enabled (true) — 启用或禁用。port (8100) — 端口。webroot ("bluemap/web") — 包含Web应用程序文件的目录（必须与 webapp.conf 中的 webroot 匹配）。log 部分配置文件中HTTP活动的记录。

结论

BlueMap提供了以成熟的3D模型形式从外部查看世界的机会，并支持相机旋转和自由飞行。该插件非常适合生存和RPG服务器，在这些服务器中，玩家共享坐标和检查建筑物非常重要；对于没有永久世界的迷你游戏服务器，它是多余的。