Godot-Agent-Framework

> ⚠️ WORK IN PROGRESS - DO NOT DOWNLOAD OR USE IN PRODUCTION ⚠️ > > *This repository is currently undergoing a massive architectural rewrite to comply with the official MCP (Model Context Protocol) standard. The codebase is highly unstable, tools are partially implemented, and the API is subject to breaking changes. This message will be removed once V1.4.0 reaches stability.*

The Godot Agent Framework (GAF) is a professional, high-performance, and secure ecosystem designed to empower AI Agents in autonomous game development. It establishes a robust bi-directional communication channel between AI models and the Godot Editor API, enabling real-time scene manipulation, script editing, and project lifecycle management.

GAF is organized into specialized modules to ensure maximum flexibility and reliability across different development environments:

Contains specialized AI profiles designed to execute complex Godot tasks:

• Lead Engineer: Orchestrates framework health and deployment.
• Gameplay Programmer: Implements mechanics and logic systems.
• Technical Artist: Manages visual assets, shaders, and scene layouts.

The GAF-Bridge is a lightweight, zero-dependency Node.js gateway that routes instructions:

• Protocol: Pure TCP (Standard JSON-RPC 2.0).
• Port: Static 1342.
• Security: Localhost filtering (IP Loopback only, 127.0.0.1).
• Isolation: No external packages required (npm install-free).

The GAF-Sync Engine is a native Godot Editor Plugin that serves as the AI's "hands" inside the engine:

• Connectivity: TCP Client mode connecting to GAF-Bridge.
• Access: Direct interface with EditorInterface, EditorFileSystem, and SceneTree.
• Feedback: Real-time visual status reporting in the