教程一 · 第 6 章：Resource 数据驱动、动态实例化、存档#

前 5 章解决了”场景里有什么、怎么动、怎么通信”。本章解决两个工程问题：数据怎么组织（10 种武器、50 种敌人难道写 50 个类？）和进度怎么持久化（关掉游戏再打开还在）。

6.1 Resource：Godot 被低估的最强概念#

Resource（资源）= 可序列化为文件、可在 Inspector 里编辑、可复用的数据对象。 纹理是 Resource、音频是 Resource、PackedScene（场景文件）也是 Resource。而你可以自定义 Resource 类型——这是 Godot 数据驱动开发的核心。

自定义一个武器数据#

scripts/resources/WeaponData.cs：

1
using Godot;
2

3
[GlobalClass]   // 关键：让 Godot 认识这个类型，Inspector 里才能创建和选择
4
public partial class WeaponData : Resource
5
{
6
    [Export] public string WeaponName = "New Weapon";
7
    [Export] public int Damage = 10;
8
[Export] public float FireInterval = 0.3f;
9
    [Export] public float BulletSpeed = 800f;
10
    [Export] public Texture2D Icon = null!;
11
    [Export] public PackedScene BulletScene = null!;
12
}

在文件系统面板右键 → 新建资源 → 选 WeaponData，存成 weapons/pistol.tres；再建 shotgun.tres、rifle.tres。双击每个 .tres，在检查器里填不同数值。没有新类，没有 if-else，只有数据资产。

.tres 是文本格式资源（Git 可 diff，开发期用）；.res 是二进制（发布后体积小）。场景文件同理：.tscn 是文本。

使用它#

1
public partial class Weapon : Node2D
2
{
3
    [Export] public WeaponData Data = null!;  // 拖入 pistol.tres
4
    private float _cooldown;
5

6
    public override void _Process(double delta)
7
    {
8
        _cooldown -= (float)delta;
9
        if (Input.IsActionPressed("fire") && _cooldown <= 0f)
10
        {
11
            Fire();
12
            _cooldown = Data.FireInterval;
13
        }
14
    }
15

16
    private void Fire()
17
    {
18
        var bullet = Data.BulletScene.Instantiate<Bullet>();
19
        bullet.GlobalPosition = GlobalPosition;
20
        bullet.Setup(Vector2.Right, Data.BulletSpeed, Data.Damage);
21
        GetTree().CurrentScene.AddChild(bullet); // 加进当前场景，而不是武器自己
22
    }
23
}

换武器 = 换一个拖入的 .tres 文件。做 50 种敌人、20 个关卡配置，全是这个套路。逻辑写一遍，数据做成资产——这是新手脚本堆砌和正经项目之间最大的思维差距。

Resource 的共享语义（也是坑）#

Resource 默认按引用共享：100 个敌人引用同一个 enemy_stats.tres，运行时改一份，全部变。两种利用方式：

想让所有敌人同时狂暴？改共享 Resource，天然”全局数据”
想要实例独立数据？代码里 stats.Duplicate() 复制一份，或每个敌人单独挂 .tres

6.2 动态实例化：子弹、敌人、特效#

前面 Pong 的球是预先摆在场景里的。真实游戏里子弹要在开火瞬间生成：

完整模板#

1
public partial class Bullet : Area2D
2
{
3
    private Vector2 _velocity;
4
    private int _damage;
5

6
    // 用普通方法做"构造参数"：Godot 节点不能用 new 传参（要先 Instantiate 再加树）
7
    public void Setup(Vector2 direction, float speed, int damage)
8
    {
9
        _velocity = direction.Normalized() * speed;
10
        _damage = damage;
11
    }
12

13
    public override void _PhysicsProcess(double delta)
14
    {
15
        GlobalPosition += _velocity * (float)delta;
16
    }
17

18
    public void OnTimerTimeout() => QueueFree(); // 配个 Timer 子节点，5 秒自毁
19
}

生成方记住三步顺序：

1
var bullet = _bulletScene.Instantiate<Bullet>(); // ① 实例化（还不在树里）
2
bullet.Setup(dir, speed, damage);               // ② 注入数据（此时 _Ready 还没跑）
3
GetTree().CurrentScene.AddChild(bullet);        // ③ 加进场景树（_Ready 此刻才执行）

⚠️ 常见错误：先 AddChild 再 Setup，_Ready 读到的还是默认值。顺序是实例化 → 注入 → 入树。

对象池（性能进阶）#

Instantiate 有开销，弹幕游戏每秒几百发子弹时用对象池：预先实例化一批，用时从池里取（移出池节点/重设位置），不用时 RemoveChild 回池而不是 QueueFree。新手阶段先不用做，等 Instantiate 出现在性能分析器顶部再优化（第 8 章讲调试器）。

6.3 节点查找在动态生成下的正确姿势#

子弹生成在 CurrentScene 下，敌人怎么找玩家？回顾第 5 章决策树：用组。

1
AddToGroup("player");
2

3
// Enemy 或子弹需要时（_Ready 缓存，不要每帧找）
4
private Player _player = null!;
5
public override void _Ready()
6
{
7
    await ToSignal(GetTree(), SceneTree.SignalName.ProcessFrame);
8
    _player = GetTree().GetFirstNodeInGroup("player") as Player;
9
}

