跳到主要内容

玩家单位创作

GCS · Authoring

定义玩家控制的角色：初始 HP、每回合能量、初始卡组，以及 UI 显示的能量标签。

适合在 Workbench Player 模式中搭建可玩角色的开发者。

玩家单位定义遭遇战中玩家控制的角色：初始 HP、每回合补充的能量、初始卡组、表现 prefab，以及战斗 UI 中能量资源的标签。在 Workbench > Player 中创作玩家单位；Demo 的 12 个玩家单位覆盖四个职业，例如战士线的 Squire，70 HP、3 点能量。

Workbench Player 模式：单位列表、属性与卡组 Inspector 和英雄预览

创作顺序​

  1. 填写 Name、Description 和 Tags。
  2. 设置 Icon 和 Template。
  3. 设置 Base HP 和 Base Energy。
  4. 选择一个 Starting Deck。
  5. 配置 Energy 区域的显示名称、描述和图标。
  6. 启动一个使用该单位的遭遇战，进战斗测试。

初始卡组是最常见的缺失环节。玩家单位指向错误卡组时，即使卡牌定义正确，新卡也不会出现。

基础字段​

字段作用
Name游戏内显示名称。非空时 Workbench 会同步重命名资产；为空时校验报错。
Description显示在英雄信息上的风味或定位文本。
Tags用于过滤和目标选择的自由标签。

Tags 适合表达职业身份、进度标记或项目过滤。在图、规则或你自己的代码读取它之前，它对战斗没有任何影响。Squire 自带 Warrior 和 Novice 两个标签，用途正是如此。

视觉字段​

Icon 是 UI 和列表行使用的头像 sprite。Template 是战斗中生成、代表该单位的 prefab；预览列会实时渲染它，支持旋转、平移和缩放。机制测试阶段可以先使用 Demo template，不要让最终美术阻塞卡牌、卡组和遭遇战验证。

属性字段​

字段作用
Base HP初始同时也是最大 HP；治疗不能把当前 HP 推过它。编辑器会保持它不低于 1。
Base Energy每个玩家回合开始时补满到的能量值。编辑器会保持它不低于 0。
信息

遭遇战的战斗规则中有一个 Starting Energy 覆盖项。保持默认值 0 时，使用单位自己的 Base Energy；填正数则在整场战斗中取代它。状态还可以通过 Energy Per Turn Hook 在最终基数之上继续调整补充量。Play Mode 中能量不符合预期时，先检查玩家单位和遭遇战规则，再决定修改位置。

初始卡组​

Deck 区域指定使用该单位的遭遇战中的玩家起始卡组。卡组名称下方有实时摘要；Squire 的 Iron Resolve 显示为 17 cards · Avg cost 0.71，可在进入 Play Mode 前发现选错或空卡组。

Workbench Player 模式中选中 Squire：Base HP 70、Base Energy 3，以及带实时摘要的初始卡组 Iron Resolve

操作作用
Choose Deck / Change Deck同一个选择按钮；标签取决于当前是否已指定卡组。双击卡组行也会打开同一个选择器。
Open in Deck Mode跳到 Deck 模式编辑选中的卡组。
Clear deck移除卡组引用。通常只在重建内容时使用。

玩家 inspector 的 Deck 区域：初始卡组 Iron Resolve，实时摘要 17 cards · Avg cost 0.71，以及打开、定位、清除三个控件

能量显示​

Energy 区域控制资源在 UI 中的呈现：

字段作用
Name该单位能量资源的标签。默认 Energy；法师可以叫 Mana。
Description解释该资源的 tooltip 文本。
Icon显示在能量计数旁的 sprite。

只有当主题化名称有助于玩家理解职业时，才建议修改能量名称。Demo 的十二个单位全部保留默认 Energy。不需要职业化表达时，保持默认值即可。

遭遇战可达性​

玩家单位只有被遭遇战引用才会进入战斗。可达链路是：启用的玩家单位数据库持有该单位，单位持有初始卡组，某个遭遇战选中该单位，最后由场景 bootstrap 或 GCSApi.StartBattle(encounter) 启动战斗。预览列的 Used By 面板会列出使用该单位的所有遭遇战。战斗以错误卡组或错误职业开局时，先检查遭遇战选中的玩家单位，再修改卡牌或卡组数据。

校验​

Player 模式报告：

  • Name 为空是错误。
  • 缺少 Starting Deck 是警告。
  • 缺少 Template 是警告。

两个警告的影响不同。缺少 template 时仍可用占位表现测试机制；缺少初始卡组时，玩家无法抽到测试卡牌。

常见错误​

症状可能原因
新卡不出现玩家单位用的是另一个初始卡组。
能量不是预期值遭遇战设置了 Starting Energy 覆盖，或 Base Energy 改在了另一份单位副本上。
玩家没有头像或模型Icon 或 Template 缺失。
战斗以另一个职业开局遭遇战指向了其他玩家单位。
Tags 没有效果在图、规则或自定义系统读取之前，Tags 只是标签。
本页总览