Foundation 基础能力¶
Standard Foundation 收纳纯算法、纯数据结构、轻量格式化和通用诊断对象。这里的类型不参与 GFArchitecture 生命周期,不持有场景树状态,也不解释项目玩法规则。
Foundation 适合被 standard、GF 内置扩展、外部扩展和项目代码共同复用。它的价值是稳定、低依赖、可测试,而不是提供运行时服务。
阅读入口¶
- 数值、成长与权重:大数、定点数、数字格式化、成长曲线和权重表。
- 网格、路径与空间索引:2D 曲线与折线、弹簧平滑、规则网格、Hex、图搜索、3D 整数格、Pattern2D、Steering、TileMap 缓存和空间哈希。
- 数据流程与校验:标签、黑板、预算、集合、公式、Variant、通用标识、校验报告和轻量结果字典。
使用边界¶
- 适合放入 Foundation 的能力应当没有生命周期,不需要注册到
GFArchitecture。 - Foundation 类型不应持有场景节点、文件句柄、网络请求、线程任务或异步状态。
- 类型表达的应是稳定通用概念,例如数值、坐标、索引、查询条件、校验结果或纯数据转换。
- 需要
tick()、缓存、异步加载、ProjectSettings、文件系统或全局状态时,优先放到 Utilities。 - 需要扩展启用状态、Installer、扩展资源或可选运行时系统时,放到对应 Extensions 或项目自己的插件。
API Reference¶
完整类、方法和信号列表见 Standard API Reference。