6.4 存档：三种层次#

层次 1：Godot Resource 存二进制/文本（最简单）#

把存档数据定义成 Resource：

1
[GlobalClass]
2
public partial class SaveData : Resource
3
{
4
    [Export] public int Level = 1;
5
    [Export] public int Coins = 0;
6
    [Export] public float MaxHp = 100f;
7
    [Export] public string PlayerName = "";
8
    [Export] public Godot.Collections.Array<bool> LevelsCleared = new();
9
}

存：

1
var data = new SaveData { Level = 3, Coins = 42, MaxHp = 80f };
2
string path = "user://save.tres";   // user:// 是 Godot 托管的用户目录，跨平台
3
ResourceSaver.Save(data, path);

读：

1
if (ResourceLoader.Exists(path))
2
{
3
    var data = ResourceLoader.Load<SaveData>(path);
4
    GD.Print(data.Coins);
5
}

优点：三行代码、类型安全、Inspector 可看
缺点：改类结构后旧存档可能失配；玩家可以随手改 .tres 文本作弊；不适合存世界中每个物件的状态
user:// 的物理位置：Windows %APPDATA%/Godot/app_userdata/项目名，Linux ~/.local/share/godot/app_userdata/项目名，macOS 在 ~/Library/Application Support

层次 2：JSON（可读、可迁移、可控）#

1
public class SaveData
2
{
3
    public int Level { get; set; }
4
    public int Coins { get; set; }
5
    public Vector2 Position { get; set; } // System.Text.Json 不能直接序列化 Godot Vector2
6
}

⚠️ Godot 结构体（Vector2、Color）和 System.Text.Json 不来电，用普通 DTO（float PosX/PosY）转换，或用 JsonUtility：

1
var godotObj = new Godot.Collections.Dictionary
2
{
3
    ["level"] = 3,
4
    ["pos"] = new Vector2(10, 20) // Godot 自己的 JSON 类认识这些类型
5
};
6
string json = Json.Stringify(godotObj);
7

8
var parsed = Json.ParseString(json).AsGodotDictionary();

实操推荐：用 Godot 的 Json.Stringify + Dictionary 写，或用 NuGet 装 Newtonsoft.Json（配置一个转换器处理 Vector2）。中小项目层次 1 足够。

层次 3：“收集—存储—恢复”完整模式#

真正难的不是写文件，是存什么、怎么恢复。给需要持久化的节点统一接口：

1
public interface ISaveable
2
{
3
    string SaveId { get; }
4
    Godot.Collections.Dictionary Save();
5
    void Load(Godot.Collections.Dictionary data);
6
}

敌人、箱子、门实现它，SaveManager 遍历组 "saveable" 收集字典、写 JSON；读档时按 SaveId 匹配恢复。玩家位置、已捡物品（存”已移除的节点 id 集合”比存”场上所有物品”聪明）、开关状态都能覆盖。这是正式项目的做法，理解思路即可，需要时回来实现。

存档安全#

本地存档没有真正的防作弊，只能提高门槛：发布版存 .res 二进制 + 加 HMAC 校验（密钥在代码里，破解成本高一点）
Steam 云存档等以后上平台再管
多存档槽：save_01.tres、save_02.tres……

6.5 配置数据放哪：一张选型表#

数据	载体
武器/敌人/物品数值	自定义 Resource（.tres）
游戏平衡常量（重力、暴击率）	`[Export]` 在场景上，或单独 `balance.cfg` Resource
本地化文本	Godot 翻译系统（CSV/PO）
按键绑定	`InputMap` 运行时修改 + 存 user://
玩家进度/设置	SaveData Resource 或 JSON
大量结构化数值（对话树、任务表）	JSON/CSV 导入，或插件（如对话插件）
环境变量/密钥	不要进 Git，配置文件 + .gitignore

6.6 一个贯穿例子：给平台游戏加”武器系统”作业#

目标：把本章知识用一遍。

建 WeaponData（名字、伤害、射速、弹速）+ 手枪/霰弹两个 .tres
Weapon.cs 挂在 Player 子节点，[Export] WeaponData，按 J 开火
bullet.tscn：Area2D + CollisionShape2D + 小圆 Polygon2D，飞行 + 碰墙 QueueFree + 命中敌人调 TakeDamage
敌人 enemy.tscn：CharacterBody2D 左右巡逻（用 Mathf.Sin(Time.GetTicksMsec()) 或两个 Marker2D 之间 MoveToward），HP 用 [Export]，归零发 Died 信号并 QueueFree
金币数和当前关卡写进 SaveData，按 F5 快速存、F9 快速读

6.7 本章金句#

逻辑写一遍，数据做成资产
实例化三步走：实例化 → 注入 → 入树
销毁节点用 QueueFree()，不是置 null
user:// 是唯一该写存档的地方
存档设计先想”恢复时怎么对上号”，再想存什么

第 7 章回到玩家可见的东西：UI 系统与游戏流程（主菜单、暂停、血条、设置界面、场景过渡）。

《Godot C# 零基础》系列导航

⬅️ 上一篇：Godot C# 零基础教程 05：信号与节点通信 📑 返回系列总目录（第 01 篇） ➡️ 下一篇：Godot C# 零基础教程 07：UI 与游戏流程