# my-game → splash port inventory (generated 2026-07-09)

Exhaustive Godot API surface of ~/games/my-game (the AI-generated corpus), used as the
acceptance checklist for the aigame engine port. Two parallel games: 2D side-scroller
(main.tscn) and the ACTIVE 3D sandbox (main3d.tscn, run/main_scene). 13 actors share one
behavior pattern set; 2D/3D scripts are near-mirrors.

## First-class engine APIs required (by measured usage weight)

- **Position as currency**: `global_position` read/write ×122 (write = teleport: respawn,
  mount-follow, carry). `distance_to` ×14, `length` ×23, `normalized` ×16.
- **Kinematic character motion**: `move_and_slide` ×14 (ALL actors), `is_on_floor()` ×33,
  hand-rolled gravity (`velocity.y += G*dt`, engine gravity unused), `move_toward` ×9
  (friction), `is_on_wall` ×6 (hop trigger), per-actor jump/fall constants, respawn on
  fall (y beyond limit → teleport to recorded `_spawn`).
- **World building**: StaticBody2D/3D + box colliders for ALL terrain; 3D visuals 100%
  MeshInstance3D+BoxMesh+StandardMaterial3D.albedo_color (8 sites); 2D visuals 100%
  ColorRect. Counts: 2D = 6 ground + 19 platforms + 7 movers + walls/flag/hills; 3D =
  ground 3 + stairs 7 + towers 8 + trees 12 + goal + 10 creatures + 2 vehicles.
- **Groups as event bus** (no signal bus!): groups player/vehicle/soldier/kissy/huggy/game;
  `get_nodes_in_group` iterated per-frame for nearest-target;
  broadcast = scan group + `has_method()` duck-typing ×14 (`huggy_caught`, `enrage`,
  `capture`, `rescue`, `zap`, `send_home`, `cam_yaw`…). Engine needs: tags + find/iterate
  + dynamic method dispatch on entities.
- **Scene tree**: `add_child` ×53 (all procedural), `is_instance_valid` ×14 (cached-ref
  guards), `set_script` ×6 (behavior attach to bare bodies), `queue_free` ×3 (bolt).
- **Input**: `get_axis(left,right)` ×6, `is_action_just_pressed` ×7; actions used:
  shoot×8, ui_up/right/left/accept×4 each, ui_down×2, ui_cancel×1. RUNTIME InputMap
  action creation (shoot = mouse-left + F key + gamepad X). Mouse-capture relative-motion
  camera (captured/visible modes, pitch clamp, Esc release).
- **Camera**: 2D = child cam, position smoothing (speed 6), level-bounds limits.
  3D = CamYaw→CamPitch→Camera3D boom (z=13), mouse yaw/pitch, camera-relative locomotion
  via `Basis(UP, yaw) * wish` — shared by player AND vehicle steering (`driver.cam_yaw()`).
- **Random/AI math**: randf_range ×16, randf ×7, randi/pick_random ×5, lerp ×8, atan2
  (model facing), sin/cos ping-pong (movers).
- **Audio — procedural synth, zero files** (sfx.gd autoload the AI wrote itself):
  8-voice AudioStreamPlayer pool, 22050Hz s16 WAV buffers generated by `_sweep`
  (square pitch glide), `_zap` (falling tone+noise), `_notes` (arpeggio). Bank: jump,
  shoot, zap, grab, angry, calm, rescue, shove, board, win. API `Sfx.play(name, pitch)`.
  → aigame should ship this as first-class (`game.sfx("jump")` + beep/jingle synth).

## Structural patterns to support

- Mount/dismount: nearest group("vehicle") within REACH → `mount(player)` → disable
  collider (deferred) + stop actor physics + per-frame teleport to seat; up to 3
  passenger seats; eject with pop velocity + cooldown.
- Win conditions polled in `_process` (goal distance / x threshold) + `_won` latch + HUD.
- HUD: Label text/visible + font/outline theme overrides; transient banners via
  `await create_timer(s)` with generation-token cancel (the ONLY async in the game — no
  tweens/AnimationPlayer anywhere).
- Ledge AI: RayCast repositioned per frame + force_raycast_update; ±90° sidestep along
  edges (no navmesh). Needs script-facing raycast.
- Moving platforms (2D): AnimatableBody2D sync_to_physics, cosine ping-pong, carries
  riders via floor tracking.
- Collision layers: 1=world, 2=creatures, 4=vehicle, 8=player; creatures/player mask
  world-only (pass through each other); bolt masks world+creatures.
- Label3D billboard nametags (no_depth_test); emission material on bolt projectile;
  ProceduralSky + one shadowed DirectionalLight3D.

## Confirmed absent (do NOT build): tweens, particles, AnimationPlayer, navmesh,
custom shaders, paths, physics joints (in-game), signals (only Area3D.body_entered ×1).

## Porting risk list (ranked)
1. Procedural audio synth (engine-side now, task #6)
2. Mouse-capture camera + camera-relative movement basis
3. Ledge raycast AI (script raycast API)
4. Moving platforms carrying riders (mover ground-velocity inheritance)
5. Runtime input action registration (ActionMap covers it)
6. Deferred collision toggling during mount (engine needs disable-collision-safe-point)
7. Jolt move_and_slide floor-snap feel parity (box3d mover tuning)