Godot AI Assistant: Plugin Inside or Agent Outside?
A Godot AI assistant can sit inside the editor as a plugin, or work on your project from outside as a coding tool. A plugin keeps you in Godot and can run on your own computer, while an outside tool is the better choice for changes across many scenes and scripts.
What does a plugin inside Godot do?
AI Assistant Hub is a community plugin that shows the idea well. Its page, read on 2 November 2026, describes it as a way to "embed AI assistants in Godot with the ability to read and write code in Godot's Code Editor". It has an MIT licence and is tested in Godot 4.7 stable, and its authors expect most earlier versions to work.
The plugin does not contain any AI. It connects Godot to one you choose:
- On your own computer: Ollama, llama.cpp or Jan.
- Online: Google Gemini, OpenRouter or xAI, among others.
Its tools can create scripts and append, replace or delete code. Any tool that writes starts on "Ask", so each change waits for your OK. Leave that on until you have good reason not to. To use these tools, your AI must support tool use. If it does not, Quick Prompts can still send selected code to it and place the answer in the editor.
Inside or outside?
| You want | Choose |
|---|---|
| Nothing leaving your computer | Plugin with AI running locally |
| Help with one script while you work | Plugin |
| Changes across many scenes and scripts | Outside coding tool, connected by Godot MCP |
| The AI to run the game and read errors | Outside coding tool with MCP |
The honest tradeoff is that a small AI on a home computer costs no per-message fees and keeps your code private, but it is not as capable as the big online ones. So give it small jobs, and expect to help it more.
Take Harbor Crane, an invented game where you swing crates onto ships. "Make the hook slow down at the end of its swing" is one script and a perfect plugin job. "Add a second crane with its own controls, screen and scoring" touches many files, so hand that to an outside tool.
Two habits that help small AIs
Name your version. The way Godot code is written has changed between versions, and an AI may remember the old way. The number is on the Project Manager screen.
Keep the diagram in the script. A small AI has a short memory, so a plan you agreed on yesterday is gone today. Ask it to draw the hook in a few lines of Mermaid, walk through it with you, and paste it as a comment at the top of the script. Mermaid is a text format for diagrams, and mermaid.live draws it. From then on, the plan travels with the code, and any chat that reads the script can see it.
When you get to the hook's feel, the same thinking as for a good jump applies: try small changes to one number at a time.
Paste this to your AI
You are helping me in Godot, version [number]. My project is Harbor Crane. The selected script swings the crane hook.
The hook should slow down near the end of each swing and come back, and a crate on the hook should make it swing slower.
Stay inside this one script. First write a short Mermaid diagram of the hook: empty and swinging, picking up, loaded and swinging, dropping. For each arrow, say what could go wrong, such as a drop in the middle of a swing. Wait for my OK, then add the diagram as a comment at the top of the script and work from it.
Before each edit, quote the lines you will replace and say in one sentence what they do today. Use only functions you can see in this script, or ones you are sure exist in my version. If you are not sure, say so and tell me what to search for in Godot's built-in help. After the edit, name the value to change for a heavier crate.
Or skip this and connect the MCP: your AI then finds all of this by itself.Connect the MCP
How to check it worked
- Compare the quoted lines before you approve. They should match your script exactly.
- Run the scene with and without a crate. The loaded hook should swing slower.
- Drop a crate mid-swing. The hook should do what the diagram says.
- Change the named value. A heavier crate should feel heavier. If nothing changes, the answer was wrong.
- Go offline, if you use local AI. It should still answer.