TAERRA

模组

· 作者 aerulion

一个面向 Paper 服务器的实时等距和俯视网页地图,附带可选的 Fabric 模组,可将相同的地图作为小地图和世界地图带入游戏。

0 本站下载 0 关注 更新于 5 天前

需要前置:Fabric API

最新 86-4982d09 · 26.3 · Fabric

一键开服(送7天)

TAERRA

你的 Minecraft 世界的实时地图,等距或俯视视角,在浏览器和游戏内均可查看。

TAERRA 将服务器的世界渲染成任何人都可以在浏览器中打开的地图,以方块为单位绘制,带有阳光和阴影效果,可从上方或从四个侧面以一定角度观看。随着世界的变化,它会自动保持更新,显示谁在线以及所在位置;通过可选的 Fabric 模组,玩家可以将相同的地图作为小地图使用,并在游戏内获得完整的世界地图。

所有内容均在服务器端渲染。访客和玩家只需下载已完成的图像,因此无论在手机还是游戏 PC 上,地图加载速度都同样快速。

在 map.corpium.net 上实时预览 →

Showreel

Early access

TAERRA 目前处于早期开发阶段。它已经能够在实时服务器上运行,但尚未具备完整功能,你可能会遇到错误或粗糙之处。随着版本迭代,内容仍可能发生变化。

如果出现问题、外观异常,或者你有改进建议,请在 GitHub 上报错:每一份反馈都能帮助 TAERRA 变得更好。欢迎在 Discord 提问交流。

Features

一张值得欣赏的地图

  • 等距与俯视视角。 随时切换。等距视角支持四个方向旋转,确保没有物体被山脉遮挡。
  • 每个方块,一个立方体。 光照、阴影和生物群系着色,从整个世界概览到单个方块细节一览无余。
  • 预告片般的光影效果。 温暖的阳光与清冷的天空,使阴影呈现蓝紫色而非浑浊的灰色。
  • 可透视的水面。 珊瑚礁散发绿松石色光芒,海沟渐变为深蓝色,沉没的建筑清晰可见。
  • 所有维度。 主世界、下界、末地以及自定义世界,各自拥有独立的地图。
  • 彩色或灰度。 当标记比地形更重要时,可将地图切换为灰度模式。

实时更新

  • 玩家实时移动。 每秒更新一次,附带玩家列表,并支持跟随模式,即使跨维度也能锁定目标视野。
  • 定位栏配色。 每位玩家的颜色与其在定位栏上的圆点颜色一致,让你一眼就能识别地图上及游戏中的玩家身份。
  • 地图自动更新。 每次变化都会被记录——无论是玩家建造还是自然生长——并按你设定的间隔重新渲染,默认为每 15 分钟。同一位置若被修改上百次,也只渲染一次。
  • 观察渲染过程。 渲染进度直接显示在地图上,包括剩余时间,可在浏览器和游戏内查看。工作人员可通过地图右键菜单启动或取消整个世界的渲染任务。
  • 探索世界。 未发现的区域在你的地图上始终处于迷雾状态,直到你亲自踏入才会对你个人显现,同时在网页地图上伴有音效与火花特效,在模组中有提示框(toast),若无模组则仅在聊天栏显示一行文字。每个区域会以独立颜色的轮廓形式展示,一旦被发现就会获得名称并填充颜色,让你始终清楚还有哪些地方待探索。
  • 可作为应用安装。 当地图通过 HTTPS 提供服务时,可在手机和桌面设备上安装为应用程序。

