v1.0.3 (2026-10-19)

GDFrame 1.0.3

新增可配置的新建档案默认显示模式；窗口化分辨率改为「推荐列表 + 常见高度」，小屏下也会按缩放档给出可选尺寸。

新增

• GDFrameConfig.default_display_mode：新建档案默认显示模式（默认无边框全屏；Web 仅窗口化 / 无边框）。

改进

• 默认窗口化分辨率取推荐列表第二档（最大适配尺寸 + window_size_scale_steps）。
• 仅当可用区放得下 min_window_size 时才执行分辨率下限；放不下时仍保留各缩放档。
• 设置文案与文档同步上述行为。

升级

用新的 gdframe.zip 覆盖 addons/gdframe/，然后重新打开工程。可按需在 config.tres 调整 default_display_mode。

v1.0.2 (2026-10-12)

GDFrame 1.0.2

插件内文本资源统一为无 BOM 的 UTF-8，避免文件头不可见字节导致 Godot 解析异常。

修复

• 去掉若干脚本（如 config.gd、gdframe.gd、input_event_device.gd）及编辑器文档文件头的 UTF-8 BOM。

升级

用新的 gdframe.zip 覆盖 addons/gdframe/，然后重新打开工程。

v1.0.1 (2026-10-02)

GDFrame 1.0.1

没有扩展 profile 字段时，读档补默认值不再因缺少 apply 而中断启动。

修复

• 已安装模块都没有 profile_fields 时，生成的 profile_settings_defaults.gd 仍包含空的 static func apply。
• 启动读档不再报 Invalid call. Nonexistent function 'apply (via call)' in base 'GDScript'。

升级

用新的 gdframe.zip 覆盖 addons/gdframe/，然后重新打开工程。插件会重写 res://gdframe_project/generated/profile_settings_defaults.gd。

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

安装

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。