
你的 Minecraft 世界的实时地图,等距或俯视视角,在浏览器和游戏内均可查看。
TAERRA 将服务器的世界渲染成任何人都可以在浏览器中打开的地图,以方块为单位绘制,带有阳光和阴影效果,可从上方或从四个侧面以一定角度观看。随着世界的变化,它会自动保持更新,显示谁在线以及所在位置;通过可选的 Fabric 模组,玩家可以将相同的地图作为小地图使用,并在游戏内获得完整的世界地图。
所有内容均在服务器端渲染。访客和玩家只需下载已完成的图像,因此无论在手机还是游戏 PC 上,地图加载速度都同样快速。
在 map.corpium.net 上实时预览 →


TAERRA 目前处于早期开发阶段。它已经能够在实时服务器上运行,但尚未具备完整功能,你可能会遇到错误或粗糙之处。随着版本迭代,内容仍可能发生变化。
如果出现问题、外观异常,或者你有改进建议,请在 GitHub 上报错:每一份反馈都能帮助 TAERRA 变得更好。欢迎在 Discord 提问交流。

一张值得欣赏的地图
- 等距与俯视视角。 随时切换。等距视角支持四个方向旋转,确保没有物体被山脉遮挡。
- 每个方块,一个立方体。 光照、阴影和生物群系着色,从整个世界概览到单个方块细节一览无余。
- 预告片般的光影效果。 温暖的阳光与清冷的天空,使阴影呈现蓝紫色而非浑浊的灰色。
- 可透视的水面。 珊瑚礁散发绿松石色光芒,海沟渐变为深蓝色,沉没的建筑清晰可见。
- 所有维度。 主世界、下界、末地以及自定义世界,各自拥有独立的地图。
- 彩色或灰度。 当标记比地形更重要时,可将地图切换为灰度模式。
实时更新
- 玩家实时移动。 每秒更新一次,附带玩家列表,并支持跟随模式,即使跨维度也能锁定目标视野。
- 定位栏配色。 每位玩家的颜色与其在定位栏上的圆点颜色一致,让你一眼就能识别地图上及游戏中的玩家身份。
- 地图自动更新。 每次变化都会被记录——无论是玩家建造还是自然生长——并按你设定的间隔重新渲染,默认为每 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 将你现有的标记迁移为路标,每组标记集成为一个路标组,每个图标匹配最近的内置图标。

- 几分钟内呈现整个世界。 在配备 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 为可选安装,用于提供设置界面。

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

- 插件: Paper 26.3 及 Java 25。不支持 Spigot 和 Folia。
- 模组: Fabric Loader、Fabric API 以及 Minecraft 26.3,且服务器需运行 TAERRA 插件。
- 更新: 当两者同时推出新版本时,请先更新插件。若模组版本高于服务器插件版本,会提示玩家联系管理员进行更新。插件与模组共享同一个构建计数器,因此它们的构建版本号会跳跃且不要求完全一致。
渲染线程数与缓存大小均可配置,由你自行决定地图可占用的 CPU 和内存资源。

你可以在 map.corpium.net 查看 TAERRA 在实际服务器上的运行效果;若对其底层工作原理感兴趣,请阅读 技术深入解析。欢迎在 Discord 提问,或在 GitHub 提交 Bug 报告与建议。
TAERRA 可免费用于任何服务器,包括商业服务器。其源代码托管于 GitHub,许可证 中载明了详细条款。
非官方 Minecraft 产品。未经 Mojang 或 Microsoft 批准或认可。

A live map of your Minecraft worlds, isometric or top-down, in the browser and in game.
TAERRA renders your server's worlds into a map anyone can open in a browser, drawn block by block, with sunlight and shadows, seen from above or at an angle from all four sides. It keeps itself up to date as the world changes, shows who is online and where, and with the optional Fabric mod, players get the same map as a minimap, and a full world map in game.
Everything is rendered on the server. Visitors and players only download finished images, so the map is as fast on a phone as on a gaming PC.
See it live on map.corpium.net →


TAERRA is early in its development. It already runs on live servers, but it is not feature complete yet, and you may run into bugs or rough edges. Things can still change between versions as it grows.
If something breaks or looks wrong, or you have an idea, please report it on GitHub: every report helps make TAERRA better for everyone. Questions are welcome on Discord.

