Steam游戏开发每日学习 · 第 50 天：Godot 4 技能系统——用自定义 Resource + 冷却，搭一套数据驱动的技能框架

做动作/RPG 类游戏，绕不开一个问题：技能越加越多，代码越写越乱——if 技能 == "挥砍" ... elif 技能 == "冲刺" ... 堆成山，改一个数值要翻半天。今天用一个 Godot 官方就很推崇的思路解决它：把技能做成「数据」，把逻辑做成「系统」。

今日速览

• Resource 是数据容器，Node 是功能的执行者——Godot 官方文档原话：Resources 本身什么都不做，是节点在使用它们承载的数据。技能数值天然适合放进 Resource。
• 自定义 Resource 能在编辑器里可视化编辑，并保存成 .tres 文件，改数值不用碰代码，策划（或未来的你）能直接调。
• 冷却不要用固定帧数，用 _process(delta) 递减或 Timer 节点；Timer 默认受 Engine.time_scale 影响，暂停游戏时记得留意。
• 信号（signal）做解耦：技能系统只管「能不能放、放出去」，UI 只订阅信号，两边互不认识。
• 数据驱动后，你的工作流会变成：DeepSeek 帮你写数据类和管理器逻辑，你自己在编辑器里填表配技能。

一、先想清楚：技能系统的三个零件

一个清爽的技能系统只做三件事，各归各位：

1. 数据（Data）：这个技能叫什么、多少冷却、耗多少蓝、多少伤害。→ 放进自定义 Resource。
2. 逻辑（Logic）：判断能不能放、扣资源、启动冷却、发出信号。→ 放进一个 SkillManager。
3. 触发与表现（Trigger & VFX）：玩家按键、播放动画、弹出冷却圈。→ 由玩家脚本和 UI 订阅信号来完成。

分开之后，「加一个新技能」就只是「新建一个 .tres 数据文件」，而不是「再写一个 if 分支」。

二、自定义 Resource：把技能做成「数据表」

新建脚本 skill.gd，让它继承 Resource 并注册 class_name，所有字段用 @export 暴露——这样它就能在 Godot 的检查器里编辑、能存成 .tres：

# skill.gd —— 一份可脱离代码编辑的技能数据
class_name Skill
extends Resource

@export var id: StringName = &""          # 唯一标识，冷却字典的键
@export var display_name: String = "新技能"  # UI 显示名
@export var icon: Texture2D                # 图标
@export var cooldown: float = 1.0          # 冷却秒数
@export var resource_cost: float = 0.0     # 体力/法力消耗
@export var damage: float = 0.0            # 伤害（可换成伤害倍数）
@export var cast_time: float = 0.0         # 前摇时间

在编辑器里怎么用：资源面板右键 →「新建资源」→ 搜索 Skill → 保存为 res://skills/slash.tres。以后加技能，就是复制这个文件改数值。

官方文档特别提醒一点：Resource 全局只加载一份（load() 同一个路径返回同一份内存），所以它天然适合当「配置数据」；但如果你要在运行时修改某个技能的实例数据，记得先 duplicate()，别改了全局那份。

三、Timer 与冷却：让技能「有节奏」

冷却的本质是「从现在起，等 N 秒才能再放一次」。Godot 里有三种常见做法：

• Timer 节点：wait_time 设冷却、one_shot = true、autostart = false，调用 start() 启动，连 timeout 信号。适合「每个技能挂一个节点」的可视化做法。
• get_tree().create_timer(t)：一次性计时器，不用建节点。但它返回的对象在计时结束后才允许 await，不适合频繁查询进度。
• 手动 delta 累加：在 _process(delta) 里自己减。最灵活——能随时读出「还剩几秒」、能随游戏暂停一起停、能整体调节。

官方文档关键提示：Timer 受 Engine.time_scale 影响（时间缩放越大，计时越快结束），除非把 ignore_time_scale 设为 true。做「子弹时间」「慢动作」时，冷却想跟着变慢就用默认，想不受影响就打开它。

对技能系统，我更推荐第三种（delta 累加），因为它让「冷却进度」变成随时可查询的一个数字，UI 画冷却圈时直接读即可。

四、把三者串起来：一个最小可跑的 SkillManager

下面这个管理器把「数据」和「逻辑」接上，用字典统一管理所有技能的剩余冷却：

extends Node
class_name SkillManager

signal skill_used(skill: Skill)     # 释放成功
signal skill_ready(skill: Skill)    # 冷却结束

@export var stamina_max: float = 100.0
var stamina: float

# id -> { "remaining": float, "skill": Skill }
var _cooldowns: Dictionary = {}

func _ready() -> void:
    stamina = stamina_max

func can_use(skill: Skill) -> bool:
    if _cooldowns.has(skill.id):
        return false                       # 还在冷却
    return stamina >= skill.resource_cost  # 资源够不够

