使用Bluemap将存档展示到网页

作者：UpSGE

前言

本文使用 Bluemap 将 Minecraft 存档渲染为可在网页中查看的 3D 模型，并将模型部署到静态网站服务器上。

Bluemap 介绍

BlueMap 是一个将你的 Minecraft 世界渲染成 3D 模型的程序。并且可以通过 Web 应用在浏览器中查看。
支持的平台：Spigot/Paper/Folia/Fabric/Forge/NeoForge/Sponge，以及 CLI 程序用于支持 Vanilla。

具体的配置方法在配置文件中注释得非常详细了，这里不再赘述。

注意事项

1. 如果要导出并部署到静态网站服务器上，需要将储存类型设置为 file，否则需要 php 支持。
2. 如果要展示完整洞窟结构，需要在世界配置中将 remove-caves-below-y 设置为一个很低的值，这通常在展示建筑时很有用。
3. 网页需要独占一个 tcp 端口，且需要确保你的服务商支持 http 服务。

静态部署

1. 将 Bluemap 调整为 file 储存类型并等待渲染完成。
2. 在服务器根目录找到 bluemap/web 目录，这个目录下就是渲染好的网页前端和模型文件。
3. 使用静态网站服务器（如 Nginx 等）将该目录设置为网站目录。并实现自动查找 gzip 压缩文件和修改 404 响应为 204。
4. 如果你的网站服务器不支持 gzip_static always，可以在 file.conf 中设置 compression: none 来禁用压缩功能。

# Nginx 配置
server {
  listen 80;
  server_name domain.com;
  
  root /var/www;
  
  location /maps/ {
    gzip_static always;

    location ~* ^/maps/[^/]*/tiles/ {
      error_page 404 = @empty;
    }
  }
  
  location @empty {
    return 204;
  }
}

• 当然如果你熟悉各种静态 Pages 服务和 CDN，也可以将模型部署到这些服务上。

Demo

方块江大废案-讲堂群

参考

• Bluemap 文档