代码生物的模板制作

模板工艺插件指南

本插件的用途

模板工艺（Stencil Crafting）为 Hytale 添加了一套蓝图式的建筑工作流程，使用一种名为“模板书”（Stencil Book）的特殊工具。

其目标是让结构建造更快、更一致，具体方式如下：

• 允许玩家在自定义 UI 中浏览和筛选可合成的方块配方。
• 为可放置方块创建可重复使用的模板物品。
• 在放置时扣除配方材料费用，而不是消耗模板本身。
• 支持通过拾取（Pick）和环形菜单在世界中快速切换模板。

这对于需要进行重复方块放置、主题建筑或生产式建造的玩家尤为有用。

高级工作原理

插件在启动时会注册命令、交互和运行时系统。

核心流程

1. 玩家使用模板书。
2. 插件打开一个自定义的“模板工艺”UI 页面。
3. 玩家选择一个配方并获得与该配方绑定的模板物品。
4. 当使用模板放置方块时，插件会拦截放置行为。
5. 方块由引擎正常放置，同时从背包中扣除配方材料。
6. 同步系统会恢复模板堆叠，使模板保持可重复使用。

主要运行时系统

• 插件入口点：注册命令、交互和 ECS 系统。
• 配方与工作台注册表：扫描合成配方并对工作台标签进行分组。
• 模板放置系统：验证支付能力并消耗材料。
• 模板同步系统：在放置后恢复模板堆叠数量。
• 模板丢弃销毁系统：防止模板掉落生成世界物品。
• UI 页面：模板选择页面和环形模板菜单。

玩家指南

1. 获取模板书

制作或获得模板书物品。其物品配置绑定了以下功能：

• 使用（Use）交互：打开模板工艺 UI。
• 拾取（Pick）交互：从准星指向的世界方块中选择模板。

2. 打开模板工艺 UI

使用模板书打开页面。在页面中你可以：

• 切换工作台标签。
• 按物品名称和描述搜索。
• 按套装和材料组筛选。
• 切换与支付能力相关的视图。
• 选择一个配方以生成模板物品。

页面会存储每个玩家的偏好设置（所选标签、筛选器、搜索等），并在下次打开时恢复。

3. 使用模板放置

手持模板并正常放置方块。

• 在冒险模式中，插件会检查所需资源是否可用。
• 如果支付得起，则扣除配方材料并允许原生放置。
• 如果支付不起，放置会被取消并给出反馈。

由于放置仍然使用引擎原生行为，朝向和方块放置规则保持一致。

4. 建造时快速切换

手持模板时：

• 使用（Use）会打开一个环形模板菜单，用于按套装切换。
• 拾取（Pick）会对准星指向的方块进行射线检测，并切换到匹配的模板配方。

这有助于建造者采样已有结构并快速继续放置匹配的方块。

5. 移除模板

丢弃模板会将其销毁，而不是生成一个世界物品。这可以避免模板在世界中堆积，并保持工作流程以背包为中心。

工作台标签分组

默认的工作台标签分组由以下文件提供：

• src/main/resources/bench-tab-groups.json

在运行时，如果插件数据目录中缺少该文件，则会将其写入。它控制以下内容：

• 组显示名称
• 工作台 ID 分组
• 要跳过的前缀
• 标签图标

玩家 UI 偏好

每位玩家的偏好以 JSON 格式存储在：

• 插件数据目录下的 player_prefs

已知行为说明

• 资源消耗检查在冒险模式的模板放置流程中应用。
• 模板是带有元数据标签的物品，而不是独立的基底物品类型。
• 模板堆叠会被有意维持在配置的模板堆叠大小以供重复使用。