FAQ
Compatibility
Section titled “Compatibility”What versions of Godot are supported?
Section titled “What versions of Godot are supported?”Godot 4.x (any 4.x release). GodotIQ reads .tscn, .gd, and .tres files in the Godot 4 format. Godot 3.x projects use a different file format and are not supported.
What Python version do I need?
Section titled “What Python version do I need?”Python 3.10, 3.11, 3.12, 3.13. GodotIQ uses modern Python features (type unions, match statements) that require 3.10+.
What platforms does GodotIQ run on?
Section titled “What platforms does GodotIQ run on?”Windows, macOS, Linux. The MCP server is pure Python with only 4 runtime dependencies (mcp, websockets, httpx, platformdirs). No native dependencies, no compilation required. The Godot addon is pure GDScript (~500 lines).
Which AI clients work with GodotIQ?
Section titled “Which AI clients work with GodotIQ?”Any MCP-compatible client. Tested with:
- Claude Code (recommended)
- Cursor
- Windsurf
- VSCode with Copilot
See the client guides for setup: Claude Code, Cursor, Windsurf, VSCode.
Free vs Pro
Section titled “Free vs Pro”What do I get for free?
Section titled “What do I get for free?”22 tools for raw operations (read, write, execute, query). No license required:
- Bridge (19):
godotiq_ping,godotiq_editor_context,godotiq_scene_tree,godotiq_node_ops,godotiq_build_scene,godotiq_save_scene,godotiq_script_ops,godotiq_file_ops,godotiq_exec,godotiq_run,godotiq_input,godotiq_screenshot,godotiq_camera,godotiq_state_inspect,godotiq_perf_snapshot,godotiq_watch,godotiq_undo_history,godotiq_check_errors,godotiq_verify_motion - Animation:
godotiq_animation_info - UI:
godotiq_ui_map - Navigation:
godotiq_nav_query
Of these 22 tools, 4 are filesystem-only (godotiq_ping, godotiq_script_ops, godotiq_file_ops, godotiq_animation_info) and 18 require the Godot addon for live editor/game interaction.
What does Pro add?
Section titled “What does Pro add?”14 intelligence tools that analyze, reason, predict, and suggest. All are filesystem-only (no addon required):
- Memory (2):
godotiq_project_summary,godotiq_file_context - Code (4):
godotiq_dependency_graph,godotiq_validate,godotiq_signal_map,godotiq_impact_check - Flow (1):
godotiq_trace_flow - Animation (1):
godotiq_animation_audit - Assets (2):
godotiq_asset_registry,godotiq_suggest_scale - Spatial (3):
godotiq_scene_map,godotiq_spatial_audit,godotiq_placement - Visual (1):
godotiq_explore
Community users can invoke Pro tool names, but the public package only returns preview/upgrade output. Full Pro implementations are delivered through the private Pro bundle after license validation.
Does GodotIQ work without the addon?
Section titled “Does GodotIQ work without the addon?”Yes. 18 tools work without the addon (4 free filesystem tools + all 14 Pro intelligence tools), no Godot running needed. The addon enables the remaining 18 free bridge tools for live editor/game interaction.
Performance
Section titled “Performance”Does GodotIQ affect Godot’s performance?
Section titled “Does GodotIQ affect Godot’s performance?”PRO tools don’t interact with Godot at all. They read files on disk. Zero runtime impact.
The addon bridge adds a lightweight WebSocket server (port 6007) inside the editor. It has no measurable impact on editor or game performance. The bridge only processes commands when your AI makes a tool call.
How does GodotIQ affect token usage?
Section titled “How does GodotIQ affect token usage?”Tool outputs contribute to your AI context window. GodotIQ provides three verbosity levels to manage this:
| Level | Token impact | Best for |
|---|---|---|
brief | ~80% fewer tokens | Large projects, routine operations |
normal | Baseline | General development |
full | ~40% more tokens | Debugging, investigation |
Set detail_level in .godotiq.json or pass detail per tool call.
Security & Privacy
Section titled “Security & Privacy”Does GodotIQ send data anywhere?
Section titled “Does GodotIQ send data anywhere?”Your project files stay on your machine. The MCP server runs locally; the addon communicates over localhost only. For Pro activation, GodotIQ contacts Polar (license validation) and pro.godotiq.com (Pro bundle download) — these requests transmit your license key and product version, not your project files.
Your project data flows from GodotIQ to your AI client, which processes it according to that client’s privacy policy.
For the full disclosure, see /how-licensing-works/.
Can GodotIQ modify my project files?
Section titled “Can GodotIQ modify my project files?”PRO tools are read-only. They analyze but never modify project files.
Free bridge tools (godotiq_node_ops, godotiq_exec, godotiq_script_ops, godotiq_file_ops, etc.) can modify scenes and resources through the Godot editor. Use protected_files and disabled_tools to restrict access.
Licensing & Pricing
Section titled “Licensing & Pricing”How much does Pro cost?
Section titled “How much does Pro cost?”$19 — one-time purchase. All future versions included.
Is it a subscription?
Section titled “Is it a subscription?”No. One-time payment. All future versions included.
Can I use it commercially?
Section titled “Can I use it commercially?”Yes. Pro is a per-developer license for commercial or personal projects — no royalties, no restrictions on what you ship. All future versions included.
How many machines can I use it on?
Section titled “How many machines can I use it on?”Activate on any device. Free up a slot by deactivating another. Manage your active device from /manage/. Each team member needs their own license.
Can I get a refund?
Section titled “Can I get a refund?”Refunds are case-by-case — email [email protected]. If GodotIQ doesn’t work for you, we’ll make it right.
Is the Community edition open source?
Section titled “Is the Community edition open source?”The Community package and the Godot addon are MIT-licensed and open source. The Pro bundle containing the 14 intelligence tools is commercial and requires a license key (GODOTIQ_LICENSE_KEY env var).
Is there a Discord?
Section titled “Is there a Discord?”Not yet — use mailto:[email protected] for now.
Troubleshooting
Section titled “Troubleshooting””Tool not found” error
Section titled “”Tool not found” error”Your AI client can’t see GodotIQ’s tools. Check:
- The MCP server is running and configured in your client. See Installation.
- The tool isn’t listed in
disabled_toolsin.godotiq.json. - Restart your AI client. Some clients cache the tool list at startup.
Bridge tools fail but free tools work
Section titled “Bridge tools fail but free tools work”The MCP server is running but the Godot addon isn’t connected:
- Check the addon’s bottom panel in Godot. Is the status green?
- Verify the port matches in both
.godotiq.jsonand the addon settings. - See Addon Troubleshooting for detailed steps.
”Protected file” error
Section titled “”Protected file” error”A tool tried to modify a file matched by your protected_files patterns. This is working as intended. Remove the pattern from .godotiq.json if you want to allow modifications.
GodotIQ is slow on my large project
Section titled “GodotIQ is slow on my large project”For projects with 100+ scenes, set "detail_level": "brief" in .godotiq.json. This reduces output size by ~80% and speeds up tool responses significantly.
How do I update GodotIQ?
Section titled “How do I update GodotIQ?”pip install --upgrade godotiqFor the addon, download the latest version and replace the addons/godotiq/ directory.