gdframe 发行版 - Gitee.com

最新版

2026-10-19 11:16 v1.0.3 4c2e24b

最后提交信息为：显示设置：可配置默认显示模式，并改进窗口化分辨率推荐与下限逻辑

v1.0.2 (2026-10-12)

2026-10-12 15:42 v1.0.2 14abb2c

最后提交信息为：移除 gdframe 脚本 UTF-8 BOM，统一无 BOM 文本编码

v1.0.1 (2026-10-02)

2026-10-02 23:00 v1.0.1 5b67145

最后提交信息为：修复无 profile 字段时缺少 apply 导致读档报错

v1.0.0 (2026-10-02)

2026-10-02 18:22 v1.0.0 a2f9a3f

## 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](https://gitee.com/ftyu3d/gdframe-ext)

## 安装

1. 下载 **gdframe.zip**，解压到 Godot 工程根目录，得到 `addons/gdframe/`。
2. 打开 **项目 → 项目设置 → 插件**，启用 **GDFrame**。
3. 首次启用会生成 `res://gdframe_project/` 和 `GDFrameConstants`。

```gdscript
func _ready() -> void:
	await GDFrame.ui.preload_ui(GDFrameConstants.UI_EXAMPLE)
	GDFrame.ui.open(GDFrameConstants.UI_EXAMPLE)
```

API、配置和编辑器 Dock 见仓库 [editor/README.md](https://gitee.com/ftyu3d/gdframe/blob/main/addons/gdframe/editor/README.md)。许可证为 [MIT](https://gitee.com/ftyu3d/gdframe/blob/main/LICENSE)。

最后提交信息为： Release GDFrame 1.0.0

封阳 / gdframe .gitee-modal { width: 500px !important; }

搜索帮助

封阳 / gdframe