A map worth looking at
- Isometric and top-down views. Switch any time. The isometric view turns in four directions, so nothing hides behind a mountain.
- Every block, one cube. Lit, shaded, and biome-tinted, from the whole world at a glance down to a single block.
- Light like a trailer. A warm sun and a cool sky, so shadows turn blue-violet instead of muddy gray.
- Water you can see into. Reefs glow turquoise, trenches fade to navy, and a sunken build shows through.
- Every dimension. Overworld, Nether, End, and custom worlds, each on its own map.
- Color or gray. Switch the map to gray when the markers on it matter more than the terrain.
Live
- Players move live, updated every second, with a player list, and a follow mode that keeps someone in view, even across worlds.
- Colors from the Locator Bar. Every player wears the color of their dot on the Locator Bar, so you know who is who at a glance, on the map and in game.
- The map updates itself. Every change is recorded, built by players or grown by nature, and redrawn at an interval you choose, 15 minutes by default. A spot changed a hundred times is drawn once.
- Watch it render. A render shows its progress right on the map, with the time it has left, in the browser and in game. Staff start a full render of a world, or cancel one, from the map's right-click menu.
- Discover the world. Discoverable regions stay under fog on your map until you walk into them, then clear for you alone, with a sound and a burst of sparks on the web map, a toast in the mod, or a line in chat without it. Every region shows as an outline in its own color, and gets its name and fill once you've found it, so you always see what is left to explore.
- Installable as an app on phones and desktops, when the map is served over HTTPS.
Made for servers
- Logins without passwords. The map's login menu shows a short code: type
/taerra login <code> in game and that browser logs in by itself. /taerra login on its own sends a link instead, and a browser that is logged in shows a QR code that logs in a phone. Browsers stay logged in for 30 days, codes and links work once, for five minutes, and players are told in game whenever a browser logs in as them. /taerra devices, the map's account menu and the mod list every device that is logged in and log out any one of them. There are no accounts to create and no passwords to leak. Banned players are logged out of the web map on their own, and /taerra logout <player> logs anyone out by hand, say after taking their permissions away.
- Private worlds and layers. Keep a world or a layer hidden from everyone except logged-in players with the right permission. Or keep only where players in a world are private: everyone still sees who is online and in which world, and only staff see where. Players in worlds a viewer can't see are listed too, in an unknown world.
- Teleport from the map. Logged-in players with permission right-click the map to teleport there.
- Waypoints, areas, and lines in named groups and colors, private ones too, each with an optional description. Players with permission draw, move, and recolor them right on the map, in the browser or in game, with areas traced from selected chunks or clicked point by point, and lines straight or smooth. Every waypoint is a pixel badge in its color with an arrow pointing at the spot, edged in gold if it's a personal one, and an icon on it: 39 built in, any 8 × 8 PNG your staff upload or draw pixel by pixel on the web map or in the mod, or icons other plugins add. A layer can give its icon to every waypoint in it without one of its own. The mod shows waypoints as labels in the world itself, icons included.
- Waypoints of your own. Every logged-in player can keep up to 100 waypoints, areas, and lines only they see, in the browser and in game. Without an icon of their own they show a gem, and their areas and lines are dashed, so they never pass for the server's. A list of them, on the web map and in the mod, sorts by name or distance, filters by world, hides single ones from the map, and exports any of them to a JSON file to share or back up, which imports again by adding to yours or replacing them. When you die, a Last Death waypoint marks the spot, replacing the one before. Other plugins can show players their own markers the same way, like their homes.
- Privacy built in. Players in spectator mode, invisible or vanished, don't appear, and neither does anyone with
taerra.hide. Staff with taerra.see.hidden-players still see them, marked as hidden, and staff with taerra.see.fog see through the fog of every region. Players who turned off server listings in their client show as an anonymous gray dot. Player heads are served by your server, so viewing the map never reveals a visitor's address to Mojang.
- One jar. No external database, no CDN, and no separate admin panel: everything is configured in game, or on the settings page of the web map and the mod.
- A settings page for staff with
taerra.config, in the browser and in the mod: which worlds are on the map, their order and names, where each map ends, private worlds, layers and players, the built-in layers, the server name, the join hint, and how the renderer and its caches run. Every change applies right away, without a restart. Several staff can edit at once: the page shows who else has it open, and where, updates live as others save, and when two people changed the same setting, asks which to keep. Each setting shows who changed it last. The web server's port and address stay in game only, so the page can never cut itself off.
- Right-click any place to copy its coordinates, or a link straight to it.
- Search everything. Press
/ to find players, markers, worlds, or coordinates across every world, and jump there. The mod has the same search on a key of its own.
- Limit the map to a circle, square, or rectangle, so it ends where your playable area does, with
/taerra limit or on the settings page.
- Select chunks on the map, in the browser or in game, to render them again.
- Regions you draw chunk by chunk, in the browser or in game, each with a name shown on the map. Hide a region under fog while staff build there, or veil it in thin fog that only hints at what lies beneath. Make it discoverable, and every player clears the fog for themselves by walking in, a fog of war that is theirs alone. Players inside a region are hidden from everyone who hasn't discovered it.
- Loaded chunks as a private layer for staff, outlined by load level (entity ticking, ticking, loaded), with each area's players, force-loaded chunks and plugin tickets.
- Export the map as images with
/taerra render image.
- English and German in the web map, the mod, and every in-game message.
Plays well with others
- WorldGuard: regions as a layer, private to staff unless you share it.
- Towny: towns as a layer, each with its mayor, nation and residents.
- GriefPrevention: claims as a layer, private to staff unless you share it.
- PlotSquared: claimed plots as a layer, each with its owners and members.
- World borders: the vanilla world border and ChunkyBorder's borders as a layer.
- Chunky: while Chunky pre-generates a world, TAERRA stays out of its way, then tells you when a full render is worth starting.
- dynmap: bring your existing markers over as waypoints with
/taerra import dynmap, each marker set becoming a waypoint group and each icon the closest built-in one.

