GF Framework

GF Framework is a lightweight architecture framework for Godot 4. It helps larger projects keep gameplay code organized without taking over Godot's scene tree.

It separates:

• data and state in GFModel
• gameplay rules in GFSystem
• scene, UI, input, and presentation bridges in GFController
• lifecycle-managed runtime services in GFUtility
• pure algorithms and data helpers in standard/foundation
• optional atomic gameplay extensions in addons/gf/extensions

Highlights

• Managed lifecycle through the Gf AutoLoad and project installers.
• Events, commands, queries, typed accessors, bindable properties, and lifecycle-safe module lookup.
• Editor workspace for extension management, script templates, diagnostics, export filtering, and project tooling.
• New projects start with only the kernel and standard library active; bundled optional extensions are disabled by default and must be explicitly enabled.
• Standard utilities for storage, settings, audio, input, assets, diagnostics, UI routing, time, logging, and runtime inspection.
• Foundation helpers for graphs, grids, pathfinding, hex grids, layer masks, tags, validation reports, formulas, timelines, variant data, and formatting.
• Optional extensions for capabilities, action queues, save graphs, flow graphs, network snapshots, turn flow, interaction, feedback, camera, dialogue, combat, domain models, and physics helpers.
• GUT-tested maintenance suite and generated API reference.

Boundaries

GF does not define your gameplay rules. It does not replace Godot physics, rendering, animation, UI design, or scene composition. Use it when you want stable architecture seams and reusable tools while keeping project-specific decisions in your own code.

Install

Install the official Store package gf-framework-6.0.0.zip. It contains the full addons/gf addon folder: kernel, standard library, editor tooling, package manager, and bundled optional extensions. Optional extensions remain disabled until the project explicitly enables them, so the full package is the recommended first-install path.

Copy addons/gf into your Godot project, enable GF Framework in Project > Project Settings > Plugins, then call await Gf.init() from your boot scene or use a project installer.

Advanced modular installs are available from the GitHub Release. Download gf-kernel-6.0.0.zip only when you intentionally want a minimal bootstrap and will install additional packages through GF Package Manager, the Godot-native package CLI, a release registry, or an offline bundle. The minimal kernel package is not the recommended Store download for first-time users.

Documentation: https://gf-framework.readthedocs.io/ Source: https://github.com/C76GN/gf-framework License: Apache-2.0