如何在 Minecraft 服务器上安装 squaremap

squaremap 会为你的 Minecraft 世界生成一张平面地图，供玩家浏览。它需要一个端口来运行内置 Web 服务器，面板可以在安装时为其分配端口。

从面板安装

对于受支持的版本，面板可以为你安装 squaremap 并设置其 Web 端口。

1. 在控制面板中打开你的 Minecraft 服务器，创建备份并将其停止。
2. 打开 Plugins；如果是装有模组的服务器，则打开 Mods。将 Versions 保持为 Current version，搜索 squaremap 并点击其安装图标。选择与你的服务器软件和 Minecraft 版本相匹配的发行版。
3. 保持勾选 Configure automatically。在 Port 下，选择 Assign a new port 或一个未使用的次要分配端口。不要使用 Minecraft 主端口，也不要使用其他插件已占用的端口。

   

4. 点击 Install plugin 或 Install mod。安装完成后，启动服务器并使用下文所述的网址。

如果没有提供合适的下载或自动配置选项，请使用下方的手动方法。对于由面板跟踪的安装，已安装 JAR 文件旁边的 Change version 图标可以重新打开配置选项。

上传 squaremap 并手动设置端口

1. 停止服务器，然后从 squaremap 的发行版本中选择正确的 JAR。使用受支持的服务器平台（例如 Paper），或选择匹配的模组构建版本。普通 Spigot 服务器不能使用仅适用于 Paper 的发行版。
2. 在面板中打开 Files，再打开 plugins。将 JAR 拖入 File Manager，或使用 SFTP 将其上传到同一文件夹。模组构建版本应使用 mods 文件夹，并添加列出的依赖项，例如在需要时添加 Fabric API。启动服务器一次以生成配置，然后停止服务器。
3. 打开 Network，并在 Network 中创建额外的端口分配供地图使用。不要将该端口与 Minecraft、语音聊天或其他 Web 地图共用。
4. 在 Files 中，Paper 服务器编辑 plugins/squaremap/config.yml；装有模组的服务器或 Sponge 服务器编辑 config/squaremap/config.yml。
5. 找到 settings，然后找到 internal-webserver。保持其启用状态，将 0.0.0.0 用作绑定地址，并将端口替换为你的 Network 分配端口。例如：

   settings:
     internal-webserver:
       enabled: true
       bind: 0.0.0.0
       port: 25582

   

   编辑现有设置，并保留文件其余内容及缩进。仅更改 web-address 不会改变 Web 服务器监听的端口。
6. 保存文件并启动服务器。

在浏览器中打开 http://YOUR_SERVER_IP:YOUR_SQUAREMAP_PORT/。在区块完成渲染之前，地图可能为空。在游戏中运行 /map help，查看已安装版本中可用的命令，然后使用 fullrender 命令并指定世界名称，以渲染现有地形。