Name: godot-4-ktm-free-world
Author: workwithchris

Imported from workwithchris/godot-4-ktm-free-world (AGENTS.md). Install upstream with npx skills add workwithchris/godot-4-ktm-free-world. Copyright stays with the author.

Racing — Godot 4 agent guide

Run

godot --path "/Users/apple/Desktop/untitled folder/racing"
godot --headless --quit-after 120 --path .          # headless sanity
godot --headless --editor --quit-after 300 --path . # reimport assets

macOS: no timeout command — use --quit-after <frames>.

Scenes

Scene	What	Entry
`scenes/kathmandu.tscn`	Real Kathmandu city (main game)	`project.godot` sets this as main
`scenes/main.tscn`	Procedural curved test track via `track_builder.gd`	Separate, not the default
`scenes/car.tscn`	Shared `VehicleBody3D` car	Used by both
`scenes/npc.tscn`	Capsule pedestrian used by `kathmandu_map.gd`	Spawned along road curbs

README is stale — it says main.tscn is the main scene. It's not. Trust project.godot.

Gotchas

engine_force sign inverted: VehicleBody3D positive engine_force pushes +Z (backward). car.gd uses negative values to accelerate nose-first (−Z). All spawn code orients car's −Z along travel direction.
Road ribbons vanish: flat ground quads face down in top-down view. Road/curb/marking materials must set cull_mode = CULL_DISABLED (already done — don't remove).
Terrain height sampling: road/building draping uses _height_at() which matches the terrain mesh triangle split exactly. If you change the terrain mesh, update _height_at too.

Data generation (tools/)

Run in order from tools/ dir. Bounding box must match across all 3:

python3 tools/fetch_map.py     # roads + buildings + SRTM elevation → data/kathmandu.json
python3 tools/fetch_trees.py   # trees + parks → merged into kathmandu.json
python3 tools/fetch_places.py  # named POIs → data/places.json

Current box: SOUTH,WEST,NORTH,EAST = 27.6940, 85.2980, 27.7260, 85.3340

Overpass mirrors + retries built in; the map fetch is slow (elevation API calls).

What exists

Real Kathmandu city from OSM: 2281 roads w/ lane markings + curbs, 46069 extruded buildings w/ window texture, 6289 tree billboards, 251 park green patches
Place search (navigation.gd) — 5000 POIs, straight-line HUD arrow + beacon (no routing)
Minimap (minimap.gd) — SubViewport orthographic, north-up, rotating car marker
Car auto-pauses when typing in search box (LineEdit focus check in _physics_process)
Pedestrian NPCs (npc.gd / npc.tscn) — spawned on wider-road curbs, walk back and forth along sidewalks

Limitations (don't expect working)

No turn-by-turn routing (just as-the-crow-flies)
No landmark models (Dharahara, Durbar Square, Boudhanath)
No brick/photo textures on buildings
No timed challenges or game-like structure beyond free drive

Debugging trick

Add a temp Node script that calls Input.action_press("accelerate") and saves a PNG: get_viewport().get_texture().get_image().save_png("debug.png"). Run headless once, inspect PNG.

Key files

progress.md — authoritative handoff doc (more current than README)
data/kathmandu.json (~12 MB) — do not hand-edit (machine-generated)
data/places.json — 5000 searchable POIs
scripts/kathmandu_map.gd — builds terrain, roads, buildings, trees from JSON; also spawns NPCs
scripts/car.gd — input → engine_force (note sign!), brake, steering
scripts/npc.gd — pedestrian back-and-forth sidewalk walker
scripts/navigation.gd — place search + HUD direction arrow (straight-line, not routed)
scripts/minimap.gd — top-down ortho SubViewport, north-up

No tests / no lint / no CI

This is a game project. No test framework, no linter, no typechecker, no CI config. Verification is manual (run the scene and look).

Style

GDScript, snake_case for functions/vars, PascalCase for classes
@export var for inspector-tweakable values
_ready() / _process(delta) / _physics_process(delta) lifecycle
SurfaceTool + StandardMaterial3D for procedural meshes

Install godot-4-ktm-free-world and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "workwithchris-godot-4-ktm-free-world-godot-4-ktm-free-world", "kind": "skill", "name": "godot-4-ktm-free-world", "description": "macOS: no `timeout` command — use `--quit-after <frames>`.", "publisher": "workwithchris", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "macOS: no `timeout` command — use `--quit-after <frames>`." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/workwithchris/godot-4-ktm-free-world", "path": "AGENTS.md", "ref": "c6f518f30fe197f82b09505c66a47c335a7db066", "url": "https://github.com/workwithchris/godot-4-ktm-free-world/blob/c6f518f30fe197f82b09505c66a47c335a7db066/AGENTS.md", "key": "workwithchris/godot-4-ktm-free-world/AGENTS.md" } }, "instructions": "# Racing — Godot 4 agent guide\n\n## Run\n\n```bash\ngodot --path \"/Users/apple/Desktop/untitled folder/racing\"\ngodot --headless --quit-after 120 --path . # headless sanity\ngodot --headless --editor --quit-after 300 --path . # reimport assets\n```\n\nmacOS: no `timeout` command — use `--quit-after <frames>`.\n\n## Scenes\n\n| Scene | What | Entry |\n|---|---|---|\n| `scenes/kathmandu.tscn` | Real Kathmandu city (main game) | `project.godot` sets this as main |\n| `scenes/main.tscn` | Procedural curved test track via `track_builder.gd` | Separate, not the default |\n| `scenes/car.tscn` | Shared `Vehic", "cost": { "context_tokens": 981 } }

godot-4-ktm-free-world

About