- A whole world in minutes. A 6,000-block-radius world, about 440,000 chunks, renders in every view, top-down and all four isometric rotations, in 2 minutes 21 seconds on an Intel Core Ultra 7 265 with 64 GB of RAM.
- Easy on your server. Live updates cost the main thread about 2 ms per tick, full renders nothing at all: rendering runs on its own threads, half your CPU cores by default, always leaving at least two to the game.
- Light on disk. Tiles are stored as compact indexed PNGs and only rewritten when they actually changed.

The optional Fabric mod brings the server's map into the game. Join a server running TAERRA, and it connects by itself, already logged in, so no /taerra login is needed in game:
- a full world map on M that does everything the web map does: both views and all four rotations, layers, players and follow mode, waypoints, search on K, teleporting, chunk selection, and render progress. Right-click any spot to navigate there, set a waypoint, or copy its coordinates or a link
- a minimap you can size, zoom, place on either side, and turn with the player, with the lines you pick below it: coordinates, Nether coordinates, chunk, facing, biome, weather, time, day, light level, real time, and FPS
- waypoints in the world as labels where they are, with the distance, hidden and shown with B, a list of your own on J to filter, sort, hide, export and import them, and a key to set one where you stand, H by default
- navigation to a waypoint, a player, or any spot on the map, started in game or from the web map while you play: a beacon beam where it is, and an arrow with the distance at the top of the screen, through the Nether too
- the server's settings page for staff with
taerra.config, the same as on the web map, from the mod's settings
It only works on servers running the TAERRA plugin, and it renders nothing itself: it draws the images the server already made. It needs Fabric API. Mod Menu is optional, for the settings screen.

- Install. Put the plugin jar in
plugins/ and start the server. On its first start, Paper's library loader downloads the libraries the plugin needs, so the server needs internet access once.
- Choose your worlds. None are on the map until you enable them:
/taerra config world minecraft:overworld enable
- Render.
/taerra render full minecraft:overworld draws the whole world. From then on, changes are drawn automatically. /taerra status shows the progress.
- Open the map at
http://<your-server>:8100.
- Make it public. Put the map behind a reverse proxy with HTTPS, on its own domain or under a path like
/map/, and set its address with /taerra config web.public-url https://map.example.com. Login links and link previews in chat apps use it.
- Name it.
/taerra config web.name "My Server" shows your server's name in the map's header, page title, and link previews.
Every setting can also be changed in game with /taerra config, or on the settings page of the web map and the mod.

