valkor-ai Godot Project Scaffold
Loom does not prescribe an ECS, folder layout, asset pipeline, or game genre. Keep the existing project structure when one is already present. For a new project, use the smallest structure that matches the request and record the choice in the Loom architecture or task contract.
Inspect before editing
From the directory containing project.godot, check:
test -f project.godot
rg -n '^(config/features|run/main_scene|config/name|renderer/|environment/defaults)' project.godot
find . -maxdepth 2 -type f \( -name '*.tscn' -o -name '*.gd' -o -name '*.cs' \) | sort
Read the configured main scene before creating another entry point. Reuse existing autoloads, input actions, renderer settings, and naming conventions.
Minimal new project layout
Godot's Project Manager can create the project. A small code-first project can start with:
project-root/
├── project.godot
├── scenes/
│ └── main.tscn
├── scripts/
├── assets/
└── tests/ # only when tests are part of the project
For a 3D project, use a Node3D root, a Camera3D, at least one light, and a
world environment or clear background. Add collision shapes alongside bodies;
do not rely on visual meshes alone for gameplay collision.
project.godot checks
Use the exact ConfigFile syntax already present in the project. The common sections are:
[application]
config/name="Project Name"
run/main_scene="res://scenes/main.tscn"
[display]
window/size/viewport_width=1280
window/size/viewport_height=720
[rendering]
renderer/rendering_method="gl_compatibility"
Only add [input], [autoload], physics, or renderer settings when the task
needs them. Confirm every script-referenced input action exists before handing
off the task.
Optional dependencies
Treat addons as project dependencies, not as Loom features. Check the addon's
own compatibility table and pin a version that matches the installed Godot
version. Do not copy an entire addon repository into addons/; install only
the addon directory and verify that it contains plugin.cfg where applicable.
The references/project_settings.md file contains the detailed ConfigFile and
input serialization patterns carried over from the Godot reference material.
Verification
After scaffolding or changing scenes:
GODOT_BIN="${GODOT_PATH:-godot}"
"$GODOT_BIN" --headless --path . --editor --quit
Then run the project's tests, launch the main scene, and capture evidence when the task includes runtime or visual acceptance criteria.