Introduction¶
DeepSeek Harness (DSH) is a plugin-based architecture. The dsh-godot-ai plugin adds a dedicated Godot Creator mode to DSH for Godot game development. It operates the editor through the official Godot AI to automate the entire workflow, from scene construction and script writing to UI creation and runtime validation.
Plugin Introduction¶
This plugin is maintained by gosomea and aims to solve the low efficiency caused by frequent tool switching and manual editing of scenes and scripts in Godot development. It does not replace the game engine; instead, it acts as a mode layer that centrally manages Godot-specific rules, skills, and workflows.
Core Features¶
The plugin provides the following capabilities:
- Project operations: Create and modify scenes, nodes, GDScript/C# scripts, resources, signals, and input settings.
- Asset production: Create UI, animations, materials, Shaders, particles, audio, cameras, and environments.
- Runtime and validation: Run the game, inspect the scene tree, runtime status, errors, warnings, logs, and visuals; simulate input within the supported scope of the tools.
- Workflow: Follow the loop of “reading → small-batch modifications → re-reading → running → validating”; on failure, recover from a verified stage.
- Creator dashboard and marketplace: View project, Addon, backend, and version status in the Creator dashboard; review, install, update, and roll back third-party knowledge in the Skill marketplace.
Installation and Enablement¶
1. Environment Preparation¶
The following environment requirements must be met:
* DSH version: 0.2.0-rc.2 Web
* Node.js: 22.19+ in the 22.x line or 24+ (do not use Node 23)
* Tool: uvx
* Godot: minimum 4.5, recommended 4.7+
First check the uvx version:
uvx --version
2. Install the Plugin¶
Use the same profile as your Web instance to install it. For example, for the local web-rc2:
dsh plugin --profile web-rc2 add dsh-godot-ai@0.7.0
After the current task ends, restart the original Web command. Godot Creator will automatically appear in the Agent preset list, without needing to click “Install Game Creation Mode” separately.
3. Enable the Addon in the Godot Project¶
The plugin depends on the official Godot AI and must be installed manually:
- Open the target project in Godot.
- Search for Godot AI in AssetLib and install the 3.1.5 version that is compatible with the backend.
- Open Project → Project Settings → Plugins and enable Godot AI.
- Keep the project open in the editor.
Typical Usage¶
In DSH, create a new session and select Godot Creator. Open the game Creator dashboard at the top, confirm the connection status and target project, then enter your requirements.
For example, to create a 480×720 2D dodge game:
创建一个 480×720 的 2D 躲避游戏。
玩家可以左右移动和跳跃，碰到障碍后重生，走到终点显示胜利，
并提供重新开始按钮。完成后运行游戏，检查日志和画面。
Applicable Scenarios and Notes¶
- Applicable scenarios: Developers who need AI assistance to build Godot scenes, write GDScript/C# scripts, and debug runtime status.
- Notes:
- The Godot AI backend is fixed to the verified 3.1.5 version and will not change automatically.
- All capabilities are consolidated into a single
godot-creatorpreset; the Adaptive mode is no longer provided. - Third-party Skills do not run scripts or installers; critical risks are hard-blocked; marketplace data is stored in
$DSH_HOME/dsh-godot-ai/skill-market/v1. - Old
godot-creator-adaptivesessions do not guarantee lossless recovery.
Closing¶
The plugin is released under the MIT license, and all capabilities are integrated into the godot-creator preset. For more information, visit the plugin catalog or the GitHub repository.
