World Importer

World Importer

一个可以帮助你将一个世界(MCA 文件)导入到另一个世界的模组。

工具

World Importer

一个用于将本地世界的 MCA 区域文件上传并粘贴到服务器的 Minecraft 模组。

客户端解析 MCA 文件,逐区块提取 NBT 数据并上传到服务器。服务器实时替换区块(方块、生物群系、方块实体),无需重启。导入完成后,自动重新计算光照并将区块同步给所有玩家。

支持 Fabric / Forge / NeoForge,兼容 Minecraft 1.19 ~ 1.20.6。

!警告: 此模组会直接用 MCA 文件覆盖服务器上的所有区块!请勿在已有建筑的区域内粘贴!强烈建议在粘贴前进行备份!

版本

目录 MC 版本 加载器 Architectury Java
versions/1.19-1.19.2/ 1.19 ~ 1.19.2 Fabric + Forge 6.x 17
versions/1.19.3/ 1.19.3 Fabric + Forge 7.x 17
versions/1.19.4/ 1.19.4 Fabric + Forge 8.x 17
versions/1.20-1.20.1/ 1.20 ~ 1.20.1 Fabric + Forge 9.x 17
versions/1.20.2-1.20.4/ 1.20.2 ~ 1.20.4 Fabric + Forge 11.x 17
versions/1.20.5-1.20.6/ 1.20.5 ~ 1.20.6 Fabric + NeoForge 12.x 21

使用方法

  1. 在客户端和服务器上都安装此模组。
  2. 加入服务器,站在目标位置,执行 /wi setpos 设置粘贴原点。
  3. 执行 /wi select <路径> 选择本地世界的 region 文件夹(或按 K 打开配置界面并填写)。
  4. 执行 /wi start 开始上传(或在配置界面中点击“开始上传”)。
  5. 等待导入完成(HUD 将显示进度条和 TPS)。
  6. 导入完成后,光照将自动更新,区块将同步。

命令

命令 说明
/wi setpos 将当前站立位置设为粘贴原点(源世界的中心点将对应此粘贴原点)。
/wi select <路径> 选择本地 region 文件夹的路径。
/wi start 开始上传所选的 region 文件夹。
/wi status 查看粘贴原点和导入进度。
/wi cancel 取消正在进行的导入。

所有命令均需要 OP 权限(等级 2)。

配置

按 K 键打开配置界面(在 Fabric 上也可通过 Mod Menu 打开)。你可以调整:

选项 默认值 说明
上传间隔 (tick) 5 每个区块上传之间的间隔;值越大,服务器负载越小。
分包大小 (KB) 30 单个网络包的最大体积。
光照更新速率 (chunk/tick) 5 每 tick 处理多少个区块的光照更新。
自动调速 开 根据服务器的 TPS 自动调整上传间隔。

启用自动调速时:

  • TPS ≥ 18:使用配置的上传间隔。
  • TPS ≤ 15:自动减速到最大间隔(40 tick)。
  • 介于两者之间的值使用线性插值。

配置文件保存在 .minecraft/config/world_importer.json。

HUD

导入过程中,屏幕顶部显示:

  • 导入中 — 绿色进度条 + 已完成 / 总数。
  • 光照更新 — 青色进度条。
  • 同步区块 — 紫色进度条。
  • 进度条右侧显示服务器 TPS(绿色/黄色/红色)。

构建

# 构建所有版本和所有加载器
./gradlew build

# 仅构建所有 Fabric 版本
./gradlew build -Ploader=fabric

# 仅构建所有 Forge/NeoForge 版本
./gradlew build -Ploader=forge

# 仅构建特定的 MC 版本
./gradlew build -Pver=1201

# 组合:仅构建 1.20.4 的 Fabric 版本
./gradlew build -Pver=4 -Ploader=fabric

# 运行客户端(默认为 1.20.1 Fabric)
./gradlew runClient

# 运行客户端:指定版本和加载器
./gradlew runClient -Pver=4 -Ploader=forge

# 运行服务器
./gradlew runServer -Pver=1 -Ploader=fabric

# 收集所有 jar 到 release/
./gradlew collectJars

# 清理所有内容
./gradlew cleanAll
别名 对应版本
1192 1.19 ~ 1.19.2
1193 1.19.3
1194 1.19.4
1201 1.20 ~ 1.20.1
1204 1.20.2 ~ 1.20.4
1206 1.20.5 ~ 1.20.6

支持的 -Ploader 值:fabric、forge

技术细节

  • 客户端解析 MCA 二进制格式(4096 字节头部 → 扇区偏移 → 逐区块提取压缩的 NBT)。
  • 服务器解压 NBT → 解析 sections 中的 PalettedContainer(方块状态 + 生物群系)→ 替换整个 section → 重新计算高度图 → 加载方块实体。
  • 光照更新使用区块 NBT 覆盖方法 → 清除原始光照数据并重新计算。
  • 流量控制:服务器在处理完前一个区块后才通知客户端发送下一个区块,并结合 TPS 自动调速。
  • 最后,删除客户端的原始区块渲染缓存,并将更新后的区块发送给客户端。

依赖

许可证

MIT License © rolling_cat