godot-pipeline

Godot Pipeline Skill

Drive Godot 4.x as a pipeline step — import assets produced by ComfyUI or Blender, trigger exports, and run scene automation.

Godot CLI Base

godot --headless --path /path/to/project

Default project path: /mnt/e/GoDot/getting-started-with-godot-4

Core Tools

1. Import Assets (Headless)

# Trigger Godot asset import re-scan
godot --headless --path "$GODOT_PROJECT" --editor --quit 2>/dev/null

# Or via GDScript executed inline:
godot --headless --script '
extends SceneTree
func _init():
    var dir = DirAccess.open("res://")
    dir.make_dir_recursive("res://pipeline_import/")
    print("Import scan complete")
    quit()
' --path "$GODOT_PROJECT"

2. Run Headless Scene Export

import subprocess, json
from pathlib import Path

GODOT_BIN = os.environ.get("GODOT_BIN", "godot")
PROJECT = os.environ.get("GODOT_PROJECT", "/mnt/e/GoDot/getting-started-with-godot-4")

def godot_export(preset: str = "standalone", output_path: str = None) -> Path:
    """Run Godot headless export."""
    cmd = [
        GODOT_BIN, "--headless",
        "--path", PROJECT,
        "--export-release", preset
    ]
    if output_path:
        cmd.append(output_path)
    result = subprocess.run(cmd, capture_output=True, text=True, timeout=300)
    if result.returncode != 0:
        raise RuntimeError(f"Godot export failed: {result.stderr}")
    return Path(output_path or f"{PROJECT}/exports/{preset}")

3. Execute GDScript Pipeline Step

import subprocess

def run_gdscript(script_path: str, args: list[str] = None) -> str:
    """Execute a GDScript file headless with optional args."""
    cmd = [
        "godot", "--headless",
        "--script", script_path,
        "--path", os.environ["GODOT_PROJECT"]
    ]
    if args:
        cmd += args
    result = subprocess.run(cmd, capture_output=True, text=True, timeout=120)
    return result.stdout + result.stderr

4. Watch Import Folder + Trigger

import watchdog.events, watchdog.observers, time, subprocess, os

class GodotImportHandler(watchdog.events.FileSystemEventHandler):
    def on_created(self, event):
        if event.is_directory:
            return
        ext = Path(event.src_path).suffix.lower()
        if ext in [".png", ".jpg", ".glb", ".gltf", ".fbx"]:
            print(f"New asset detected: {event.src_path}")
            # Trigger Godot import scan
            subprocess.run(
                ["godot", "--headless", "--path", os.environ["GODOT_PROJECT"],
                 "--editor", "--quit"],
                capture_output=True, timeout=60
            )