Sable Photomancy - Sable Schematic Tool 投影工具

记住一切的建筑蓝图！

保存你的建筑

预览你的建筑

寻找走失的建筑

在生存模式打印你的建筑

这个蓝图系统为高兼容性而构建，不仅仅是保存方块。它已经支持保存和恢复旋转轴承连接、绳索绞盘绳索链接、线控驱动连接、Create 装置以及超级胶水，因此复杂的 Sable/Create 建筑可以在复制、导出和放置过程中幸存，并保持其重要的运行时链接完好无损。

它还包含一个 SubLevel（子层级）管理工具，用于恢复在世界某处丢失的 SubLevel。你可以定位它们并将它们传送回来，包括连接的关节，这使得在测试和建造过程中拯救放错位置或孤立的物理结构变得容易得多。

介绍

Sable 子层级可以包含移动的方块、方块实体、实体以及通常存储对位置、UUID、约束或管理器拥有的数据的引用的模组状态。普通的复制粘贴工作流对于这些结构来说是不够的，因为复制的数据必须停止指向原始的世界对象。

Sable Schematic API 专注于解决这个重新映射问题：

• 方块和方块实体可以清理或重写保存的 NBT。
• 实体可以通过自定义逻辑进行转换、跳过或恢复。
• 多方块或外部管理的系统可以存储蓝图 sidecar 数据。
• 放置操作将源子层级 UUID 和蓝图局部的方块引用映射到新分配的已放置子层级。

该模组还包含一个简单的游戏内工具，这样就可以在无需每次输入坐标的情况下测试蓝图。

特性

• 保存和加载 Sable 子层级蓝图。
• 保存方块、方块实体、常规实体和 Create 装置实体。
• 仅限 OP（管理员）使用的保存和加载命令。
• 游戏内蓝图工具：
• 左键单击选择区域。
• 按 Tab 键打开 UI。
• 将本地蓝图文件保存在 Sable-Schematics/ 下。
• 右键单击上传并放置选定的本地蓝图。
• 开发者扩展点：
• 方块映射器。
• 实体映射器。
• 全局蓝图事件和 sidecar 数据。
• Create 兼容性：
• 装置实体锚点重新映射。
• 通过 sidecar 数据保存和恢复超级胶水。
• Simulated Project 兼容性：
• 旋转轴承和板块重新连接。
• 绳索绞盘/绳索连接器绳股恢复。
• 发射柱塞实体跳过规则。

需求

必需

• Minecraft 1.21.1
• NeoForge 21.1.226+
• Sable 1.1.3+
• LDLib2 2.2.6+

可选兼容目标

• Create 6.0.10+
• Simulated Project 1.1.3+

兼容映射器仅在加载了相应的可选模组时才会注册。

用法

命令

命令需要 OP 权限。

/sablebp save 
  
/sablebp load 

也可以使用完整的命令前缀：

/sable_schematic_api save 
  
/sable_schematic_api load 

基于命令的蓝图存储在世界目录中：

sable_blueprints/.nbt

蓝图工具

获取工具：

/give @p sable_schematic_api:blueprint_tool

基本控制：

• 拿着工具左键单击以选择起点和终点。
• Shift + 左键单击清除当前选区和选定的蓝图。
• 拿着工具时按 Tab 键打开蓝图 UI。
• 使用 Save 将选定区域导出到客户端的 Sable-Schematics/.nbt 文件夹。
• 在 UI 中选择一个本地蓝图，然后右键单击将其上传到服务器并放置在注视目标处。

基于工具的保存和加载也需要 OP 权限，并且玩家必须手持蓝图工具。

重要提示

• 这是一个实验性的 API 模组，还不是稳定的长期存储格式。
• 在测试蓝图保存/加载工作流之前，请备份重要的世界。
• 当前的蓝图主要复制 Sable 子层级内容。常规的根世界方块不属于同一引用映射。
• 旋转和镜像尚未作为稳定的放置功能公开。当前的兼容性行为主要假设为平移。
• 蓝图 NBT 格式目前为 v1 版本，不支持旧版地块有效载荷。
• 可选的兼容性行为取决于目标 Create 和 Simulated Project 版本的运行时 NBT 和 API 结构。
• 本模组旨在用于受控测试、兼容性开发和早期蓝图工作流实验。

许可证与再分发

除非另有说明，本项目的源代码根据 PolyForm Shield License 1.0.0 授权。

您可以在非竞争语境下使用、分发、包含在整合包中、在服务器上运行或依赖本模组。

请不要：

• 重命名并重新发布本项目作为竞争替代品。
• 冒充 Sable、Sable Schematic API 或官方兼容性构建。
• 删除作者身份、来源、许可证或归属信息。
• 误导玩家关于模组的来源或状态。

放置在 libs/ 下的第三方依赖项和发布 jar 包不受本项目源代码许可证的涵盖。请遵循它们各自的许可证和分发条款。

已知问题

• 尚不支持稳定的旋转和镜像。
• 根世界方块不属于子层级引用映射的一部分。
• API 仍为草案，可能会在未来的版本中更改。