一、这是什么
把 .mcstructure / .nbt / .schematic 建筑文件,通过模拟网易版《我的世界》(基岩版协议)的客户端连接,把方块一块一块放进你的世界。
全程六步向导:卡密验证 → 账号登录 → 选择文件 → 导入配置 → 开始导入 → 导入完成。
二、安装
双击 ERS-Importer-Setup-1.0.0.exe,选择安装目录(默认装到 %LOCALAPPDATA%\Programs\ERS Importer),安装完会创建两个快捷方式:
- ERS Importer — 普通启动(多数机器用这个)
- ERS Importer(兼容模式) — 带
--no-sandbox和独立data目录的启动器
如果双击普通快捷方式窗口一闪而过 / 根本不出窗口,就用「兼容模式」那个。
原因:部分机器(装了 360 等带自我保护的安全软件、或运行在虚拟机 / 远程桌面里)会拦截 Electron 的渲染沙箱和默认配置目录,加两个参数即可绕开:
--no-sandbox 关闭渲染沙箱
--user-data-dir="<程序目录>\data" 把配置写进程序自己目录
卸载:开始菜单 → 设置 → 应用 → 找到 ERS Importer → 卸载,或直接运行安装目录里的 uninstall.cmd。
三、卡密
程序启动第一屏就是卡密验证,格式 ERS-XXXX-XXXX-XXXX。一张卡密只能绑定一台设备:首次验证时会把本机设备码写进卡密记录,换机器再验证会提示「该卡密已绑定其他设备」,需要管理员在管理端解绑。
卡密分三种:
- 时长卡 — 有效期内不限次数,例:
ERS-TIME-0012-0001-0001(365 天) - 次数卡 — 固定次数,无到期时间,例:
ERS-COUNT-0010-0001-0001(10 次) - 终身卡 — 永久,例:
ERS-LIFETIME-0001-0001-0001
设备码由本机 Windows MachineGuid 哈希生成,形如 748D-2C79-D856-F2E8,重装本软件不会变,重装系统会变。
卡密表存放在 GitHub 私有仓库(ers-license-repo / licenses.json),程序内置令牌读写,新增 / 禁用 / 解绑都在「ERS 卡密管理端」里操作,不用重新发版。
四、导入流程
- 账号登录:填网易版《我的世界》的邮箱 / 密码,只用于本地换取登录 Token。建议用小号。
- 选择文件:支持
.mcstructure(基岩版结构方块导出)、.nbt、.schematic。samples目录里带了一个demo_house.mcstructure(8×5×8,213 个方块)可以先试。 - 导入配置:
- 目标维度:主世界 / 下界 / 末地
- 起始坐标:结构左下角对齐的位置,Y 建议 64 以上,避开基岩层
- 连接方式:服务器(IP + 端口)/ 联机大厅 / 本地自定义联机
- 开始导入:实时进度、已放置 / 失败统计、当前区块、实时日志。中途可以暂停 / 继续 / 停止,断线会自动重连(最多 10 次)。
- 导入完成:成功率、耗时、结构详情,可继续执行:
!check完整性检查 /!repairNBT 修复 /!exit退出游戏。
五、注意事项
- 只支持网易版(基岩版协议),不支持 Java 版,也不支持国际版基岩。
- 需要目标服务器允许该账号进入、并且有放置方块的权限(建议 OP)。
- 方块是按 50 个一批、批间 50ms 发送的,大建筑请耐心等待,别中途关窗口。
- 导入前建议先在空的测试世界里跑一遍坐标,确认朝向和对齐。
六、常见问题
- Q: 双击快捷方式没反应 / 闪一下就没了?
- A: 用「ERS Importer(兼容模式)」那个快捷方式。
- Q: 卡密提示“卡密文件不存在”或“令牌无效”?
- A: 说明 GitHub 上的
licenses.json没读到,检查仓库是否还是私有且文件在根目录。 - Q: 提示“卡密已绑定其他设备”?
- A: 打开 ERS 卡密管理端 → 找到这张卡 → 点「解绑」,再让用户重新验证。
- Q: 日志在哪?
- A:
%APPDATA%\ers-importer\logs\main.log(兼容模式启动则在程序目录data\logs\main.log)。