GlymeraWebMap

GlymeraWebMap — 你的世界，在浏览器中实时呈现

一个服务器世界的实时地图，任何人都可以在网页浏览器中打开 — 如同 Hytale 版的 Dynmap。 该插件直接从你的游戏服务器提供地图服务：无需网络托管、无需外部服务、无需账户。安装 jar 文件，打开 http://<你的服务器IP>:8123，然后将链接分享给玩家即可。

---

什么是 GlymeraWebMap？

一张你服务器的持久且不断扩展的地图。当玩家在游戏中探索时，插件会将世界从 Hytale 自身的制图数据渲染成地图瓦片，并通过内置的网页提供访问。所有曾经被绘制过的内容会永久保留在地图上 — 它会随着服务器重启而不断增长，慢慢构建出你世界的完整画面，访客无需启动游戏，即可在任何设备上浏览。

---

功能特性

• 实时玩家标记。 查看谁在线以及他们的位置，每几秒更新一次。点击在线列表中的名字即可直接跳转至该玩家，并跟随他们的移动观看他们探索新土地。
• 平移和缩放查看器。 拖拽平移，滚动缩放，并带有光标下方的坐标读数。简洁的深色主题，同样适用于手机和平板。
• 多世界支持。 每个世界都有其专属地图；可通过世界选择器切换。一旦玩家访问新世界，新地图便会自动出现。
• 持久探索。 地图永不遗忘：即使区块卸载或所有玩家下线，地形依然可见。随着数日的游玩，它将逐渐成长为服务器世界的完整地图集。
• 完全自托管。 网页、地图瓦片及所有数据都只存在于你的服务器上。不会向任何外部服务发送任何信息。

---

面向管理员 — 两步设置

1. 将 jar 文件放入服务器的 mods/ 文件夹并启动服务器。 安装到此完成 — 配置文件会自动生成并使用合理的默认值。
2. 在防火墙或主机服务商面板中开放 TCP 端口 8123（这是插件无法替你完成的一步）。如果 8123 被占用，可以在配置文件中修改端口。

然后，以 OP 身份在游戏中为地图设置服务器名称：

/webmap title 我的精彩服务器

页面会在数秒内显示该名称。/webmap（仅限 OP）命令可用来查看状态和分享链接。

可选设置 位于 mods/de.glymera_GlymeraWebMap/config.json 文件中：

• playerMarkers: false — 在页面上隐藏实时玩家位置（隐私保护）
• port / bindAddress — 网页服务器的监听地址和端口
• title — 页面标题，如果你更倾向于编辑文件而非使用命令
• 渲染频率与预算 — 已提供合理的默认值，无需额外调整

---

须知事项

• 地图由游戏原生制图数据以原始分辨率渲染，因此始终与玩家在游戏内地图上看到的内容一致。
• 瓦片渲染仅针对在线玩家附近区域，在后台线程中执行，并设有严格的单次预算 — 对游戏世界刻数（tick）性能无任何影响，且空闲服务器不会进行任何地图渲染工作。
• 瓦片是位于 mods/de.glymera_GlymeraWebMap/tiles/ 目录下的纯 PNG 文件 — 备份轻而易举，删除它们只会重置地图（随着玩家探索，地图会重新生成）。
• 浏览器会积极缓存瓦片；页面仅在其像素内容实际发生变化时才会重新下载瓦片。少量打开的浏览器地图页面几乎不会对服务器造成负载。
• 插件独立运行 — 无需其他插件支持。

数据目录：mods/de.glymera_GlymeraWebMap/

---

由 Glymera 为 Hytale 社区精心制作