用途:面向 Godot 的 data-oriented 设计技能,用于构建物品/属性等可复用、可在 Inspector 编辑、可序列化的数据结构。
主要能力:自定义 Resource 类(如 ItemData、CharacterStats)、数据库模式(Resource 数组)、嵌套资源、带信号的资源、运行时动态加载与目录批量加载;区分 Resource(可保存/Inspector 支持)与 RefCounted(临时运行时数据)。提供脚本 data_factory_resource.gd(类型校验与批量实例化)、resource_pool.gd(Resource 对象池)与 resource_validator.gd(校验缺失导出与配置问题);实现数据系统前必须先读 data_factory_resource.gd。
用法要点:资源属性用 @export 以在 Inspector 编辑;数组必须类型化,如 @export var items: Array[ItemData] = [],避免运行时错误;运行时使用前先 .duplicate(),否则会改写磁盘上的 .tres 文件;Resource 无生命周期(_ready/_process),运行时逻辑应 extends RefCounted 或挂到 Node;不要序列化 Node 引用,改存 NodePath 或 UID;ResourceSaver.save() 必须检查错误码。加载可用 load()、preload() 或 DirAccess 遍历目录收集 .tres。
适用场景:物品定义、角色属性/成长、技能数据、配置文件、对话数据库、敌人/NPC 模板,以及无需持久化的临时计算。
限制:资料未提供安装命令、版本要求、授权与收费信息;具体平台支持与性能数据暂未提供。