prismarine schematic

海晶石示意图

阅读、编写和操作我的世界原理图。

支持的格式：

• 海绵（读/写）
• MCEdit（只读）

用法

 const fs = require ( 'fs' ) . promises
const { Schematic } = require ( 'prismarine-schematic' )

async function main ( ) {
  // Read a schematic (sponge or mcedit format)
  const schematic = await Schematic . read ( await fs . readFile ( 'test/schematics/smallhouse1.schem' ) )

  // Write a schematic (sponge format)
  await fs . writeFile ( 'test.schem' , await schematic . write ( ) )
}

main ( ) 

应用程序编程接口

示意图

一个示意性实例。

• version : 该原理图的 mc 版本
• size : vec3，块的大小
• offset : vec3，从 0 开始的偏移量
• Palette ：该原理图调色板的 stateId 列表
• 块：调色板中每个块按 y、z、x 顺序排列的索引

原理图.start()

返回该原理图的起始坐标。

原理图.end()

返回该原理图的结束坐标。

原理图.forEach(cb)

在原理图中的每个块上调用回调。使用 args (block, pos)调用回调。

示意图.map(cb)

返回对原理图中每个块调用回调的结果数组。使用 args (block, pos)调用回调。

Schematic.makeWithCommands（偏移量，平台='pc'）

• platform是一个可选参数。它可以是pc （默认）或pe ，以说明 Java 和 Pocket Edition 之间不同的命令风格。

返回要运行以在普通服务器中制作原理图的命令数组。偏移量是一个 vec3 实例，由 .offset 应用于原理图中的每个块。

• 在 1.13+ 中，命令中存在以数组形式存在的方块状态

• 在 1.11+ 中，块状态作为元数据作为命令中的数字

• 在<1.11中，没有方块状态，只有命令中的方块

Schematic.getBlockStateId(pos)

获取pos处区块的 stateId。 pos必须位于start()和end()之间。

原理图.getBlock(pos)

获取pos处的区块。 pos必须位于start()和end()之间。

Schematic.setBlock(pos, 块)

将pos处的块设置为 Block 实例的块（请参阅 prismarine-block）。如果未给出 block 或 nullish setBlock 会删除pos处的块。

Schematic.copy（世界，开始，结束，偏移量，版本）

静态、异步。从world （prismarine-world） start和end （vec3）之间创建一个原理图实例， offset将是原理图的偏移量， version必须与world的版本匹配。

Schematic.paste(世界, at)

异步。将原理图粘贴到world (prismarine-world) 的 (vec3) at 。

Schematic.read（缓冲区，版本=null）

静态、异步。返回一个从缓冲区读取的原理图实例。如果未设置版本，加载程序会尝试从文件中自动检测版本。

原理图.write()

异步。返回编码该原理图的缓冲区

Schematic.toJSON（空格？）

返回原理图string表示形式。 space表示JSON.stringify()的空格选项。

原理图.fromJSON()

通过解析字符串化原理图返回一个新的Schematic实例。出错时返回null 。