Sable Schematic Tool

记录一切的蓝图！

 

保存你的建筑

预览你的建筑

寻找你丢失的建筑

在生存模式中放置你的建筑

此蓝图系统专为高兼容性而构建，不仅仅是保存方块。它已支持保存和恢复转动轴承连接、绳索绞车绳索连接、有线传动连接、机械动力（Create）装置以及强力胶，使得复杂的 Sable/机械动力（Create）建筑能够在复制、导出和放置时保留其重要的运行时连接。

它还包含一个子关卡（SubLevel）管理工具，用于回收在世界中丢失的子关卡。你可以定位它们并将其传送回来，包括相连的关节，从而在测试和建造过程中更轻松地找回放置错误或孤立的物理结构。

介绍

Sable 子关卡可能包含移动方块、方块实体、实体和模组状态，这些通常会存储对位置、UUID、约束或管理器拥有数据的引用。对于这些结构，常规的复制粘贴流程是不够的，因为复制的数据必须停止指回原始世界对象。

Sable 蓝图 API 专注于解决这个重映射问题：

• 方块和方块实体可以清理或重写保存的 NBT 数据。
• 实体可以被转换、跳过或通过自定义逻辑恢复。
• 多方块或外部管理的系统可以存储蓝图附加数据。
• 放置时会根据源子关卡 UUID 和蓝图本地方块引用，映射到新分配放置的子关卡。

该模组还包含一个简单的游戏内工具，无需每次输入坐标即可测试蓝图。

功能特性

• 保存和加载 Sable 子关卡蓝图。
• 保存方块、方块实体、常规实体和机械动力（Create）装置实体。
• 仅限 OP 的保存和加载命令。
• 游戏内蓝图工具：
  • 左键点击选择区域。
  • 按 Tab 键打开界面。
  • 将本地蓝图文件保存在 Sable-Schematics/ 目录下。
  • 右键点击上传并放置选定的本地蓝图。
• 开发者扩展点：
  • 方块映射器。
  • 实体映射器。
  • 全局蓝图事件和附加数据。
• 机械动力（Create）兼容性：
  • 装置实体锚点重映射。
  • 通过附加数据保存和恢复强力胶。
• 模拟项目（Simulated Project）兼容性：
  • 转轴座和底板重新连接。
  • 绳索绞车/绳索连接器的绳索恢复。
  • 发射式弹射杆实体跳过规则。

需求

必需

• Minecraft 1.21.1
• NeoForge 21.1.228+
• Sable 2.0.0+
• LDLib2 2.2.17+

可选兼容目标

• 机械动力（Create） 6.0.10+
• 模拟项目（Simulated Project） 1.1.3+

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

使用方法

蓝图工具

获取工具：

/give @p sable_schematic_api:blueprint_tool

基本操作：

• 手持工具并左键点击选择起始点和结束点。
• Shift + 左键点击清除当前选择和已选蓝图。
• 手持工具时按 Tab 键打开蓝图界面。
• 使用“保存”将选定区域导出到客户端 Sable-Schematics/<名称>.nbt 文件夹中。
• 在界面中选择一个本地蓝图，然后右键点击将其上传到服务器并在注视目标处放置。

使用工具进行保存和加载也需要 OP 权限，并且玩家必须手持蓝图工具。

重要说明

• 这是一个实验性 API 模组，尚不是稳定的长期存储格式。
• 在测试蓝图保存/加载工作流程之前，请备份重要世界。
• 目前的蓝图主要复制 Sable 子关卡内容。常规根世界方块不属于相同的引用映射范围。
• 旋转和镜像尚未作为稳定的放置功能提供。目前的兼容性行为主要假设为平移。
• 蓝图 NBT 格式目前为 v1，不支持旧版 plot 数据。
• 可选兼容性行为取决于目标机械动力（Create）和模拟项目（Simulated Project）版本的运行时 NBT 和 API 结构。
• 此模组旨在用于受控测试、兼容性开发和早期蓝图工作流实验。

许可证与再分发

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

你可以在非竞争性环境中使用、分发、将其包含在整合包中、在服务器上运行或依赖此模组。

请不要：

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

位于 libs/ 下的第三方依赖项和发布 jar 不受本项目源代码许可证的约束。请遵循它们自己的许可证和分发条款。

已知问题

• 尚不支持稳定的旋转和镜像。
• 根世界方块不属于子关卡引用映射范围。
• API 仍是草案，未来版本可能会发生变化。