Repository navigation
v1.0.0 (2026-10-02)
GDFrame 1.0.0
面向 Godot 4.7 的第一个正式版本。启用插件后注册 Autoload GDFrame,通用能力从服务对象调用,例如 GDFrame.ui、GDFrame.save、GDFrame.audio。
要求
- Godot 4.7+
包含
- UI:预加载、打开与关闭、图层栈、dim、Esc 关闭、手柄/键盘焦点导航
- Input:键鼠、手柄、触屏设备跟踪,以及导航焦点策略
- Save:用户目录 profile 与多槽位
Resource,原子写和损坏恢复 - Settings:窗口模式、分辨率、垂直同步、帧率上限、语言
- Audio:BGM 交叉淡入、SFX 池与限流、界面复音、2D/3D 音效
- Pause:多 reason 暂停栈,同步场景树暂停与音频暂停
- Pool:场景对象池,编辑器内可看统计
- FSM:按 owner 绑定,首次访问
GDFrame.fsm时加载 - Ext:可选扩展,见 GDFrame Ext
安装
- 下载 gdframe.zip,解压到 Godot 工程根目录,得到
addons/gdframe/。 - 打开 项目 → 项目设置 → 插件,启用 GDFrame。
- 首次启用会生成
res://gdframe_project/和GDFrameConstants。
func _ready() -> void:
await GDFrame.ui.preload_ui(GDFrameConstants.UI_EXAMPLE)
GDFrame.ui.open(GDFrameConstants.UI_EXAMPLE)API、配置和编辑器 Dock 见仓库 editor/README.md。许可证为 MIT。