专为服务器打造

  • 无需密码登录。 地图的登录菜单会显示一个简短代码:在游戏中输入 /taerra login <code>,浏览器即可自动完成登录。单独输入 /taerra login 则会发送一个链接;已登录的浏览器还会显示一个二维码,用于手机登录。浏览器保持登录状态 30 天,代码和链接仅可使用一次且有效期为五分钟。每当有浏览器以玩家身份登录时,游戏内都会通知该玩家。通过 /taerra devices(地图的账户菜单)和模组列表,可以查看已登录的所有设备并注销其中任意一个。无需创建账户,也无需担心密码泄露。被封禁的玩家会自动从网页地图登出,而 /taerra logout <player> 可手动将任何玩家登出,例如在收回其权限后使用。
  • 私密世界与层级。 将某个世界或层级对除拥有相应权限的已登录玩家外的所有人隐藏。或者仅隐藏世界中玩家的具体位置:所有人都能看到谁在线以及他们在哪个世界,只有工作人员能看到具体位置。对于查看者不可见的世界中的玩家也会列出,显示在“未知世界”中。
  • 从地图传送。 拥有权限的已登录玩家右键点击地图即可传送至该地点。
  • 路标、区域和线条 可按名称和颜色分组,包括私密组,每组均可选填描述。拥有权限的玩家可直接在地图(通过浏览器或游戏内)绘制、移动和重新着色这些元素。区域可通过选择区块或逐点点击进行追踪绘制,线条可为直线或平滑曲线。每个路标都是一个以其颜色显示的像素徽章,带有指向该位置的箭头;如果是个人专属路标,边缘会有金色边框,并且上面有一个图标:内置 39 种图标,也可由工作人员上传任何 8×8 PNG 图片,或在网页地图/模组中逐像素绘制,或由其他插件添加的图标。一个层级可以将其图标赋予其中所有没有专属图标的路标。模组会在游戏世界中以标签形式显示路标,包含图标。
  • 专属路标。 每位已登录玩家最多可保存 100 个仅自己可见的路标、区域和线条,可在浏览器和游戏内访问。若无专属图标,则显示为宝石形状;其区域和线条为虚线样式,以便与服务器默认设置区分开来。网页地图和模组均提供列表,可按名称或距离排序,按世界筛选,允许从地图隐藏单个项目,并支持导出为 JSON 文件以供分享或备份;导入时可选择追加到现有列表或替换全部。当玩家死亡时,会生成一个“最后死亡”路标标记当前位置,替换之前的记录。其他插件也可以类似方式显示玩家自己的标记,例如家园位置。
  • 隐私保护内置。 处于旁观模式、隐身或消失状态的玩家不会显示,拥有 taerra.hide 权限的玩家也不会显示。拥有 taerra.see.hidden-players 权限的工作人员仍可看到他们,但会标记为“隐藏”;拥有 taerra.see.fog 权限的工作人员可穿透所有区域的迷雾。在客户端关闭了服务器列表显示的玩家会以匿名灰色圆点显示。玩家头像由你的服务器提供,因此查看地图绝不会向 Mojang 泄露访问者的地址。
  • 单一 JAR 文件。 无需外部数据库、CDN 或独立管理面板:所有内容均可在游戏内配置,或在网页地图和模组的设置页面中进行设置。
  • 设置页面。 拥有 taerra.config 权限的工作人员可在浏览器和模组中访问设置页面:配置哪些世界显示在地图上、它们的顺序和名称、各地图的边界范围、私密世界、层级和玩家、内置层级、服务器名称、加入提示,以及渲染器和其缓存的运行方式。每项更改立即生效,无需重启。多名工作人员可同时编辑:页面会显示谁还打开了它以及所在位置,其他人保存时实时更新,若两人修改了同一设置,则询问保留哪一项。每项设置均显示最后修改者。Web 服务器的端口和地址仅存储在游戏端,因此设置页面永远不会导致自身断开连接。
  • 右键任意位置 可复制其坐标或直接生成指向该位置的链接。
  • 全局搜索。 按下 / 键可在所有世界中搜索玩家、标记、世界或坐标,并跳转至目标位置。模组也有独立的按键触发相同搜索功能。
  • 限制地图范围 为圆形、方形或矩形,使其与可游玩区域边界一致,可通过 /taerra limit 命令或在设置页面中完成。
  • 在地图中选择区块(通过浏览器或游戏内),以重新渲染它们。
  • 逐区块绘制的区域,可在浏览器或游戏内完成,每个区域在地图上均有名称显示。在工作人员建造期间,可将区域隐藏在迷雾之下,或用薄雾遮掩,仅隐约透露下方内容。设为可发现状态后,每位玩家进入该区域时便会自行清除迷雾,形成专属的战争迷雾。未发现该区域的玩家无法看到区域内的其他玩家。
  • 已加载区块 作为工作人员的私密层级,按加载等级(实体tick、区块tick、已加载)进行轮廓区分,并显示每个区域的玩家、强制加载区块及插件票证。
  • 导出地图为图片 使用 /taerra render image 命令。
  • 英文与德文 支持网页地图、模组及所有游戏内消息。

