Register a farm
Mark a useful arrival point, such as the entrance or controls. Choose either method below and send one JSON file to the atlas administrator in the server group, with the owner, products, access instructions and useful AFK or operating notes.
Option 1 · On the website
- Select the correct dimension. Open Waypoints → + Add, or double-click an empty map location.
- Enter a name and X/Z, plus Y if known. An optional Chinese name is editable separately. Choose a shape/color, or expand Minecraft stuff and search for an item icon.
- Save and check the location. Choose Export mark in the details or row’s ⋯ menu, then send the downloaded JSON.
Option 2 · In Minecraft
Download THUNION Atlas · 1.6.3 · Fabric 26.3 ↓
- Use Java 26.3, Fabric Loader 0.19.5+ and a compatible Fabric API 0.160.5+26.3+. Put the JAR in your instance’s
mods folder, replace the previous Atlas JAR, and restart Minecraft. The server needs no mod. - Join
thunion.club, select your actual Main or Mirror backend in F9, and stand at the build’s marker location. - Press F8 or use
/atlasregister. Enter the name/icon, check the captured dimension and X/Y/Z, then choose Save JSON. Use position captures a new position if you have moved. - Open Output folder and send the new JSON. The default is
atlas-submissions in your game instance. Use My submissions to revise an earlier record; send only its newest file.
Saving or exporting does not publish a mark. The administrator reviews it and updates the shared site. To correct a shared entry, edit and export that existing mark so its ID stays the same.
In-game navigation
Install THUNION Atlas 1.6.3, then open F9. Main and Mirror are supported; legacy worlds and singleplayer are not. The backend selector is manual: confirm it after reconnecting or using /server main or /server mirror.
- Search a name or coordinates, choose Elytra or Walking, and select the destination.
- Follow the HUD and marker. Known Y uses the actual height; unknown Y uses a horizontal marker. Ordinary navigation stops within 3 blocks; Stop navigation cancels it.
- Routes use recorded portals, End gateways, roof windows and your respawn point, updating about every 10 seconds. Railways are not used for navigation.
Inside the Nether
In Elytra mode, search a bastion by atlas number, such as #168, for a smooth 3D flight route. Follow the entry marker to join the cyan line. The final approach seeks a visible bastion surface; buried or narrow entrances may still need walking. Under-roof flight routes replan after you stray at least 64 blocks from the line.
Press F6 to approach the nearest registered roof window, or search Nether roof window in F9. Land and climb through the opening yourself. New windows arrive with website data updates. Predicted corridors may differ from server terrain; the entry leg is ordinary coordinate guidance. Watch for obstacles and lava: this is guidance, not automatic flight.
Personal destinations and Mirror
F8 marks immediately become private destinations. In F9 → Local, select your saved Xaero waypoint world; after changes, use Refresh or /atlasnav reload. This reads xaero/minimap waypoints, not world-map images. Confirmed sleeping/respawn updates are recorded automatically; use Respawn point to correct a missing or outdated location.
The switch button sends /server mirror or /server main. Confirm the new backend after arrival. Mirror’s TP requires Creative mode, permission and confirmation; Main has no teleport action.
Shared data updates
Keep F9 → Data → Website (automatic) selected. The mod checks after backend selection and about every 10 minutes. Choose Update now or run /atlasnav update after publication. A failed download keeps the last valid cache. Replacing the JAR in the same game instance preserves your personal files and settings.
For offline use, choose Local files, save the download below as config/thunion-atlas-navigation-network.json, then run /atlasnav reload. config/thunion-atlas-navigation.json holds personal settings and respawn points; config/thunion-atlas-updates.json holds update settings. F8, Xaero and respawn data stay on your computer.
Download navigation data for local use ↓
Structures & counts
Select a dimension, expand Structures and tick the types you want. All structures toggles the current dimension’s layers; a mixed box means some are enabled. Layers start off on a fresh visit.
Click a pin or row for coordinates and details. Chambers show spawners and normal/ominous vaults; monuments show wet sponges and sponge rooms; bastions show placed gilded blackstone, excluding chest loot. Other structures and desert wells provide locations. Lists show 200 results per page; the map shows all matching pins.
The survey covers X/Z ±6000. Counts describe original generation, not remaining server blocks. Structure coordinates are location anchors, not guaranteed entrances.
Search across dimensions
Global search finds farms, waypoints, portals, gateways, stations and routes across dimensions, even when hidden. English and Chinese names work, as do facility products and owners.
Choose a result to focus it. Search 宝藏, for example, to find the Buried treasures layer checkbox. Narrow broad queries for more specific results.
Facility profiles contain recorded owners, products, status, usage notes and sources. Send corrections to the administrator; wiki changes do not update the atlas automatically. Click the club logo for the changelog; its exclamation badge announces unread entries.
Move around the map
- Drag to pan, scroll to zoom, and click a marker for details. On touch screens, drag and pinch.
- Use +/− to zoom and Fit area for the full survey. Grid toggles chunk-aligned grid lines.
- Names appear on hover. The readout shows the mouse X/Z and sampled biome.
- Switch 中文 / English in the header. Fold sidebar sections to make more room.
Terrain & cave layers
Map background offers the server snapshot, biome map and imported Xaero Nether roof. The roof view helps locate builds above Y127. Images are saved snapshots, without live player tracking; new buildings appear after the administrator refreshes them.
In Overworld, open Underground, enable the layer and choose Y. Toggle Deep Dark, Lush Caves, Dripstone Caves and Sulfur Caves separately. These are biome areas, not open-tunnel maps. Disable the layer to restore the surface.
Distance, filters & visits
Expand Your position above the results and enter the selected dimension’s X/Z. Use Find nearest or a distance sort. Portals and gateways also have position/sort controls. Re-enter your position after reloading.
Marks visibility controls custom waypoints and filters structures by visits or farm marks. A structure’s visit checkbox records that you have been there; it is separate from its visibility switch. Progress saves in this browser.
Waypoints & roof windows
Waypoints → + Add creates a location; double-clicking the map prefills X/Z. The row’s ⋯ menu edits, deletes or exports a mark. Names, Y, colors, shapes and Minecraft icons are editable. Import files accepts one or several compatible submission JSON files.
Register a Nether roof window
- Choose Nether and add/edit a waypoint at the opening’s X/Z.
- Set the type to Nether roof window. Check the lower/upper landing heights and choose Both directions, To roof only or From roof only to match actual access.
- Save, choose Export mark, and send the JSON to the atlas administrator in the server group for verification.
After approval and publication, the mod receives it automatically. Upward-capable windows can be roof-return destinations. An ordinary waypoint alone does not create a transport link.
Railways
In Overworld, the railway button shows/hides the network. Click a route for its stops. Planned lines are dashed; open lines are available for use.
In Railway, add a station or route and choose map editing. Click to place points and drag to adjust. Select a route point to edit coordinates, station attachment and turn radius together. Attached points follow moved stations; stops follow attachment order.
Ctrl+Z/Ctrl+Y undo/redo dragging while editing. Save commits; Cancel discards. Export railway JSON for a backup, or send Export shared railways to the administrator for publication.
Portals & End gateways
Open Portals in Nether to record a roof portal and its actual Overworld destination. Use measured coordinates; the 8:1 scale does not confirm a pairing. Overworld shows recorded return endpoints, with distance sorting to find a route home.
! means the Overworld portal cannot return to the roof. Record this when known; that endpoint is omitted from the Overworld return list. Confirm detected candidates in game.
In End, open End gateways to record the gateway and destination. A landing pin does not confirm a return gateway. Fill destination X and Z together, plus Y when known.
Show pins at all zooms keeps these pins visible in wide views. Export mark shares one record and its connection. In Nether, Map background → Show portal boundary toggles the ±750 dashed square.
Save, import & share
Visits and edited marks save in this browser. Save & share marks → Export marks makes a backup; Import marks restores it. Back up before changing browsers, devices or site addresses.
Use Export mark for one submission. Export shared map creates the administrator’s full marks.js snapshot; railways have a separate export. Downloading does not publish anything.
Shared data is the administrator’s baseline; your edits or deletions may override later shared updates. There is no account-based synchronization or automatic upload of private changes.
Import Xaero waypoints
Download the Xaero waypoint exporter ↓- Extract the ZIP and open
Export-Xaero-Waypoints.html, keeping xaero-waypoints.js beside it. - Select the relevant
xaero/minimap folder or waypoint TXT files. Choose the right server/world and check dimensions. - Select the points and choose Download selected JSON. For one new farm, export only that point.
- Load it with Waypoints → Import files, or send it with usage notes to the administrator.
The tool runs locally without Python and leaves saves unchanged. xaero/world-map contains terrain, not waypoints. Fill portal pairings and roof-window types separately.
登记农场
选择入口、控制台等适合到达的位置。下面两种方法都会生成单个 JSON 文件,交给服务器群内的地图管理员,并附上建造者、产物、到达方式、挂机位置和操作注意事项。
方法一 · 网页登记
- 切换到正确维度,打开标记点 → + 添加,或双击地图空白处。
- 填写名称和 X/Z,已知时补充 Y。中文名称可单独编辑。选择形状、颜色,或展开 Minecraft 物品搜索图标。
- 保存并检查位置,在详情或该行 ⋯ 菜单中选择导出单个标记,发送下载的 JSON。
方法二 · 游戏内登记
下载 THUNION Atlas · 1.6.3 · Fabric 26.3 ↓
- 使用 Java 26.3、Fabric Loader 0.19.5+ 和兼容的 Fabric API 0.160.5+26.3+。把 JAR 放入实例的
mods 文件夹,替换旧版 Atlas JAR 后重启;服务器无需安装。 - 进入
thunion.club,在 F9 选择实际所在的 Main 或 Mirror,站到设施的标记位置。 - 按 F8 或输入
/atlasregister,填写名称、图标,检查记录的维度和 X/Y/Z,点击保存 JSON。走动后可点使用当前位置重新获取位置。 - 点击输出文件夹发送新文件。默认目录为游戏实例内的
atlas-submissions。在我的提交可修改原登记,只发送最新版本。
保存和导出都不会自动公开,管理员审核并发布网站后大家才会看到。更正共享项目时请编辑原标记再导出,保留其 ID。
游戏内导航
安装 THUNION Atlas 1.6.3 后按 F9。目前支持 Main 和 Mirror,不支持旧周目及单人存档。子服选择器是手动的:重新连接或使用 /server main、/server mirror 后,请确认实际所在子服。
- 搜索名称或坐标,选择鞘翅或步行模式,再选择目的地。
- 跟随 HUD 和标记。已知 Y 时指向实际高度,未知 Y 时使用水平标记。普通导航在距离目标 3 格内自动停止,也可点击停止导航。
- 路线使用已记录的传送门、末地折跃门、基岩层通道和重生点,约每 10 秒更新。铁路不参与导航。
下界内部飞行
鞘翅模式下搜索地图堡垒编号,例如 #168,即可规划平滑三维飞行线。先跟随入口标记加入青色路线。末段尝试寻找能看见堡垒的位置;掩埋或狭窄入口仍可能需要步行。偏离内部飞行路线至少 64 格后会重新规划。
按 F6 前往最近的已登记基岩层通道,也可在 F9 搜索。接近通道 X/Z 后请自行降落、攀爬。新通道随网站数据更新。种子预测可能与服务器不同,前往航线入口的一段也只是普通坐标指引;请观察障碍和岩浆,导航不会自动飞行。
个人标记与 Mirror
F8 保存后立即成为私人目的地。在 F9 → 本地(Local)选择保存的 Xaero 世界;修改后点击刷新或输入 /atlasnav reload。读取的是 xaero/minimap 标记,不是世界地图图片。已确认的睡眠和重生点更新会自动记录,也可通过重生点更正。
切服按钮发送 /server mirror 或 /server main,到达后请确认新子服。Mirror 的 TP 需要创造模式、权限及确认;Main 不提供传送。
共享数据更新
保持 F9 → 数据 → 网站(自动)。选择子服后检查更新,游玩时约每 10 分钟再检查。管理员发布后可点立即更新或输入 /atlasnav update。下载失败时保留上次有效缓存。在同一游戏实例替换 JAR 不会删除个人文件及设置。
离线使用时选择本地文件,将下方下载保存为 config/thunion-atlas-navigation-network.json,再输入 /atlasnav reload。config/thunion-atlas-navigation.json 保存个人设置与重生点,config/thunion-atlas-updates.json 保存更新设置。F8、Xaero 与重生点都保留在本机,不会上传。
下载导航数据供本地使用 ↓
结构与数量
选择维度,展开结构并勾选类型。全部结构切换当前维度所有类型,半选表示只开启了一部分。首次访问时结构图层默认关闭。
点击图标或列表查看坐标和详情。密室显示刷怪笼及普通/不祥宝库;神殿显示湿海绵和海绵房;堡垒显示生成的镶金黑石,不含箱内物品。其他结构与沙漠水井提供位置。列表每页 200 项,地图显示全部匹配图标。
范围为 X/Z ±6000。数量描述种子最初生成情况,不代表服务器剩余方块。结构坐标是定位参考,不一定是入口。
跨维度搜索
顶部全局搜索查找所有维度的农场、标记、传送门、折跃门、车站及线路,包括隐藏项目。中英文名称都可搜索,也可搜索设施产物和建造者。
选择结果即可定位。例如搜索宝藏,可找到埋藏的宝藏图层开关。结果多时请补充关键词。
设施资料包含已记录的建造者、产物、状态、使用说明及来源。更正请联系管理员,Wiki 修改不会自动同步。点击社团标志查看日志,感叹号表示未读更新。
移动和缩放地图
- 拖动平移,滚轮缩放,点击图标查看详情。触屏支持拖动和双指缩放。
- 用 +/− 缩放,点击完整范围显示整个搜索区;网格切换与区块对齐的网格线。
- 悬停时显示名称,读数栏显示鼠标 X/Z 和采样生物群系。
- 顶部切换中文/English,折叠不需要的侧栏部分可留出空间。
地形与洞穴图层
地图背景提供服务器快照、生物群系图和 Xaero 下界顶层。顶层地图适合 Y127 以上建筑。图片是保存的快照,不追踪玩家;新建筑需要管理员刷新图片。
主世界中展开地下,开启图层并选择 Y,可分别显示深暗之域、繁茂洞穴、溶洞及硫磺洞穴。它们是生物群系区域,不是通行洞穴地图;关闭后恢复地表。
距离、筛选与到访
在结果上方展开你的位置,输入当前维度 X/Z,点击查找最近或选择距离排序。传送门和折跃门也有位置/排序控制。刷新后需重新输入位置。
标记显示控制自定义标记,并按到访状态或农场标记筛选结构。到访复选框记录是否去过,与显示开关不同。进度保存在本浏览器。
标记点与基岩层通道
标记点 → + 添加登记地点,双击地图会预填 X/Z。行内 ⋯ 菜单可编辑、删除及导出。名称、Y、颜色、形状及 Minecraft 图标均可修改;导入文件支持一次导入多个兼容 JSON。
登记下界基岩层通道
- 切换到下界,在通道 X/Z 添加或编辑标记点。
- 类型设为下界天窗,检查下方和顶层落脚高度,按实际情况选择双向通行、仅可上顶层或仅可下顶层。
- 保存并导出单个标记,将 JSON 交给服务器群内的地图管理员核实。
审核并发布网站后,模组自动获取通道。允许向上的通道可用于返回顶层;只添加普通标记不会建立交通连接。
铁路
主世界的铁路按钮显示/隐藏线路,点击线路查看站点。虚线表示规划中,开放表示可使用。
在铁路添加车站或线路后进入地图编辑,点击放置、拖动调整。选中线路点可同时编辑坐标、附着车站及转弯半径。附着点跟随车站移动,站点顺序自动按附着点排列。
编辑时用 Ctrl+Z/Ctrl+Y 撤销/重做拖动,保存提交,取消放弃。导出铁路 JSON 可备份;公开时将导出共享铁路文件交给管理员。
传送门与末地折跃门
下界传送门记录顶层门与实际主世界目的地。请填写实测坐标,8:1 比例不能确认配对。主世界显示已记录的返回端点,可按距离排序找回程。
! 表示主世界门无法返回顶层。已知时请勾选,该主世界端点将从回程列表隐藏。自动识别的候选门请先在游戏中核实。
末地末地折跃门记录门及目的地。落点不代表已确认回程门;目的地 X/Z 需一起填写,已知时补充 Y。
在所有缩放下显示可在远景保留图标,导出单个标记分享一条记录及连接。下界地图背景 → 显示传送门边界控制 ±750 虚线方框。
保存、导入与分享
到访与标记修改保存在本浏览器。保存与分享标记 → 导出标记创建备份,导入标记恢复。更换浏览器、设备或网址前请先备份。
登记单个项目用导出单个标记。导出共享地图标记生成管理员使用的完整 marks.js,铁路另有导出。下载不等于发布。
共享数据是管理员发布的默认版本,自己的修改或删除可能覆盖后续共享更新。没有账户同步,私人修改不会自动上传。
导入 Xaero 标记
下载 Xaero 标记导出工具 ↓- 解压 ZIP,打开
Export-Xaero-Waypoints.html,保持 xaero-waypoints.js 在旁边。 - 选择对应的
xaero/minimap 文件夹或标记 TXT,选择正确服务器/世界并检查维度。 - 勾选标记,点击下载所选 JSON。登记一个农场时只导出那个点。
- 通过标记点 → 导入文件加载,或将文件和使用说明交给管理员。
本地工具无需 Python,不修改存档。xaero/world-map 是地形而非标记;传送门配对和基岩层通道类型需另行补充。