MrTrenchTrucker/Isle-Slingers
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Isle-Slingers/js/physics/agents.md
Relay dc68c6e3dd Physics upgrade + repo modularization (RC-375D84) 
Delivered by Hermies Qwen, gated and deployed by Relay.

- Board tip/topple: full continuous rotation when a board's center of
  mass passes its support edge (Q1: smooth pivot swing, no discrete
  snap). Falling boards deal impact damage and can kill enemies in
  their fall path.
- Falling-object impact damage: blocks and birds can now kill enemies
  from vertical drops and side plows (velocity-aware crush gate),
  chain momentum transfers correctly through stacks (mass-weighted
  contact), repeated impacts finish tougher enemies.
- Landed-bird physics: a bird resting on a board remains a real
  physical body under continuous gravity (Q2: no lifetime timer). If
  its platform is destroyed it falls, damages what it lands on
  (chain reaction), and can kill enemies.
- Repo modularized: folders = modules, subfolders = submodules,
  architecture.md + MODULES.md at root, an agents.md card in every
  module and submodule (17 total).
- Test suite grown from 27 to 47 (20 new RED-watched tests for the
  above behaviors), all green. Golden differential against the
  original core confirmed the only behavioral changes are the
  intended ones.

Live at http://10.244.136.121:8093/, independently re-verified by
Relay (full suite re-run, module structure check, headless Chromium
smoke) before this push.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-29 13:21:18 +00:00

1.4 KiB
Raw Blame History

js/physics/ — agents.md

RC-375D84 S-2. Module map: MODULES.md; runtime model: architecture.md.

The physics module (aggregator). Deterministic, DOM-free.

  • index.js is the ONLY public face: it builds the shared scope P, runs every submodule installer against it, and exports ISLE_CORE (20-key API, see the return literal — keep it key-for-key stable; adding a key is fine, renaming or dropping one is not).
  • Submodules must load BEFORE this file in the browser (index.html order); under Node this file requires them in dependency order. Do not add a submodule without registering it in BOTH the index.html script list and this file's require list.
  • The core is the simulation's single source of truth: step(state, dt) is the only thing that mutates gameplay state. Everything else is either setup (createGame), input translation (launch), or read-only queries (activeBird, trajectory, aimVector, starsFor, birdsRemaining).
  • Invariants: fixed-timestep consumer (tests run 1/120 s); no Math.random() in gameplay paths (determinism is a test arm); no DOM access.
  • New physics behavior lands in the owning submodule, NOT here. RC-375D84 S-3..S-5 (landed 2026-09-29): topple/ owns board tip-over (Q1 full continuous rotation), collision/ owns velocity-aware crush + mass-weighted stacks (S-4), step/ owns the landed-bird state and its integration (S-5).