| Command |
What it does |
/taerra status |
What the renderer is doing, with details on hover |
/taerra render full <world> |
Render a whole world |
/taerra render radius <world> <radius> [x z] |
Render an area around you, around spawn, or around a point |
/taerra render image <world> [zoom] |
Export the map as images |
/taerra render cancel |
Stop a running render |
/taerra render flush |
Drop every queued tile, unrendered changes included |
/taerra limit <world> circle|square|rectangle … |
Set how much of a world the map shows |
/taerra config … |
Change settings, enable, name, order and hide worlds, make layers private or give them an icon |
/taerra waypoint add|remove … |
Add or remove waypoints |
/taerra import dynmap <file> |
Import markers from dynmap |
/taerra login [code] |
Log in to the web map |
/taerra logout [player] |
Log out of the web map in every browser |
/taerra devices |
See and log out your web map devices |
/taerra mod |
See who plays with the TAERRA mod, and which build |
/taerra debug |
Copy the versions and setup a bug report needs |

| Permission |
Default |
Allows |
taerra.login |
everyone |
/taerra login, /taerra logout and /taerra devices, and being logged in by the mod |
taerra.logout.others |
op |
Logging other players out with /taerra logout <player> |
taerra.status |
op |
/taerra status |
taerra.mods |
op |
/taerra mod |
taerra.debug |
op |
/taerra debug |
taerra.teleport |
op |
Teleporting from the map and the waypoint list |
taerra.render.world |
op |
Rendering a whole world again, with /taerra render full or from the map |
taerra.render.area |
op |
Rendering an area again, with /taerra render radius or by selecting chunks on the map |
taerra.render.cancel |
op |
Canceling the running render, with /taerra render cancel or from the map |
taerra.render.flush |
op |
/taerra render flush |
taerra.render.image |
op |
/taerra render image |
taerra.limit |
op |
/taerra limit |
taerra.config |
op |
/taerra config and the settings on the map and in the mod |
taerra.import |
op |
/taerra import |
taerra.waypoint.edit |
op |
Adding, editing, moving and removing the server's waypoints, with /taerra waypoint or on the map |
taerra.waypoint.private-groups |
op |
Creating private waypoint groups |
taerra.waypoint.personal |
everyone |
Keeping waypoints only you see |
taerra.waypoint.death |
everyone |
Getting a personal waypoint where you last died |
taerra.icon.edit |
op |
Uploading, renaming, replacing and deleting the server's map icons |
taerra.region.edit |
op |
Drawing, naming, fogging and removing regions |
taerra.region.reset |
op |
Resetting who discovered a region, with taerra.region.edit |
taerra.see.hidden-players |
op |
Seeing hidden and anonymous players on the map |
taerra.see.fog |
op |
Seeing through every region's fog, and the players in it |
taerra.world.<world> |
op |
Seeing a private world, such as taerra.world.minecraft.the_end |
taerra.players.<world> |
op |
Seeing where players are in a world with private players, such as taerra.players.minecraft.overworld |
taerra.layer.<layer> |
op |
Seeing a private layer, such as taerra.layer.worldguard |
taerra.hide |
nobody |
Being hidden from the map |
The web map picks up permission changes while a player is online. With LuckPerms it picks them up right away for players who are offline too.

- Plugin: Paper 26.3 and Java 25. Spigot and Folia are not supported.
- Mod: Fabric Loader, Fabric API, and Minecraft 26.3, on a server running the TAERRA plugin.
- Updates: when a new version of both comes out, update the plugin first. A mod newer than the server's plugin tells players to ask the server to update. Plugin and mod share one build counter, so their build numbers skip and don't have to match.
Render threads and cache sizes are configurable, so you decide how much CPU and memory the map may use.

See TAERRA running on a real server at map.corpium.net, and if you are curious how it works under the hood, read the technical deep dive. Questions are welcome on Discord, bug reports and ideas on GitHub.
TAERRA is free to use on any server, commercial ones included. Its source code is available on GitHub, and the license has the details.
NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.
评论 0
登录后参与评分
还没有评论,来抢沙发吧