兼容性好

  • WorldGuard: 区域作为一层,仅对工作人员可见,除非你主动共享。
  • Towny: 城镇作为一层,每层包含镇长、国家及居民信息。
  • GriefPrevention: 领地作为一层,仅对工作人员可见,除非你主动共享。
  • PlotSquared: 已认领地块作为一层,每层包含所有者和成员信息。
  • 世界边界: 原版世界边界和 ChunkyBorder 的边界作为一层。
  • Chunky: 当 Chunky 预生成世界时,TAERRA 不会干扰,随后会在适合开始完整渲染时提醒你。
  • dynmap: 使用 /taerra import dynmap 将你现有的标记迁移为路标,每组标记集成为一个路标组,每个图标匹配最近的内置图标。

Speed

  • 几分钟内呈现整个世界。 在配备 64 GB RAM 的 Intel Core Ultra 7 265 处理器上,一个半径为 6,000 区块(约 440,000 个区块组)的世界,以俯视图和四种等轴测旋转角度渲染,仅需 2 分 21 秒。
  • 对服务器友好。 实时更新仅在主线程中每刻消耗约 2 ms,完整渲染则完全不占用:渲染运行在其独立的线程上,默认使用一半的 CPU 核心,始终至少保留两个核心供游戏使用。
  • 节省磁盘空间。 图块存储为紧凑的索引 PNG 格式,且仅在内容实际发生变化时重写。

模组

可选的 Fabric 模组将服务器的地图带入游戏中。加入运行 TAERRA 的服务器后,它会自动连接并已完成登录,因此无需在游戏中输入 /taerra login:

  • 完整的世界地图(按 M 键),功能与网页地图一致:支持两种视图和四种旋转角度、图层、玩家视角和跟随模式、路标、按 K 搜索、传送、区块选择以及渲染进度。右键点击任意位置可导航至该处、设置路标或复制其坐标或链接
  • 小地图,可调大小、缩放、放置于任一侧,并可随玩家转向;下方可选择显示以下信息行:坐标、下界坐标、区块、朝向、生物群系、天气、时间、日期、光照等级、现实时间以及 FPS
  • 世界中的路标,以标签形式显示在对应位置,带有距离信息,按 B 键隐藏或显示;按 J 键打开列表,可筛选、排序、隐藏、导出和导入自己的路标;按 H 键(默认)在当前站立位置设置一个路标
  • 导航至路标、玩家或地图上任意位置,可在游戏中启动,也可在游玩时从网页地图启动:目标处会显示信标光束,屏幕顶部显示带距离的箭头,下界中也适用
  • 服务器设置页面,供拥有 taerra.config 权限的管理员使用,与网页地图上的设置相同,可通过模组的设置界面访问

此模组仅在运行 TAERRA 插件的服务器上有效,且自身不进行任何渲染:它仅绘制服务器已生成的图像。需要 Fabric API。Mod Menu 为可选安装,用于提供设置界面。

快速上手

  1. 安装。 将插件 jar 放入 plugins/ 目录并启动服务器。首次启动时,Paper 的库加载器会下载插件所需的依赖库,因此服务器需一次性具备互联网访问权限。
  2. 选择你的世界。 未启用的世界不会出现在地图上:执行 /taerra config world minecraft:overworld enable
  3. 渲染。 /taerra render full minecraft:overworld 渲染整个世界。此后,所有更改都会自动绘制。执行 /taerra status 可查看进度。
  4. 打开地图,地址为 http://<your-server>:8100。
  5. 设为公开。 通过反向代理配合 HTTPS 将地图置于其独立域名下,或置于如 /map/ 这样的路径下,并通过 /taerra config web.public-url https://map.example.com 设置其地址。登录链接及聊天应用中的链接预览均会使用此地址。
  6. 命名。 /taerra config web.name "My Server" 可在地图页眉、页面标题及链接预览中显示你的服务器名称。

所有设置也可在游戏中通过 /taerra config 修改,或在网页地图和模组的设置页面中进行调整。

命令