func use(skill: Skill) -> bool:
    if not can_use(skill):
        return false
    stamina -= skill.resource_cost
    _cooldowns[skill.id] = {"remaining": skill.cooldown, "skill": skill}
    skill_used.emit(skill)
    return true

func get_cooldown_left(skill: Skill) -> float:
    return _cooldowns.get(skill.id, {}).get("remaining", 0.0)

func _process(delta: float) -> void:
    for id in _cooldowns.keys():
        _cooldowns[id]["remaining"] -= delta
        if _cooldowns[id]["remaining"] <= 0.0:
            var finished: Skill = _cooldowns[id]["skill"]
            _cooldowns.erase(id)
            skill_ready.emit(finished)

玩家脚本里只要 SkillManager.use(slash_skill)，UI 只要连 skill_used 和 skill_ready 就能画冷却圈——三方完全解耦。加技能不改一行逻辑，这才是「能长大」的写法。

🎯 DeepSeek 提示词

① 让 DeepSeek 生成技能数据类（数据层的活）

你是一名 Godot 4 游戏开发工程师。请为我的 2D 俯视角动作游戏设计一个「技能」数据类。
【目标】定义一份可脱离代码、在 Godot 编辑器里可视化编辑的技能数据结构，让策划改数值不用碰逻辑。
【输出】完整的 GDScript：一个继承 Resource 的 class_name Skill，用 @export 暴露字段。
【要求】
- 字段至少包含：id(StringName)、display_name、icon(Texture2D)、cooldown(float)、resource_cost(float)、damage(float)、cast_time(float)
- 每个 @export 后写一行中文注释说明用途
- 用 class_name 注册，方便其它脚本 preload
- 不要写逻辑，只要数据
- 最后附一段说明：如何在编辑器里「新建资源 → 选 Skill」并保存为 .tres

适用场景：开工新系统时，先让 AI 把「数据结构」定死，后面所有逻辑都围着它写。

② 让 DeepSeek 写冷却与技能管理器（逻辑层的活）

你是一名 Godot 4 工程师，擅长写可维护的游戏系统。请实现一个 SkillManager 单例。
【任务】管理玩家技能释放：冷却计时、资源（体力）消耗、释放前置判断，并通过信号通知 UI。
【输入】技能数据类 Skill（继承 Resource，含 id/cooldown/resource_cost/damage）。
【输出】一个继承 Node 的 SkillManager 脚本，包含：
- 信号 skill_used(skill) 与 skill_ready(skill)
- can_use(skill)->bool、use(skill)->bool、get_cooldown_left(skill)->float
- 用字典记录每个技能的剩余冷却，在 _process(delta) 里统一递减
- 体力上限与当前体力
【约束】
- 冷却递减必须用 delta，不要用固定帧数
- 冷却结束时 emit skill_ready
- 用 GDScript 4.x 语法，带中文注释
- 不要用 Timer 节点，纯 delta 实现（我要能随时暂停）
- 最后用注释给出一段「如何在玩家脚本里调用」的示例

适用场景：把「怎么管冷却」交给 AI，你专心填技能表。

③ 让 DeepSeek 当代码审查员查冷却 Bug（Debug 的活）

你是 Godot 4 代码审查员。下面是我的技能冷却代码，玩家反馈「冷却有时不生效」。
【任务】找出 bug 并给出修复版。
【输入】
<把你的 SkillManager 代码粘贴到这里>
【输出】
1. 逐条列出疑似 bug，说明触发条件（如：暂停后冷却继续走 / 重复释放 / 字典键被覆盖）
2. 给出完整修复后的脚本
3. 说明为什么这样改是对的
【约束】不要重写整个架构，只改必要处；用 GDScript 4.x 语法。

适用场景：冷却、计时、状态类 bug 最容易「偶发」，与其自己瞎猜，不如把代码整段丢给 AI 对照排查。

学习心得

技能系统是第一个把「数据驱动」思想真正落地的地方。对「用 DeepSeek 做一款 Steam 游戏」这个目标来说，它的价值在于：把「写代码」和「配内容」拆开。以后我的工作循环会变成——DeepSeek 负责写 skill.gd 和 skill_manager.gd 这类「框架代码」（写一次就稳定），我自己在编辑器里批量配 .tres 技能表（随时可调）。这样加 50 个技能和加 5 个技能，代码量几乎不变。等游戏内容量大起来，这种架构就是省命的东西。

明日关注

• 把 SkillManager 接到玩家脚本，让键鼠和手柄都能触发同一个技能（复用 InputMap）。
• 给技能加「前摇 cast_time + 打断」机制，让释放节奏更像动作游戏。
• 让 DeepSeek 帮我把「技能表」从 .tres 升级成 CSV/JSON 批量导入，方便一次性配几十个技能。

本文由自动化学习流水线每日生成，坚持即学即记。