← Back to Skills Marketplace
dashiming

Godot Game Claw Bridge

by dashiming · GitHub ↗ · v1.5.0 · MIT-0
cross-platform ⚠ suspicious
576
Downloads
1
Stars
2
Active Installs
5
Versions
Install in OpenClaw
/install godot-bridge
Description
Godot 4.x Project Generator CLI. Create 2D/3D games with 80+ CLI commands: projects, scenes, scripts, levels, UI (menu/HUD/dialog/inventory), game components...
README (SKILL.md)

Godot Bridge - Project Generator CLI v3.0

Generate complete Godot 4.x projects with scenes, scripts, and game components.

Quick Start

# Create project
clawbridge init MyGame

# Enter project
cd MyGame

# Add components
clawbridge component health --type health
clawbridge component inventory --type inventory

# Add objects
clawbridge label "Score: 0" --x 50 --y 30
clawbridge box --x 200 --y 150
clawbridge camera --x 640 --y 360

# Open in Godot
clawbridge open

Commands

Project

clawbridge init MyGame              # Basic 2D project
clawbridge init MyGame --3d        # 3D project
clawbridge init MyGame --template rpg   # RPG template

Generate

clawbridge scene Main       # Generate scene
clawbridge script Player    # Generate script
clawbridge level Level1     # Generate level

Game Components

# Health System
clawbridge component health --type health

# Inventory System
clawbridge component inventory --type inventory

# Save/Load System
clawbridge component save_system --type save

# Input System
clawbridge component input_system --type input

# Dialogue System
clawbridge component dialogue --type dialogue

# Quest System
clawbridge component quest --type quest

Objects (add to scene)

clawbridge label "Hello" --x 100 --y 50
clawbridge button "Click" --x 200
clawbridge box --x 100 --y 100
clawbridge sphere --x 200
clawbridge camera --x 640 --y 360
clawbridge light --x 100
clawbridge particles --amount 50
clawbridge character

Generated Project Structure

MyGame/
├── project.godot
├── icon.svg
├── scenes/
│   └── main.tscn
├── scripts/
│   ├── main.gd
│   ├── game_manager.gd
│   └── [your components]
├── levels/
├── assets/
└── prefabs/

Game Components

Health System

  • take_damage(amount) - Apply damage
  • heal(amount) - Heal entity
  • is_alive() - Check if alive
  • Signals: health_changed, died

Inventory System

  • add_item(name) - Add item
  • remove_item(name) - Remove item
  • has_item(name) - Check item
  • get_item_count(name) - Get quantity

Save/Load System

  • save_game() - Save to disk
  • load_game() - Load from disk
  • Auto-saves player stats and current level

Input System

  • get_direction() - Get left/right input (-1 to 1)
  • is_jump_pressed() - Check jump

Dialogue System

  • show(lines) - Start dialogue with array of strings
  • next() - Advance to next line
  • Signals: line_displayed, dialogue_ended

Quest System

  • start_quest(name, target) - Start quest
  • update_quest(name, progress) - Update progress
  • complete_quest(name) - Complete quest
  • Signals: quest_started, quest_completed

Options

Option Description
--type Component type
--template Project template
--x, --y Position coordinates
--3d Create 3D project

Example: Complete RPG

# Create RPG project
clawbridge init MyRPG --template rpg

# Add game systems
clawbridge component health --type health
clawbridge component inventory --type inventory
clawbridge component quest --type quest
clawbridge component save_system --type save
clawbridge component dialogue --type dialogue

# Add UI
clawbridge label "HP: 100" --x 20 --y 20
clawbridge label "Gold: 0" --x 20 --y 50

# Open in Godot
clawbridge open

License

MIT

