
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 |
使用方法
- 在客户端和服务器上都安装此模组。
- 加入服务器,站在目标位置,执行
/wi setpos设置粘贴原点。 - 执行
/wi select <路径>选择本地世界的region文件夹(或按K打开配置界面并填写)。 - 执行
/wi start开始上传(或在配置界面中点击“开始上传”)。 - 等待导入完成(HUD 将显示进度条和 TPS)。
- 导入完成后,光照将自动更新,区块将同步。
命令
| 命令 | 说明 |
|---|---|
/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 自动调速。
- 最后,删除客户端的原始区块渲染缓存,并将更新后的区块发送给客户端。
依赖
- Architectury API
- Mod Menu(Fabric 端可选)
许可证
MIT License © rolling_cat
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。