世界绑定者

世界绑定者

WorldBinder是一个强大的Fabric模组，用于保存、编辑和放置结构、实体以及可重复使用的世界场景。

管理

世界绑定者预览查看大图

WorldBinder

WorldBinder 是一个客户端 Fabric 模组，用于捕获已加载的 Minecraft 世界数据，并将其导出为可游玩的原版世界存档。

它专为玩家、服务器管理员、建造者、开发者以及希望本地保存其 Minecraft 客户端已接收到的世界数据的保护型用户而设计。WorldBinder 专注于世界捕获、导出、恢复、检查和负责任的数据保存工具。

WorldBinder 不 提供作弊、战斗优势、移动优势、透视功能或隐藏的服务器绕过功能。

WorldBinder 1.3.0

1.3.0 版本为 Minecraft 26.2 优化了 WorldBinder 的日常界面：

  • 可视化 HUD 小部件编辑器，支持拖拽定位和直接调整大小控件
  • 每个小部件的可见性、强调色、背景色和不透明度设置
  • 紧凑的自定义 Toast 通知，文字清晰可读
  • 更简洁的可选聊天反馈
  • 大幅现代化的设置界面
  • 改进的下拉菜单外观和可用性
  • 更精致、更一致的菜单
  • 从 Minecraft 主菜单直接访问 WorldBinder 图标
  • 从 Minecraft 暂停菜单直接访问 WorldBinder 图标

现有的 F9 控制中心和 F10 实时地图功能仍然可用。

WorldBinder 的功能

WorldBinder 会捕获客户端上已加载的世界数据，并将其转换为本地 Minecraft 世界存档。

这在以下情况下非常有用：

  • 备份你自己的建筑
  • 保存你创建或管理的世界地图
  • 存档你有权限保存的服务端项目
  • 在本地检查捕获到的世界数据
  • 跨不同 Minecraft 版本测试导出功能
  • 在崩溃或断开连接后恢复已捕获的区块

WorldBinder 只能保存客户端实际接收到的数据。它无法重建服务端独有的逻辑、未加载的区块或从未发送到你的游戏的隐藏数据。

主要功能

  • 客户端世界捕获
  • 优先使用 HotCache 的区块捕获
  • 用于大规模捕获的持久化区块方块缓存
  • 原版世界导出
  • 选择目标输出版本
  • 导出可用的方块、方块实体和实体
  • 导出可用的地图、统计数据和进度
  • 将服务端资源包导出为 resources.zip
  • 恢复和自动保存工具
  • 可配置的性能预设
  • 导出验证报告
  • F9 控制中心
  • F10 实时区块地图
  • Ctrl+C 复制区块中心坐标
  • 队列仪表盘/分析器
  • 用于状态、雷达和通知叠加层的可视化 HUD 小部件编辑器
  • 紧凑的 WorldBinder Toast 通知，文字清晰可读
  • 现代化的设置、下拉菜单和菜单
  • 主菜单和暂停菜单中的 WorldBinder 图标按钮
  • 专用的 WorldBinder 按键绑定类别
  • 德语和英语语言支持
  • 适应不同窗口大小和 GUI 缩放比例的自适应界面

直接菜单访问

WorldBinder 可以直接从 Minecraft 的界面中使用。

在加入世界前，选择主菜单中的 WorldBinder 图标按钮以打开它，或在世界开启时使用暂停菜单中的 WorldBinder 图标按钮。默认的 F9 按键绑定也会继续打开控制中心。

F9 控制中心

WorldBinder 包含一个中心控制中心，默认可通过 F9 打开。

控制中心可以快速访问：

  • 捕获状态
  • 存档进度
  • 最近活动
  • 警告
  • 捕获操作
  • 地图工具
  • 恢复工具
  • 设置
  • 分析器/队列仪表盘
  • 文档和关于页面

它被设计为控制 WorldBinder 的主要中心枢纽，无需记住每个单独的菜单。

HUD 小部件编辑器、现代化设置和自定义 Toast

WorldBinder 的设置、下拉菜单和共享菜单组件使用统一的界面，旨在跨不同屏幕尺寸和 GUI 缩放比例保持配置的可读性。标签和控件在其卡片内正确对齐。