Usage Guidance
This skill appears to do what it says: generate Godot 4.x projects with scenes, scripts, and components. Before installing/running it: (1) Inspect the entire clawbridge.js file for any unexpected execSync calls or commands (especially around the 'open' command) because child_process can execute shell commands. (2) Run it in a disposable directory (not your home or a repo with secrets) so generated files and any save files are isolated. (3) If you expect the tool to open the Godot editor, ensure you have the Godot binary installed locally — the skill does not declare that dependency. (4) Only install/run if you trust the publisher (source/homepage unknown). If you want higher assurance, request the full source and confirm there are no network calls, credential access, or command-injection vectors in the remaining (truncated) portions of the script.
Capability Analysis
Type: OpenClaw Skill Name: godot-bridge Version: 1.5.0 The skill bundle provides a Godot 4.x project generator, but contains several high-risk security vulnerabilities in 'clawbridge.js'. Specifically, the 'open' command uses 'execSync' to execute the 'godot' binary using the current working directory path without sanitization, which could lead to command injection if the directory name contains shell metacharacters. Additionally, the script performs file operations and content generation using unsanitized user input, making it vulnerable to path traversal and file content injection. While these appear to be unintentional flaws rather than intentional malware, they represent a significant security risk for an automated agent.
Capability Assessment
Purpose & Capability
The name/description (Godot project generator) align with the included CLI implementation: the JS creates project folders, scenes, scripts, assets, and components as described. The skill only declares node as a required binary which matches the CLI being a Node script. Note: SKILL.md and commands include an 'open' step that likely invokes the Godot editor, but the registry metadata does not declare a dependency on a 'godot' binary — a minor mismatch to be aware of.
Instruction Scope
SKILL.md instructs the agent to run local CLI commands (init, scene, script, component, open, etc.) and to generate files inside the current working directory. The runtime instructions do not request unrelated files, secrets, or external endpoints. The generated 'save' component persists to 'user://save.dat' (a Godot user save path) which writes to disk — expected for a scaffolding tool but worth noting if you run it in a sensitive directory.
Install Mechanism
No install spec is provided (instruction-only from registry perspective), but the package includes an executable Node script (clawbridge.js). That is not necessarily malicious, but it means the CLI code is bundled and will run locally; there are no external downloads or URL-based installers in the manifest, which reduces supply-chain risk. Review the full script before executing on a machine you care about.
Credentials
The skill requests no environment variables or credentials and the code shown does not read secrets or external config paths. This is proportionate for a local project generator. The script does import child_process.execSync (used for shell operations in Node) — acceptable for invoking local tools (e.g., opening the Godot editor) but worth auditing because execSync can run arbitrary commands if fed untrusted input.
Persistence & Privilege
The skill does not request permanent/always-on privileges (always:false) and does not modify other skills or global agent configuration. It writes files into the current working directory (expected for a scaffolding CLI) but does not appear to try to persist beyond the generated project files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install godot-bridge
  3. After installation, invoke the skill by name or use /godot-bridge
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.5.0
**Major update: Godot-bridge is now a full Godot 4.x project generator CLI.** - Adds project generation: create complete Godot projects (2D/3D/RPG templates) via CLI. - New commands for generating scenes, scripts, levels, assets, and prefabs. - Introduces high-level game component generators: health, inventory, save/load, input, dialogue, quest systems, and more. - Expanded object commands to quickly add UI and game elements to scenes. - Provides export options for HTML5, Windows, macOS, Linux, Android, and iOS. - Updated documentation to reflect the new focus on project and component generation for rapid game prototyping.
v1.2.0
**Expanded commands and UI/graphics support** - Adds 100+ new commands for UI effects (shadow, outline, gradient, blur), animations (fade, pulse, shake, bounce, slide, spin, flip, blink, typewriter), and 2D/3D graphics creation. - Enhanced options for UI components and state effects (hover, pressed, disabled) with additional styling and animation controls. - Includes more shapes (rect, circle, polygon, star), effects, and flexible color/size/opacity parameters. - Significantly updates documentation, quick start guides, and example usage for clarity and feature showcase. - Suitable for advanced interactive scenes and beautiful interface creation, not only basic object instantiation.
v1.1.1
Expanded support for Godot features and commands. - Added commands for particles (fire, smoke, sparks), progress bars, checkboxes, sliders, and physics (rigid_body, character, area, apply_force). - Broadened available options to include mass, shape, particle amount, lifetime, color, slider range, value, and animation duration. - Updated documentation to reflect enhanced capabilities for particles, physics, and UI elements. - Improved the complete example to demonstrate new features. - Clarified descriptions and usage throughout the skill documentation.
v1.1.0
**Summary:** Adds WebSocket support and expands documentation for remote CLI control of Godot games. - WebSocket protocol option introduced alongside HTTP for improved real-time interaction. - Documentation expanded with more examples, troubleshooting, and usage scenarios. - New command-line options listed, including --ws for WebSocket. - Clear guidance on when to use this skill and when not to. - Overview and setup sections improved for clarity and quick onboarding.
v1.0.0
Initial release: Control Godot 4.x games from a Node.js CLI over HTTP. - Send commands to add UI, 3D objects, lighting, cameras, and load scenes in Godot remotely. - Includes sample CLI commands for common game elements (labels, buttons, meshes, lights, camera). - Provides setup instructions for both Node.js CLI and Godot server script integration. - Supports real-time updates by interacting with the running Godot project via HTTP. - Includes debugging commands to inspect or clear the game tree.
Metadata
Slug godot-bridge
Version 1.5.0
License MIT-0
All-time Installs 2
Active Installs 2
Total Versions 5
Frequently Asked Questions

What is Godot Game Claw Bridge?

Godot 4.x Project Generator CLI. Create 2D/3D games with 80+ CLI commands: projects, scenes, scripts, levels, UI (menu/HUD/dialog/inventory), game components... It is an AI Agent Skill for Claude Code / OpenClaw, with 576 downloads so far.

How do I install Godot Game Claw Bridge?

Run "/install godot-bridge" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Godot Game Claw Bridge free?

Yes, Godot Game Claw Bridge is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Godot Game Claw Bridge support?

Godot Game Claw Bridge is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Godot Game Claw Bridge?

It is built and maintained by dashiming (@dashiming); the current version is v1.5.0.

💬 Comments