Skip to content

v1.0.0 (2026-10-02)

Choose a tag to compare

@ftyu3d ftyu3d released this 02 Oct 10:18
· 3 commits to main since this release

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

安装

  1. 下载 gdframe.zip,解压到 Godot 工程根目录,得到 addons/gdframe/。
  2. 打开 项目 → 项目设置 → 插件,启用 GDFrame。
  3. 首次启用会生成 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。