紧凑的可视化 HUD 小部件编辑器允许你点击、拖拽、按比例调整大小、重新着色或禁用导出状态、区块雷达和通知叠加层。其工具面板可以折叠以获得无遮挡的画布，可视化颜色选择器也接受精确的 HEX/ARGB 输入。位置相对于屏幕存储，因此布局在不同窗口大小下保持稳定。

重要的反馈可以通过 WorldBinder 的自定义 Toast 通知系统显示。在 1.3.0 中，完整的通知会按比例缩放，较长的消息会跨额外行换行，并且可以在小部件编辑器中自定义精确颜色。

F10 实时区块地图

F10 地图实时显示已捕获的世界数据。

它可以显示：

  • 已捕获的区块
  • 部分捕获的区块
  • 队列中的区块
  • 包含实体的区块
  • 包含方块实体的区块
  • 警告和错误状态
  • 覆盖信息
  • 检查器工具提示
  • 手动区块导航
  • 跟随模式和过滤器

你还可以选择一个区块，然后使用 Ctrl+C 复制其中心坐标，从而更容易传送到或检查已捕获的位置。

持久化区块缓存

WorldBinder 为大规模捕获包含一个持久化区块缓存。

在较大的世界下载过程中，捕获到的区块方块数据可以写入位于以下位置的临时缓存：

saves/WorldBinder/.cache/

这有助于在长时间会话中保护捕获到的方块数据，并使大型导出更可靠。

成功导出后，临时缓存数据会自动清理。如果 Minecraft 崩溃或导出失败，缓存可以保留以供恢复使用。

捕获和导出工作流程

一个典型的 WorldBinder 工作流程如下：

  1. 加入一个单人世界或多人服务器。
  2. 使用 F9 或 WorldBinder 菜单图标打开 WorldBinder 控制中心。
  3. 配置捕获模式、目标版本和性能预设。
  4. 开始捕获。
  5. 在你想要保存的区域移动。
  6. 使用 F10 地图检查捕获覆盖范围。
  7. 将捕获的数据导出为本地世界存档。
  8. 在 Minecraft 中打开导出的世界，或将其导入到你控制的服务端设置中。

WorldBinder 的设计目的是保持捕获和导出操作可见且易于理解，而不是在没有反馈的情况下静默地在后台写入文件。

目标输出版本

WorldBinder 可以为不同的目标 Minecraft 版本导出捕获的世界。

这意味着你可以使用更新的客户端版本进行捕获，并在支持的情况下选择较旧的输出版本。WorldBinder 会针对文件夹结构、游戏规则、实体、兴趣点（POI）数据、存档数据和世界元数据，应用版本感知的导出处理。

某些版本降级可能仍不完美，特别是当捕获的世界包含所选目标版本中不存在的方块、实体、物品数据、NBT 结构或资源包内容时。

导出结构和验证

WorldBinder 的导出被设计为可作为普通 Minecraft 世界存档读取。

导出可能包含：

  • level.dat
  • level.dat_old
  • session.lock
  • icon.png
  • region/
  • entities/
  • poi/
  • data/
  • resources.zip
  • 一个导出 README.md
  • 可用的验证报告

对于现代 Minecraft 版本，WorldBinder 还会在必要时写入额外的存档数据和维度相关结构，以提高与原版和服务端导入工作流程的兼容性。

内置的验证系统有助于在用户认为导出已完成之前，检测缺失或可疑的导出文件。

资源包导出

如果服务端发送了资源包，并且客户端可以访问它，WorldBinder 可以将资源包导出为：

resources.zip

WorldBinder 会尝试检测当前活动的服务端资源包，包括服务端在游戏过程中切换资源包或重用已下载资源包的情况。

资源包导出取决于客户端实际接收到的内容以及服务端允许客户端下载的内容。

恢复和自动保存

WorldBinder 包含恢复和自动保存功能，以减少在较长捕获会话中的数据丢失。

