ATLAS // 2D-3D 实时网络地图

ATLAS // 2D-3D 实时网络地图

来自PYRETALE团队,我们为你的Hytale服务器带来一张实时网页地图:实时玩家与聊天,基于游戏实际方块模型构建的Dynmap风格3D等距视图,以及直接绘制在地形上的帝国领土。

实用

discord

ATLAS // 为你的 Hytale 服务器打造的 3D-2D 实时网页地图

PyreTale Atlas 直接由插件提供你世界的浏览器地图:无需外部渲染器、无需导出、无需第三方服务。打开一个页面,即可观看你的玩家移动,并平移浏览服务器曾经生成的每一个区块。可以把它想象成为 Hytale 从零开始打造的 Dynmap。

它自带两种视角:经典的俯视平面地图,以及旋转 3D 等距视图——后者按照世界的真实外观进行渲染:建筑有可见的墙壁,地形有起伏,水体有真实深度,屋顶、楼梯、栅栏和植物都从游戏自身的 .blockymodel 文件中读取,以真实的倾斜几何体绘制,而不是用彩色方块拼凑。

与 PyreTale Empires 协同运行:聚落领地会在 3D 视图中以整齐的、与区块对齐的轮廓线渲染,贴合各聚落自身的地面,并在地点标注,标明聚落实际所在的位置。

来看看我们新服务器 PYRETALE 的实时网页地图 点此在线查看

3D 等距渲染器

一种采用与 Dynmap 匹配相机参数(30° 倾角、45° 旋转)的光线投射渲染器。子方块形状、楼梯、栅栏、屋顶和道具均按每个方块真实的模型几何体绘制——包括旋转盒体和朝向卡片,因此倾斜的屋顶呈现为连续的平面而非阶梯状。逐面纹理区域、染色遮罩和生物群系颜色均按游戏的方式处理,读取客户端自身的规则。室内和洞穴会自然变暗。

计算天空光照

Hytale 磁盘上存储的天空光照不可靠,因此 Atlas 会为每个区块自行计算光照场(已用暴力参考实现对数百万个格子进行验证),并保留服务器记录的火把和岩浆的方块光照。阴影会投射在正确的位置。

一切皆实时

玩家会实时出现和移动。兴趣点、世界标记、死亡点、家园和聚落标签都带有高度,因此它们在 3D 中贴合地形,而不是悬浮在空中。支持多个世界,UI 中提供切换器——你可以运行任意数量的维度。

帝国领地叠加层

安装 PyreTale Empires 后,领地范围会以合并后的各聚落轮廓渲染,精确跟随已认领区块的边界,标签则保证位于该聚落实际认领的区块内。没有 Empires?Atlas 也能照常运行。

世界边界保护

越过世界边缘时,Atlas 会将你传送回你最后所处世界内的精确位置,保持你原来的朝向,并显示一条你自己编写的消息。再也不会在地图边缘坠入虚空而死。创造模式和拥有绕过权限的玩家可自由穿过。

快速完整渲染

相机感知的带状扫描使区块捕获保持局部化,背压机制让内存保持平稳,缩小视图可适配你的世界——无论你生成多大,整张地图都能显示在屏幕上。进度按阶段(2D、3D、金字塔)报告,并提供诚实的预计剩余时间。

方块美术零手工调校

任何地方都没有硬编码的方块列表。每个方块在启动时都会从服务器自身的资源中解析其外观——模型、碰撞箱、纹理、染色,启动审计会准确告诉你哪些内容已解析及其原因。

 


指令 功能说明
/atlas status 最重要的指令——相机、带各阶段预计剩余时间的渲染进度、外观/纹理审计、天空光照一致性、领地桥接状态。
/atlas fullrender 渲染整个世界(2D + 3D + 缩放金字塔)。异步准备;绝不会阻塞刻线程。
/atlas cancelrender 停止正在进行的完整渲染。
/atlas generate 为地图预生成区块——这是唯一会创建地面的指令。新生成区块的地图瓦片会自动排队并绘制。
/atlas verify 检查每个缩放级别是否有缺失或过期的瓦片,并准确报告需要修复的内容。
/atlas repair 重新渲染缺失或损坏的瓦片,并重建其上方的缩放级别。
/atlas pyramid 重建缩小视图瓦片。
/atlas preview --x= --z= --ratio= --azimuth= 以任意相机参数渲染一张一次性 PNG,不触碰缓存。
/atlas inspect 查看你所站区块的逐方块纹理和外观来源。
/atlas water / /atlas tilealpha 水体颜色/深度与瓦片透明度诊断。
/atlas border on/off 启用或忽略世界边界。
/atlas speed 限制渲染速度。
/atlas show / /atlas hide 切换标记图层显示。
/atlas reload / /atlas clearcache 重新加载配置 / 清除瓦片缓存

 

  1. 将 jar 文件放入服务器的 mods 文件夹并重启。
  2. 打开 http://<你的服务器IP>:8080(端口可在 atlas.json 中配置)。
  3. 运行 /atlas fullrender,并通过 /atlas status 查看各阶段进度。
  4. 可选:安装 PyreTale Empires,领地便会自动显示。
  5. 根据你的硬件调整 renderConcurrency、isoScanThreads 和 voxelCacheMb,状态界面会提示渲染何时受限于绘制阶段。

Hytale 服务器 0.6.0 或更新版本(Java 25)。不兼容 0.5.x,请随服务器升级一同安装。可选:PyreTale Empires 用于领地叠加层;Atlas 会自动检测它。

有 bug、功能请求,或想看看它大规模运行的样子?加入 Discord ,并访问通过 Hytale 启动器中的服务器发现页面找到的 PyreTale 社区服务器。

观看动态效果: PyreTale 官方预告片  |  Discord: discord.gg/pyretale 配套模组: Pyre Empires(领地叠加层)和 Pyre Gilded Dreams(玩家经济)。