最小启动与 Installer¶

最小启动只需要注册模块、初始化架构，再从架构取回需要的模块。

extends Node


func _ready() -> void:
    Gf.register_model(PlayerModel.new())
    Gf.register_utility(GFStorageUtility.new())
    Gf.register_system(BattleSystem.new())

    await Gf.init()

    var player_model := Gf.get_model(PlayerModel) as PlayerModel
    var battle_system := Gf.get_system(BattleSystem) as BattleSystem
    battle_system.start_encounter(player_model)

这个例子表达的是最小流程：

注册 GFModel、GFUtility 和 GFSystem。
调用 await Gf.init() 进入生命周期。
从架构取回模块时使用 as Type 保留补全和显式失败处理。

真实项目通常不会把所有注册写在某个场景 _ready() 里，而是使用 Installer。

使用 Installer¶

如果项目需要统一装配，可以创建 GFInstaller：

class_name GameInstaller
extends GFInstaller


func install(architecture: GFArchitecture) -> void:
    architecture.register_model_instance(PlayerModel.new())
    architecture.register_utility_instance(GFStorageUtility.new())
    architecture.register_system_instance(BattleSystem.new())

然后把安装器路径加入 Project Settings > gf/project/installers。调用 await Gf.init() 时，GF 会先运行启用扩展的 Installer，再运行项目 Installer，最后进入模块生命周期。

Installer 只负责注册模块，不应该直接启动关卡、打开 UI 或执行玩法流程。启动流程更适合放在引导场景或专门的 GFSystem 中。