原理图/NBT打印机

原理图打印机 — 使用方法

原理图打印机是一款适用于 Minecraft 1.20.1 的服务端 Forge 模组，它可以从磁盘加载原理图并将其放置到游戏世界中。

前置要求

• Minecraft 1.20.1
• 适用于 Minecraft 1.20.1 的 Forge 47 或更新版本
• Java 17
• 创造模式，除非在配置中禁用了 requireCreativeMode

命令权限也会被检查。即使需要创造模式，拥有权限等级 2 的管理员也可以使用这些命令。

安装

1. 安装匹配的 Forge 服务端或客户端。
2. 将原理图打印机的 .jar 文件放入 mods 文件夹中。
3. 启动 Minecraft 一次，以便模组创建其配置文件和 schematics 文件夹。
4. 将原理图文件复制到服务器工作目录下的 schematics 文件夹中。对于集成客户端，该目录为游戏实例目录。
5. 运行 /schematic list 以确认文件已被找到。

文件名可以带或不带扩展名输入。模组会搜索 .schematic、.nbt、.litematic 和 .schem 文件。

基本工作流程

1. 站在原理图应被放置的位置。
2. 运行 /schematic list 并记下文件名。
3. 首先预览它：

   /schematic print house.litematic simulate

1. 如果预览正确，则打印它：

   /schematic print house.litematic

默认情况下，原理图会放置在玩家所在位置，并朝向玩家面对的方向。如果存在已保存的位置，则使用该位置。

命令参考

所有命令均使用 /schematic 作为根命令。

查找和选择位置

命令	描述
/schematic list	列出 schematics 文件夹中受支持的原理图文件。
/schematic setlocation <x> <y> <z>	为您未来的打印保存一个默认位置。
/schematic getlocation	显示您保存的打印位置。
/schematic clearlocation	移除您保存的打印位置。
/schematic origin center	使用原理图的底部中心作为其原点。
/schematic origin corner	使用原理图的最小角作为其原点。

坐标可以是绝对坐标或相对的 Minecraft 坐标，例如 ~ ~ ~。

打印原理图

命令	描述
/schematic print <name>	使用配置的主速度连续打印。
/schematic print <name> simulate	预览放置而不改变方块。
/schematic print <name> slow	使用慢速配置文件打印。
/schematic print <name> pos <x> <y> <z>	在指定位置打印。
/schematic print <name> rotation <degrees>	绕 Y 轴旋转 0、90、180 或 270 度。
/schematic print <name> pos <x> <y> <z> rotation <degrees>	结合指定位置和旋转。
/schematic printlayer <name>	开始手动逐层打印。
/schematic printblock <name>	开始手动逐块打印。

对于手动模式，使用 /schematic nextlayer 或 /schematic nextblock 推进操作。

控制进行中的打印

命令	描述
/schematic pause	暂停当前打印。
/schematic resume	恢复已暂停的打印。
/schematic cancel	取消当前打印。
/schematic nextlayer	打印下一层。
/schematic nextblock	放置下一个方块。
/schematic speed <blocks>	更改活动打印的速度（以每 tick 方块数计）。
/schematic speed slow	选择慢速配置文件。
/schematic speed normal	选择正常速度配置文件。
/schematic speed fast	选择快速配置文件。
/schematic speed ultra	选择极速配置文件。
/schematic speed acceleration <true|false>	启用或禁用加速。
/schematic masterspeed <blocksPerTick>	更改新打印使用的主速度。
/schematic cleararea <true|false>	启用或禁用在当前打印前进行清空。

/schematic speed <blocks> 影响活动打印。速度配置使用 speedControl 中设置的值。更高的值每 tick 放置更多方块，可能会增加服务器负载。

清空区域

清空操作会在打印前移除玩家周围的方块。此时不能已有打印任务在运行，并且尺寸受模组配置和命令参数范围的限制。

命令	描述
/schematic cleararea box <width> <height> <length>	清空一个长方体区域。
/schematic cleararea cylinder <height> <radius>	清空一个实心圆柱体区域。
/schematic cleararea hollowcylinder <height> <radius>	清空一个空心圆柱体区域。
/schematic cleararea sphere <radius>	清空一个球体区域。
/schematic cleararea pyramid <basesize> <height>	清空一个金字塔区域。
/schematic cleararea cancel	取消进行中的清空操作。

配置

Forge 将通用配置存储在：

config/schematicprinter.toml

最常用的设置如下：

分区	设置项	默认值	用途
general	maxBlocksPerTick	100	/schematic speed 允许的最大速度。
general	defaultLayerMode	false	默认的逐层行为。
general	requireCreativeMode	true	将使用限制为创造模式玩家和受许可的管理员。
general	enableSimulationMode	true	启用模拟支持。
general	maxSchematicSizeBlocks	5000000	原理图的最大尺寸。
顶层	masterBlocksPerTick	5	正常打印的默认速度。
speedControl	speedProfileSlow	1	慢速配置文件速度。
speedControl	speedProfileNormal	20	正常配置文件速度。
speedControl	speedProfileFast	100	快速配置文件速度。
speedControl	speedProfileUltra	500	极速配置文件速度。
speedControl	enableAcceleration	false	以较慢速度开始，并加速至目标速度。
placement	clearAreaDefault	false	新打印任务默认是否清空区域。
general	restrictedBlocks	若干受保护方块	打印机不会放置的方块。

请在游戏停止时编辑该文件，或在可用时使用 Forge 配置界面。在服务器上更改速度或尺寸限制前，请先进行备份。

故障排除

• 未找到原理图： 确认文件位于实例/服务器的 schematics 文件夹中，并且具有受支持的扩展名之一。
• 文件未找到： 使用 /schematic list 显示的文件名；如果两个文件具有相同的主文件名，请包含扩展名。
• 命令被拒绝： 检查创造模式和操作员权限，然后查看 requireCreativeMode。
• 打印速度过慢或影响服务器： 降低活动速度，或减少 masterBlocksPerTick、速度配置文件以及 maxBlocksPerTick 的值。
• 打印无法开始： 每个玩家只能有一个活动的打印任务。在开始另一个任务前，请先取消或完成当前任务。
• 方块缺失： 检查 restrictedBlocks；默认情况下，基岩、传送门、命令方块、结构方块和拼图方块等受保护方块会被阻止打印。

在游戏中使用 /schematic help 可查看简洁的命令列表。