命令 功能说明
/taerra status 查看渲染器当前状态,悬停可查看详细信息
/taerra render full <world> 渲染整个世界
/taerra render radius <world> <radius> [x z] 渲染你周围、出生点周围或指定坐标周围的区域
/taerra render image <world> [zoom] 将地图导出为图片
/taerra render cancel 停止正在进行的渲染任务
/taerra render flush 丢弃所有排队等待的图块,包括未渲染的更改
/taerra limit <world> circle|square|rectangle … 设置地图显示世界的范围
/taerra config … 修改设置,启用、命名、排序和隐藏世界,使图层私有或为其分配图标
/taerra waypoint add|remove … 添加或删除路标
/taerra import dynmap <file> 从 dynmap 导入标记
/taerra login [code] 登录网页地图
/taerra logout [player] 在所有浏览器中退出网页地图登录
/taerra devices 查看并注销你的网页地图设备
/taerra mod 查看哪些玩家使用了 TAERRA 模组及其构建版本
/taerra debug 复制版本信息和环境配置,用于提交错误报告

权限

权限 默认值 允许操作
taerra.login everyone /taerra login、/taerra logout 和 /taerra devices,以及通过模组登录
taerra.logout.others op 使用 /taerra logout <player> 将其他玩家登出
taerra.status op /taerra status
taerra.mods op /taerra mod
taerra.debug op /taerra debug
taerra.teleport op 从地图和航点列表进行传送
taerra.render.world op 使用 /taerra render full 或从地图重新渲染整个世界
taerra.render.area op 使用 /taerra render radius 或在地图上选择区块重新渲染区域
taerra.render.cancel op 取消正在进行的渲染,使用 /taerra render cancel 或从地图操作
taerra.render.flush op /taerra render flush
taerra.render.image op /taerra render image
taerra.limit op /taerra limit
taerra.config op /taerra config 以及地图和模组中的设置
taerra.import op /taerra import
taerra.waypoint.edit op 添加、编辑、移动和删除服务器的航点,使用 /taerra waypoint 或在地图上操作
taerra.waypoint.private-groups op 创建私人航点组
taerra.waypoint.personal everyone 保存仅自己可见的航点
taerra.waypoint.death everyone 获取个人死亡位置航点
taerra.icon.edit op 上传、重命名、替换和删除服务器的地图图标
taerra.region.edit op 绘制、命名、设置雾化和移除区域
taerra.region.reset op 重置区域的发现者状态,需配合 taerra.region.edit 权限
taerra.see.hidden-players op 在地图上查看隐藏和匿名的玩家
taerra.see.fog op 看透所有区域的迷雾及其中的玩家

| taerra.world.<world> | op | 查看一个私有世界,例如 taerra.world.minecraft.the_end | | taerra.players.<world> | op | 在拥有私有玩家的地图中查看玩家的位置,例如 taerra.players.minecraft.overworld | | taerra.layer.<layer> | op | 查看一个私有图层,例如 taerra.layer.worldguard | | taerra.hide | nobody | 从地图上隐藏 |

Web 地图会在玩家在线时自动同步权限变更。使用 LuckPerms 时,离线玩家的权限变更也能即时获取。

Requirements

  • 插件: Paper 26.3 及 Java 25。不支持 Spigot 和 Folia。
  • 模组: Fabric Loader、Fabric API 以及 Minecraft 26.3,且服务器需运行 TAERRA 插件。
  • 更新: 当两者同时推出新版本时,请先更新插件。若模组版本高于服务器插件版本,会提示玩家联系管理员进行更新。插件与模组共享同一个构建计数器,因此它们的构建版本号会跳跃且不要求完全一致。

渲染线程数与缓存大小均可配置,由你自行决定地图可占用的 CPU 和内存资源。

More

你可以在 map.corpium.net 查看 TAERRA 在实际服务器上的运行效果;若对其底层工作原理感兴趣,请阅读 技术深入解析。欢迎在 Discord 提问,或在 GitHub 提交 Bug 报告与建议。

TAERRA 可免费用于任何服务器,包括商业服务器。其源代码托管于 GitHub,许可证 中载明了详细条款。

非官方 Minecraft 产品。未经 Mojang 或 Microsoft 批准或认可。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源