← 返回首页

ERS Importer 完整使用教程

版本 1.0.0 · 网易版《我的世界》基岩版协议建筑导入器

一、这是什么

把 .mcstructure / .nbt / .schematic 建筑文件,通过模拟网易版《我的世界》(基岩版协议)的客户端连接,把方块一块一块放进你的世界。

全程六步向导:卡密验证 → 账号登录 → 选择文件 → 导入配置 → 开始导入 → 导入完成。

二、安装

双击 ERS-Importer-Setup-1.0.0.exe,选择安装目录(默认装到 %LOCALAPPDATA%\Programs\ERS Importer),安装完会创建两个快捷方式:

如果双击普通快捷方式窗口一闪而过 / 根本不出窗口,就用「兼容模式」那个。

原因:部分机器(装了 360 等带自我保护的安全软件、或运行在虚拟机 / 远程桌面里)会拦截 Electron 的渲染沙箱和默认配置目录,加两个参数即可绕开:

--no-sandbox                     关闭渲染沙箱
--user-data-dir="<程序目录>\data"  把配置写进程序自己目录

卸载:开始菜单 → 设置 → 应用 → 找到 ERS Importer → 卸载,或直接运行安装目录里的 uninstall.cmd。

三、卡密

程序启动第一屏就是卡密验证,格式 ERS-XXXX-XXXX-XXXX。一张卡密只能绑定一台设备:首次验证时会把本机设备码写进卡密记录,换机器再验证会提示「该卡密已绑定其他设备」,需要管理员在管理端解绑。

卡密分三种:

设备码由本机 Windows MachineGuid 哈希生成,形如 748D-2C79-D856-F2E8,重装本软件不会变,重装系统会变。

卡密表存放在 GitHub 私有仓库(ers-license-repo / licenses.json),程序内置令牌读写,新增 / 禁用 / 解绑都在「ERS 卡密管理端」里操作,不用重新发版。

四、导入流程

  1. 账号登录:填网易版《我的世界》的邮箱 / 密码,只用于本地换取登录 Token。建议用小号。
  2. 选择文件:支持 .mcstructure(基岩版结构方块导出)、.nbt、.schematic。samples 目录里带了一个 demo_house.mcstructure(8×5×8,213 个方块)可以先试。
  3. 导入配置:
    • 目标维度:主世界 / 下界 / 末地
    • 起始坐标:结构左下角对齐的位置,Y 建议 64 以上,避开基岩层
    • 连接方式:服务器(IP + 端口)/ 联机大厅 / 本地自定义联机
  4. 开始导入:实时进度、已放置 / 失败统计、当前区块、实时日志。中途可以暂停 / 继续 / 停止,断线会自动重连(最多 10 次)。
  5. 导入完成:成功率、耗时、结构详情,可继续执行:!check 完整性检查 / !repair NBT 修复 / !exit 退出游戏。

五、注意事项

六、常见问题

Q: 双击快捷方式没反应 / 闪一下就没了?
A: 用「ERS Importer(兼容模式)」那个快捷方式。
Q: 卡密提示“卡密文件不存在”或“令牌无效”?
A: 说明 GitHub 上的 licenses.json 没读到,检查仓库是否还是私有且文件在根目录。
Q: 提示“卡密已绑定其他设备”?
A: 打开 ERS 卡密管理端 → 找到这张卡 → 点「解绑」,再让用户重新验证。
Q: 日志在哪?
A: %APPDATA%\ers-importer\logs\main.log(兼容模式启动则在程序目录 data\logs\main.log)。