World Mirror
World Mirror 是一个客户端的 Fabric 模组,它会保存你的客户端所能看到的 Minecraft 世界部分,然后将它们转换为本地单人存档。它适用于多人服务器、Realms 以及单人世界;服务器无需安装任何内容。
你可以用它来归档建筑作品、保留某个区域的个人记录,或将获准使用的服务器世界离线。请仅在您有权这样做时下载世界。
开始之前的重要提示
- 加入世界后按 P 键。除非操作栏显示下载会话处于活动状态,否则 World Mirror 不会持续录制。
- 按 O 键会导出已经捕获的数据。它不会启动下载会话,也不会神奇地获取远处的区块。
- 镜像默认保存在
<.minecraft>/downloaded_worlds/中。Minecraft 不会在单人游戏菜单中显示该文件夹。如果您希望镜像自动出现在那里,请在 World Mirror 的设置中选择 Saves Folder。 - 客户端模组只能保存发送给您的客户端的信息。打开那些内容很重要的容器,并预期服务器独占数据可能会缺失。
快速入门
- 安装与您的 Minecraft 版本完全匹配的 World Mirror JAR 文件。
- 加入世界并按 P 键。检查操作栏是否显示 World Mirror 处于活动状态。
- 探索您想要保存的区域。打开那些您希望保留其库存的箱子、 barrel(桶)、熔炉和其他容器。
- 当您需要立即导出时按 O 键,然后等待完成消息。
- 再次按 P 键以停止下载会话。
- 如果您选择了 Saves Folder,则从单人游戏中打开镜像。否则,它将保留在
<.minecraft>/downloaded_worlds/<mirror-name>/下,直到您移动它或更改每个世界的保存位置。
设置中提供了停止时自动导出的功能,但默认情况下是禁用的,因此使用 在停止前按 O 是最安全简单的工作流程。
控制键
| 按键 | 操作 |
|---|---|
| P | 开始或停止下载会话 |
| O | 现在导出捕获的更改 |
| I | 打开 World Mirror 的状态和设置屏幕 |
| M | 打开内置的区块地图 |
| L | 清除内存中的捕获缓存 |
所有控制键都可以在 选项 → 控制 → World Mirror 下重新绑定。使用 L 清除缓存不会删除已写入磁盘的镜像文件。
World Mirror 保存的内容
- 来自主世界、下界、末界以及观察到的自定义维度中加载区块的地形和方块状态。
- 方块实体,如告示牌、旗帜、玩家头颅、信标和讲台。
- 您在录制期间打开的容器的内容,包括双层箱子。
- 尽最大努力捕捉客户端可见的生物、载具、画作、物品展示框、盔甲架、掉落物以及骑手/乘客组。移动和消失会在客户端可以安全观察的区域内进行协调,而不会从未加载的区块中删除最后已知实体。
- 随时间变化的更改,具有定期的后台导出功能,以及针对更繁忙会话的可选实验性自适应模式。
内置地图显示了记录的区块和未解决的冲突。拖动以平移,使用鼠标滚轮缩放,并将悬停在区块上以查看其坐标、年龄和来源。
无法完美保存的内容
World Mirror 不是服务器备份。未打开的库存、服务器数据包、结构元数据、隐藏的实体状态以及服务器从未发送的区块可能会缺失。未加载区块中的实体将保持其最后一个客户端已知状态,直到再次观察到该区块。未捕获的地形在生成的存档中故意留为虚空。
保存位置和冲突
按 I,打开 Settings(设置),然后选择 Global Settings(全局设置)。可选的 Mod Menu 提供了通往同一屏幕的另一个快捷方式。
枚举设置仅为选择列表:打开控件以查看所有翻译后的选项,然后选择一个项目。每个世界的保存位置和冲突策略使用相同的交互方式。
- Downloaded Folder(默认):保存到
<.minecraft>/downloaded_worlds/;有助于保持镜像分离,但不列在单人游戏中。 - Saves Folder:保存到
<.minecraft>/saves/;在单人游戏中立即可见。
当传入的区块与现有的本地区块相遇时,选择以下策略之一:
- Overwrite(默认):使用合格的传入服务器更新。
- Ignore:保留本地区块,仅写入尚不存在的区块。
- Manual:保留本地区块并存储传入版本以供审查。从区块地图解决它,或在“冲突”选项卡上使用 Overwrite All / Discard All(全部覆盖/全部丢弃)。
状态屏幕上的 Export Nearby Region(导出附近区域)会在单人游戏文件夹中创建一个单独的存档,基于您当前周围加载的区块。当您只需要一个区域而不是持续的镜像时,这非常有用。
安装
| Minecraft | 所需 Java |
|---|---|
| 1.21.11 | Java 21 或更高版本 |
| 26.1.2 | Java 25 或更高版本 |
| 26.2 | Java 25 或更高版本 |
| 26.3 | Java 25 或更高版本 |
安装步骤:
- Fabric Loader 0.19.5 或更高版本。
- 匹配的 Fabric API。
- 适用于您确切 Minecraft 版本的 World Mirror JAR。
Cloth Config 和 SQLite JDBC 已捆绑。Mod Menu 是可选的,不需要 LibGui。
可选的 Xaero's World Map 叠加层
World Mirror 可以在没有 Xaero 的情况下工作。要在 Xaero 的全屏地图上显示 World Mirror 的区块状态,请同时安装:
- 适用于您的 Minecraft 版本的 Xaero's World Map;以及
- 来自 Xaero World Map Bridge 的匹配 Minecraft 版本的 Fabric 文件。
对于每个 Minecraft 版本,请使用发行版 0.1.2 或更高版本的桥接器的匹配 Fabric 文件;桥接器 0.1.0 限制了更新的 Xaero 版本。对于 Minecraft 26.3,请使用 Xaero's World Map 1.46.x 和桥接器的 26.3 文件。
报告性能问题
打开全局设置,启用性能诊断日志记录,重现问题至少 30 秒,然后将 latest.log 和 config/worldmirror.json 附加到报告中。之后请禁用该选项。下载启动记录包含完整的全球配置和当前世界配置(在 [perf] 行中),随后是定期性能遥测数据;这些行在正常游戏过程中是不需要的。
World Mirror
World Mirror is a client-side Fabric mod that saves the parts of a Minecraft world your client can see, then turns them into a local singleplayer save. It works on multiplayer servers, Realms, and singleplayer worlds; the server does not need to install anything.
Use it to archive a build, keep a personal record of an area, or take a permitted server world offline. Only download worlds where you have permission to do so.
Important before you start
- Press P after joining the world. World Mirror does not continuously record unless the action bar says the download session is active.
- Pressing O exports data that has already been captured. It does not start a download session or magically fetch distant chunks.
- Mirrors go to
<.minecraft>/downloaded_worlds/by default. Minecraft does not show that folder in the Singleplayer menu. Choose Saves Folder in World Mirror's settings if you want the mirror to appear there automatically. - A client-side mod can only save information sent to your client. Open containers whose contents matter, and expect server-only data to be missing.
Quick start
- Install the World Mirror JAR that exactly matches your Minecraft version.
- Join the world and press P. Check that the action bar says World Mirror is active.
- Explore the area you want to save. Open chests, barrels, furnaces, and other containers whose inventories you want to keep.
- Press O when you want an immediate export, then wait for the completion message.
- Press P again to stop the download session.
- Open the mirror from Singleplayer if you selected Saves Folder. Otherwise it remains
under
<.minecraft>/downloaded_worlds/<mirror-name>/until you move it or change the per-world save location.
Automatic export on stop is available in settings but is disabled by default, so using O before stopping is the safest simple workflow.
Controls
| Key | Action |
|---|---|
| P | Start or stop the download session |
| O | Export captured changes now |
| I | Open World Mirror's status and settings screen |
| M | Open the built-in chunk map |
| L | Clear the in-memory capture cache |
All controls can be rebound under Options → Controls → World Mirror. Clearing the cache with L does not delete mirror files already written to disk.
What World Mirror saves
- Terrain and block states from loaded chunks in the Overworld, Nether, End, and observed custom dimensions.
- Block entities such as signs, banners, player heads, beacons, and lecterns.
- Contents of containers you open while recording, including double chests.
- Best-effort snapshots of client-visible mobs, vehicles, paintings, item frames, armour stands, dropped items, and rider/passenger groups. Moves and despawns are reconciled in areas the client can safely observe without deleting last-known entities from unloaded chunks.
- Changes over time, with periodic background exports and an optional experimental adaptive mode for busier sessions.
The built-in map shows recorded chunks and unresolved conflicts. Drag to pan, use the mouse wheel to zoom, and hover a chunk for its coordinates, age, and source.
What it cannot save perfectly
World Mirror is not a server backup. Unopened inventories, server datapacks, structure metadata, hidden entity state, and chunks the server never sends may be absent. Entities in unloaded chunks keep their last client-known state until the chunk is observed again. Uncaptured terrain is intentionally void in the generated save.
Save locations and conflicts
Press I, open Settings, then choose Global Settings. Optional Mod Menu provides another shortcut to the same screen.
Enum settings are selection-only lists: open the control to see every translated choice, then select one item. Per-world Save Location and Conflict Strategy use the same interaction.
- Downloaded Folder (default): saves to
<.minecraft>/downloaded_worlds/; useful for keeping mirrors separate, but not listed in Singleplayer. - Saves Folder: saves to
<.minecraft>/saves/; immediately visible in Singleplayer.
When an incoming chunk meets an existing local chunk, choose one of these strategies:
- Overwrite (default): use the eligible incoming server update.
- Ignore: keep the local chunk and write only chunks that are not already present.
- Manual: keep the local chunk and store the incoming version for review. Resolve it from the chunk map or use Overwrite All / Discard All on the Conflicts tab.
Export Nearby Region on the status screen creates a separate save in the Singleplayer folder from the chunks currently loaded around you. It is useful when you only need one area instead of a continuing mirror.
Installation
| Minecraft | Required Java |
|---|---|
| 1.21.11 | Java 21 or newer |
| 26.1.2 | Java 25 or newer |
| 26.2 | Java 25 or newer |
| 26.3 | Java 25 or newer |
Install:
- Fabric Loader 0.19.5 or newer.
- The matching Fabric API.
- The World Mirror JAR for your exact Minecraft version.
Cloth Config and SQLite JDBC are bundled. Mod Menu is optional, and LibGui is not required.
Optional Xaero's World Map overlay
World Mirror works without Xaero. To display World Mirror's chunk status on Xaero's fullscreen map, install both:
- Xaero's World Map for your Minecraft version; and
- the matching Minecraft-version Fabric file from Xaero World Map Bridge.
Use the bridge's matching Fabric file from release 0.1.2 or newer for every Minecraft version; bridge 0.1.0 restricts newer Xaero releases. For Minecraft 26.3, use Xaero's World Map 1.46.x and the bridge's 26.3 file.
Reporting a performance problem
Open Global Settings, enable Performance Diagnostic Logging, reproduce the problem for
at least 30 seconds, then attach latest.log and config/worldmirror.json to the report.
Disable the option afterward. Download startup records the complete global and current-world
configuration in [perf] lines, followed by the periodic performance telemetry; these lines
are not needed during normal play.
下载 World Mirror
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 World Mirror
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 World Mirror
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 World Mirror
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 World Mirror
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 World Mirror
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 World Mirror
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 World Mirror
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 World Mirror
下载 World Mirror
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[0.6.0-alpha.2] — 2026-11-14
已修复
- 在分配种子时,清除与混合原版生物群系或旧版原版融合数据相关的已验证虚空占位符,以便受影响的区块能够生成地形。
- 重新计算新生成地形边界上的光照,即使实验性地形成融合功能关闭时也生效。
- 在使用转换备份打开先前转换的镜像世界时,修复幸存的虚空占位符。沿已验证的旧边界追踪完全原版的生物群系占位符,并识别流入的流体和边界圆石沉积物。
- 在本土生成过程中尊重实验性融合开关。仅当保存的来源信息确认其未被修改时,才重新生成为扭曲的地形。
- 更改镜像世界的种子时,保留自定义文件和不相关的资源包设置。
- 在世界加载期间显示修复进度,并在编辑过的区域文件中保留未触碰的区块有效载荷和时间戳。
[0.6.0-alpha.1] — 2026-11-14
此 Fabric 预发布版本支持 Minecraft 1.21.11、26.1.2、26.2 和 26.3。
新增
- 在由
saves(存档)和downloaded_worlds(已下载的世界)构建的图中追踪上游世界和多个镜像。为每个源选择固定的默认镜像或自动选择。 - 为新副本分配新的世界 ID,同时保留其上游连接。移动存档时保留 ID,并保留对不可用世界的连接。
- 从主菜单或游戏内设置打开世界关系图。编辑上游链接、默认镜像、端点别名以及 Xaero 稳定 ID 绑定。
- 在可搜索列表中选择镜像、上游世界和远程源,列表中显示原生图标和存档详情。通过“世界位置”下拉菜单移动镜像、断开其上游连接,或在确认后删除存档。
- 离线设置、更改或移除镜像的种子值。预览地形差异、虚空清理,以及使用进度条和取消功能可选地移除未更改的生成区块。
- 启用实验性的主世界混合功能,并在捕获的地形边界沿线重新生成符合条件的生成区块。
- 通过确认源存档(包括重命名的存档),从“世界”工具栏导入旧的本地路由。保留每个已验证目标的 SQLite 命名空间,并在旧目标缺失时保留创建偏好。
更改
- 将 v0.5.4 的镜像元数据和路由迁移到 schema 2。备份原始元数据,保留 SQLite 命名空间和现有的区块历史记录,并在图保存后归档旧的路由文件。保留已验证的默认目标,除非策略变更,否则保持基于地址的身份识别的服务端路由。
- 将下载、重试、冲突处理、地图和通知的范围限定为目标镜像。在请求时记录附近导出的谱系信息。
- 使用选定的端点或稳定 ID 策略解析逻辑世界。当可用证据模糊时,等待明确的选择。对于升级后的镜像中的 Replay 导入,请使用 World Mirror Toolkit 0.1.2 或更高版本。
- 在世界首次链接使用时或保存其路由偏好时为其分配一个稳定 ID。浏览和独立的附近导出不会跟踪普通存档。
- 在显示“活动”之前后台准备下载。从状态屏幕审查所需的镜像升级。
- 保持未更改的种子地形不在区块地图和叠加层上显示。在验证其来源后,捕获和 Replay 导入可以替换它。
修复
- 切换回“自动”时清除固定默认值。如果最后一个自动目标不可用,则选择另一个已验证的直接镜像。
- 当稳定 ID 发现过期且策略允许时,提供源选择。在收到新证据之前暂停不确定的远程转换,恢复已验证的同源会话,并防止更改后的源捕获过期的客户端区块。
- 在使用受影响的存档之前,恢复中断的镜像移动和迁移日志。阻止写入模糊的图分支,并在迁移和恢复路径中拒绝符号链接和 Windows 目录联接。
- 当 Windows 短暂持有日志文件打开时,重试完成事务的退役操作,从而防止在下一次存档检查期间出现错误的恢复警告。
- 在重新生成或删除种子区块时,保留已编辑的种子地形以及辅助实体和 POI(兴趣点)数据。
- 使排队中的导出和确认绑定到原始世界。旧的导出完成不会影响较新捕获会话的状态。
- 在检查当前镜像后,从 Minecraft 现有的加载步骤继续。保留 Minecraft 的数据包安全模式。
- 在不实际生成存档的情况下修复空镜像预留的上游,并拒绝向仅具有复制预留的可玩世界写入数据。
- 避免与新默认快捷键 U(用于下载)、V(用于导出)和 J(用于清除缓存)发生原版按键冲突。保留现有保存的绑定。
[0.5.4] — 2026-11-13
Changed
- 在实时同步和工具包导入之间共享源优先级决策与 MCA 读取验证。实时同步遵循回放源的已配置优先级,并且仅索引通过验证的地形。
- 当不存在相关规则时,将
replay_import注册为优先级 10。现有的源规则和存档格式继续保留。 - 在内置地图和 Xaero 覆盖层中使用相同的缩放桶(zoom-bucket)选择和绘制路径。在平移过程中保持桶大小稳定,并在每个缩放级别下正常工作。
- 在不两次编码字符串的情况下验证 NBT 字符串长度。缓冲导出时的读取和写入操作,同时保留精确的内容检查和原生区域格式。
- 通过将每个区块更新数据包排队一次、在开始更多捕获前检查剩余刻预算,并避免冗余的地形和光照副本,减少客户端线程的捕获工作量。
- 为地图渲染以及准备导出时的实体、地形和捆绑阶段添加可选的性能诊断功能。
- 当可见数据和颜色保持不变时,复用地图几何结构。
Fixed
- 在地形、实体和冲突写入期间,将遗留的零字节 MCA 占位符视为空。
- 在持久化导出或索引修复后刷新匹配的已保存区块地图及其计数,包括在前一个刷新仍在进行中的情况。
- [fabric-1.21.11] 修复状态屏幕在一帧内请求两次背景模糊时导致的崩溃。
- 在手动导出期间保持状态屏幕打开。在后台检查目标,并允许单人游戏在屏幕打开时继续处理导出。
[0.5.3] — 2026-11-11
更改
- 通过单一计划协调周期性、自适应、资源压力及重试导出。在退出时完成已接受的写入并排空保留的快照,无需等待另一个客户端刻或中断原子文件写入。
- 在 Minecraft 目标间共享同一源树,采用编译时版本分支以及独立的通用层、客户端层和 Fabric 入口点层。从单一版本定义生成项目、制品收集及发布矩阵;按 Minecraft 目标隔离开发运行目录。
- 在收集前验证可分发元数据、字节码、入口点、Mixin 及捆绑依赖。在 Loom 重映射之前解析源分支,以确保发布的 1.21.11 源码保持完全重映射且可用。
修复
- 将生成的 IDEA 运行配置绑定到导入的 Gradle 模块名称,使得所有支持的目标在项目重新加载后仍保持有效的启动模块。
- 以减少工作量及可恢复暂停替代资源压力捕获停止。保留下载切换开关、待处理任务及区块卸载前的捕获状态;在稳定恢复后自动恢复并重新检查已加载区块。在状态和通知中区分资源缩减、暂停/恢复与文件故障。
- 考虑共享及飞行中的保留数据,避免重复计算修订版本。在压力下优先导出排空,同时推迟可选的捕获工作。
- 将光照更新等待限制在受影响的区块内,以便其他地形仍可保存。
- 恢复 Minecraft 26.3 中内置地图的左键拖拽功能,并确保在所有目标上地图拖拽均绑定到主按钮。
[0.5.2] — 2026-10-23
Added
- 为失败和部分保存的导出添加内置区块地图警告,在小型单元格中使用紫色冲突提示和简化标记。在悬停详情中显示所有导出状态、地形/实体结果及元数据状态;Xaero 和世界中叠加层保持无角落符号。
- 通过合并且限速的聊天和通知提示,呈现自动/手动导出及文件操作失败信息,并在状态屏幕中显示当前健康度。
Changed
- 减少按区块进行的实体快照复制与索引协调,即使在长时间捕获会话后也能保持小规模观测的高效性。
- 在区块地图与世界叠加层之间共享空间查询和桶摘要;发布更改的导出状态区域,并为大型捕获历史绑定粗粒度视图刷新工作。
- 用有界原生编解码器和只读 MCA 访问替换内嵌 NBT 栈;以有界批次流式传输实体重写并应用冲突。
- 使路由预览不占用磁盘写入锁,并跳过未更改的文件夹声明。
Fixed
- 尽管存在当前元数据,仍能检测到过时的镜像生成器并提供备份修复;保留有效的自定义配置,拒绝未知的生成器编辑。
- 在源更改和并发导出期间,保留已捕获的地形、光照、实体和物品栏。恢复中断的捕获扫描,并在队列压力下保留已确认的方块移除。
- 仅重试未完成的镜像数据,包括断开连接后。在允许较新的地形越过仅实体的失败的同时,保留每个源的地形/实体顺序。
- 在 Windows 和 Linux 上,使用 Minecraft 的会话锁保护打开的世界存档。保留损坏的区域标头和健康的邻近耐久性声明。在不覆盖未知编辑或在清理失败后撤销已验证提交的前提下,恢复中断的文件集;当迁移或元数据持久化失败时,保留旧版时间戳。
- 保留损坏的配置和可选保存数据,当优先级规则不可读时推迟覆盖,并保持独立的地形保存运行。
- 在移动文件前验证镜像身份和重新定位计划;一致地恢复路由并拒绝过时的映射更新。
- 解决不会导致锁顺序死锁的冲突,支持外部区块文件,并保留失败或较新的传入冲突以供审查。
- 修正导出期间回退的实体移动、脱离的乘客和观测结果。在拒绝格式错误的新实体观测和过大 NBT 字符串的同时,保留缺少类型 ID 的旧版 UUID 树。
- 保留容器名称和物品栏,避免在世界或方块实体类型间应用过时数据,或将方块实体恢复到已确认的空块中。
- 平移后刷新地图聚合,并为极端视口限制工作量。
- 处理不安全的文件夹名称和自定义维度路径;保留邻近导出的实体、Unicode 名称、生成维度及独立的谱系。
- 在完成已接受的导出后,在退出前执行最后一次排队任务,且不中断原子写入或让空闲的导出工作者保持存活。
Known Issues
- 启用光影时,世界中叠加层无法正常工作。
[0.5.1] — 2026-10-18
新增
- 为游戏内覆盖层添加了“会话”和“地图”颜色模式。“会话”模式保留其黄/绿/蓝覆盖色板;“地图”模式共享内置地图与 Xaero 地图的捕获时间、来源和实时队列颜色,包括粗略聚合。
更改
- 将默认固定游戏内覆盖层高度提升至 96。已配置的高度设置将被保留。
修复
- 在“会话”模式下,无论回放导入的时间戳如何,均将其包含在历史蓝色覆盖中,并保留会话之间的历史缓存覆盖数据。
已知问题
- 启用光影时,游戏内覆盖层无法正常工作。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
原版世界生成优化模组
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