SchemPrint

SchemPrint

高速打印

SchemPrint — 即时打印

作者:mornfrost 平台:NeoForge 1.21.1 / Java 21

将 Litematica 投影文件(.litematic)、Create 蓝图(.nbt)以及原版结构 NBT 直接打印到当前存档或服务器中。 写入过程中,逐方块更新被抑制;光照与客户端同步按区块刷新,从而实现近乎“即时打印”。

核心特性

  • 三种格式统一解析: litematic / Create 蓝图 / 结构 NBT —— 所有格式差异都封装在解析层中。
  • 流式放置: 不预先读取方块列表;常驻内存与建筑体积无关,支持 3000 万到 30 亿个方块。
  • 分页投影: 对于大文件,BlockStates 映射到磁盘;30 亿个方块仅需约 3 GB 磁盘,而非 120 GB 内存。
  • 预览: 仅发送玩家附近的区域,使用真实方块模型渲染,并带有边界框与帧预算 —— 不会造成客户端卡顿。
  • UI: F9 或 /schemprint ui —— 选择投影、旋转、XYZ 偏移、预览、放置、撤销。
  • 锚点选择: 视线选取 / 坐标选取;不再强制以玩家中心为锚点。
  • 撤销: 写入过程中将旧方块记录到磁盘日志;/schemprint undo 回滚整个区域(默认上限:1 亿个方块)。
  • 在未加载区块中打印: 按区块临时票据加上磁盘持久化保证 —— 无观察者、未加载、甚至尚未生成的区域也能打印。
  • 版本兼容: 直接解析 → 映射表 → 显眼的占位方块;绝不会静默留下空洞。
  • 模组方块: setPlacedBy / 邻居更新仅应用于非 minecraft 方块;原版建筑零开销。
  • 回退模式: 当目标服务器未安装此模组时,方块可以作为仅客户端更新发送给指定玩家。

常用命令

  • /schemprint load <file> [format] —— 加载投影(将其放入 config/schemprint/schematics/)
  • /schemprint anchor —— 视线锚点选择;anchor <x> <y> <z> / anchor clear
  • /schemprint preview <name> [angle] —— 预览
  • /schemprint place <name> [angle] —— 在锚点处放置;place <name> <x> <y> <z> 指定坐标
  • /schemprint status —— 进度与剩余时间
  • /schemprint inspect —— 放置后自检:将世界与投影进行对比
  • /schemprint undo [confirm|discard] —— 回滚最近一次打印
  • /schemprint cancel —— 取消任务(先保存到磁盘)

预期规模

默认每 tick 写入 200,000 个方块,单 tick 上限为 8 毫秒: 3000 万方块约需 10 秒,3 亿方块约需 1.5 分钟,30 亿方块约需 15 分钟(不含世界生成)。