这在以下情况下非常有用：

  • 游戏崩溃
  • 服务端断开你的连接
  • Minecraft 被意外关闭
  • 长时间的捕获会话被中断
  • 你希望在测试期间有更安全的捕获行为

恢复功能可以在可能的情况下重用匹配的区块缓存数据，这使得对于大型捕获，崩溃恢复更安全。

恢复不能替代仔细的导出，但它有助于在不稳定的会话期间保护捕获到的数据。

性能预设

WorldBinder 包含可配置的性能预设，以平衡捕获速度和游戏性能。

可用的预设可能包括：

  • 安全
  • 平衡
  • 快速
  • 极限
  • 自定义

用户可以根据其系统、服务端条件以及他们希望 WorldBinder 处理捕获数据的激进程度来选择预设。

高级用户可以在设置中微调捕获限制、队列行为、自动保存时机以及 HUD/地图行为。

自适应界面

WorldBinder 使用一个自适应界面系统，旨在使菜单在不同 Minecraft 窗口大小和 GUI 缩放比例下保持可用。

这会影响主要界面，例如：

  • F9 控制中心
  • F10 地图
  • 捕获界面
  • 设置
  • 安全和恢复选项
  • 性能配置
  • 分析器/队列仪表盘
  • 进度界面
  • 导出和完成界面

非常小的窗口可能仍然看起来更像素化，因为 Minecraft 的像素风格 UI 被缩小了，但布局旨在保持一致和可用。

按键绑定

WorldBinder 包含可在 Minecraft 控制界面中，在专用的 WorldBinder 类别下配置的按键绑定。

默认绑定：

  • F6：开始/停止世界下载
  • F7：设置位置 1
  • F8：设置位置 2
  • F9：打开 WorldBinder 控制中心
  • F10：打开 WorldBinder 地图

所有按键绑定都可以在 Minecraft 的正常控制菜单中更改。

加载器支持

WorldBinder 1.3.0 为 Minecraft 26.2 上的 Fabric 构建。

使用 Fabric Loader 0.19.3 或更新版本，以及 Fabric API 0.155.2+26.2 或更新版本。Mod Menu 20.0.1 或更新版本是可选的。

此版本不支持 Forge、NeoForge 和 Quilt。

重要限制

WorldBinder 只能导出 Minecraft 客户端实际接收到的数据。

这意味着，如果服务端从未向客户端发送某些数据，导出的世界可能不完整，例如：

  • 未加载的区块
  • 远处的实体
  • 物品栏
  • 某些方块实体数据
  • 服务端独有的逻辑
  • 隐藏的维度
  • 由插件管理的数据
  • 自定义服务端系统
  • 无法访问的资源包内容

根据服务端设置、自定义内容、资源包、实体、维度、游戏规则和 Minecraft 版本差异，WorldBinder 的导出也可能与原服务端世界有所不同。

WorldBinder 不能替代正确的服务端备份。

责任使用

仅在你拥有、管理、自行创建，或已获得明确许可进行存档或导出内容的世界、服务器、地图、建筑和资源包上使用 WorldBinder。

你需对导出数据的使用方式负责。

WorldBinder 不授予复制、重新分发、发布或重复使用他人、服务器或项目所拥有内容的权利。

请遵守服务器规则、创作者权利和社区指南。

反馈和 Bug 报告

WorldBinder 正在积极改进中。

请在 GitHub 或 Discord 上报告 Bug、想法和反馈：

有用的报告应包括：

  • Minecraft 版本
  • WorldBinder 版本
  • 选定的目标输出版本
  • Fabric Loader 版本
  • Fabric API 版本
  • 如果是 UI 相关问题，请提供窗口模式和 GUI 缩放比例
  • 相关的 Toast 或菜单设置
  • 捕获了什么内容
  • 出了什么问题
  • 截图
  • 日志
  • 如果可能，请提供导出的测试世界

清晰的报告使得重现和修复问题变得容易得多。

项目状态

WorldBinder 正在积极开发中。1.3.0 版本是面向 Minecraft 26.2 的当前稳定版本。

目标是基于真实反馈，继续改进世界导出准确性、目标版本兼容性、实体处理、恢复行为、性能、UI 打磨和整体可用性。