@jgengine/core 0.17.0 → 0.18.1

package/skills/jgengine-world/capabilities.md

@@ -4,6 +4,10 @@
 
 Reach for these before hand-rolling. Each row is *the thing you need* → *the primitive that already does it*.
 
+## ai-decision-graph — Evaluate serializable selector, sequence, condition, action, and utility AI decisions.
+
+- `createDecisionGraphRuntime` (function) · `import { createDecisionGraphRuntime } from "@jgengine/core/ai/decisionGraph"`
+
 ## ai-driver — difficulty-aware chase/route driving step producing throttle/brake/steer for the vehicle sim
 
 - `driveStep` (function) · `import { driveStep } from "@jgengine/core/ai/driver"`
@@ -16,6 +20,16 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `createDriverState` (function) · `import { createDriverState } from "@jgengine/core/ai/driver"`
 
+## anim-graph — data-first animation state machine with blend trees, crossfades, layers, and clip events
+
+- `createAnimGraphRuntime` (function) · `import { createAnimGraphRuntime } from "@jgengine/core/anim/animGraph"`
+
+## animation — inverse kinematics orient a bone toward a target with constrained yaw and pitch
+
+- `lookAt` (function) · `import { lookAt } from "@jgengine/core/anim/ikSolver"`
+- `solveFabrik` (function) · `import { solveFabrik } from "@jgengine/core/anim/ikSolver"`
+- `solveTwoBone` (function) · `import { solveTwoBone } from "@jgengine/core/anim/ikSolver"`
+
 ## area-effect-field — source-following area membership with enter/refresh/leave edges, stacking, and cleanup
 
 - `createAreaEffectField` (function) · `import { createAreaEffectField } from "@jgengine/core/world"`
@@ -102,6 +116,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 - `registerBuiltinTriggerActions` (function) · `import { registerBuiltinTriggerActions } from "@jgengine/core/scene/authoredTriggers"`
 - `registerTriggerAction` (function) · `import { registerTriggerAction } from "@jgengine/core/world"`
 
+## behavior-actions — register named callbacks for decision graph behavior descriptors
+
+- `registerBehaviorActions` (function) · `import { registerBehaviorActions } from "@jgengine/core/world"`
+
 ## behavior-control — pause/disable/resume/seek/inspect behavior instances per entity
 
 - `behaviorControl` (function) · `import { behaviorControl } from "@jgengine/core/world"`
@@ -142,6 +160,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `createCameraShake` (function) · `import { createCameraShake } from "@jgengine/core/world"`
 
+## character-controller — capsule walk over the physics backend — slide, step-up, slopes, crouch, platforms
+
+- `createCharacterController` (function) · `import { createCharacterController } from "@jgengine/core/movement/characterController"`
+
 ## city-district — polygon math for road-derived blocks, parcels, and buildable footprints
 
 - `Vec2` (type) · `import { Vec2 } from "@jgengine/core/world/cityGeometry"`
@@ -279,6 +301,14 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `DEFAULT_FORWARD` (const) · `import { DEFAULT_FORWARD } from "@jgengine/core/world"`
 
+## free-flight — camera-relative creative/spectator/noclip/hover flight with correct strafe, sprint, and optional gravity
+
+- `createFreeFlightController` (function) · `import { createFreeFlightController } from "@jgengine/core/world"`
+
+## gamepad-input — Resolve sampled gamepad input into actions with deadzones and response curves.
+
+- `resolveGamepadFrame` (function) · `import { resolveGamepadFrame } from "@jgengine/core/input/gamepadModel"`
+
 ## glide — gliding/wingsuit descent control from a launch
 
 - `createGlideModel` (function) · `import { createGlideModel } from "@jgengine/core/world"`
@@ -337,6 +367,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `generateLock` (function) · `import { generateLock } from "@jgengine/core/world"`
 
+## locomotion-graph — build the default idle/walk/run plus one-shot graph from clip names
+
+- `locomotionGraph` (function) · `import { locomotionGraph } from "@jgengine/core/anim/locomotionGraph"`
+
 ## map-annotations — player-drawn map annotation layer — freehand strokes, area shapes, and pinned notes, projected into the map's routes/zones props and serializable
 
 - `createAnnotationLayer` (function) · `import { createAnnotationLayer } from "@jgengine/core/world"`
@@ -378,6 +412,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `createOrderRegistry` (function) · `import { createOrderRegistry } from "@jgengine/core/world"`
 
+## particle-director — game-reachable VFX seam: queue one-shot particle bursts and keyed follow-capable standing emitters as serializable data for the shell to render
+
+- `createParticleDirector` (function) · `import { createParticleDirector } from "@jgengine/core/vfx/particleDirector"`
+
 ## particle-system — deterministic pooled particle emitter with SoA render buffers, burst/continuous emission, gravity/drag, size/color/alpha-over-life, and serializable state
 
 - `createParticleSystem` (function) · `import { createParticleSystem } from "@jgengine/core/world"`
@@ -403,6 +441,22 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `definePatrolOrder` (function) · `import { definePatrolOrder } from "@jgengine/core/world"`
 
+## perception-service — retain sight, sound, and damage observations with range, cone, occlusion, and decay policy
+
+- `createPerception` (function) · `import { createPerception } from "@jgengine/core/sensor/perception"`
+
+## physics-backend — one interface over interchangeable rigid-body solvers — bodies, joints, raycast, shapecast, snapshot
+
+- `PhysicsBackend` (interface) · `import { PhysicsBackend } from "@jgengine/core/physics/physicsBackend"`
+
+## physics-backend-conformance — the shared test contract a physics adapter runs to prove it matches the seam
+
+- `runPhysicsBackendConformance` (function) · `import { runPhysicsBackendConformance } from "@jgengine/core/physics/physicsBackendConformance"`
+
+## physics-world-backend — the zero-dependency PhysicsWorld solver exposed through the PhysicsBackend seam
+
+- `createPhysicsWorldBackend` (function) · `import { createPhysicsWorldBackend } from "@jgengine/core/physics/physicsWorldBackend"`
+
 ## piece-sockets-from-model — derive build-piece snap sockets from a model's named attach points
 
 - `pieceSocketsFromModel` (function) · `import { pieceSocketsFromModel } from "@jgengine/core/world/buildSockets"`
@@ -451,6 +505,14 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `evaluateQteSequence` (function) · `import { evaluateQteSequence } from "@jgengine/core/world"`
 
+## rapier-physics-backend — native capsules, shapecasts, rotation, CCD, joints, and collision queries
+
+- `createRapierBackend` (function) · `import { createRapierBackend } from "@jgengine/rapier"`
+
+## rate-window-policy — Evaluate deterministic request windows with retry timing.
+
+- `decideRateWindow` (function) · `import { decideRateWindow } from "@jgengine/core/time/rateWindow"`
+
 ## reputation — faction standing that crosses named reputation tiers
 
 - `tierForStanding` (function) · `import { tierForStanding } from "@jgengine/core/world"`
@@ -560,6 +622,14 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `surfaceRing` (function) · `import { surfaceRing } from "@jgengine/core/world"`
 
+## tactical-cover-points — derive cover candidates from navigation-mesh boundaries
+
+- `coverPoints` (function) · `import { coverPoints } from "@jgengine/core/ai/tacticalQueries"`
+
+## tactical-position-score — rank bounded tactical positions with caller-defined weights
+
+- `scorePositions` (function) · `import { scorePositions } from "@jgengine/core/ai/tacticalQueries"`
+
 ## target-acquirer — stateful held-target wrapper over an acquisition policy with retention
 
 - `createTargetAcquirer` (function) · `import { createTargetAcquirer } from "@jgengine/core/world"`
@@ -584,6 +654,30 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `raycastHeightField` (function) · `import { raycastHeightField } from "@jgengine/core/world/terrain"`
 
+## territory-cell-chunk — Map ownership cells to persisted world chunks.
+
+- `territoryChunkKey` (function) · `import { territoryChunkKey } from "@jgengine/core/world/territory"`
+
+## territory-footprint — Resolve exactly the ownership cells touched by a placement footprint.
+
+- `territoryFootprintCells` (function) · `import { territoryFootprintCells } from "@jgengine/core/world/territory"`
+
+## territory-owner-query — Read a loaded land cell owner for authoritative placement checks.
+
+- `territoryOwnerOf` (function) · `import { territoryOwnerOf } from "@jgengine/core/world/territory"`
+
+## territory-ownership — Claim, release and query land through host-owned snapshot storage.
+
+- `createTerritory` (function) · `import { createTerritory } from "@jgengine/core/world/territory"`
+
+## territory-placement — Purchase footprint cells atomically with object placement.
+
+- `placeWithTerritory` (function) · `import { placeWithTerritory } from "@jgengine/core/world/territory"`
+
+## territory-read-scope — Load the footprint and foreign-owner gap without scanning the world.
+
+- `territoryChunkKeys` (function) · `import { territoryChunkKeys } from "@jgengine/core/world/territory"`
+
 ## touch-controls — switch the on-screen touch control set when gameplay context changes (enter/exit vehicle, mount, build mode)
 
 - `setTouchControlsMode` (function) · `import { setTouchControlsMode } from "@jgengine/core/input/touchControlsMode"`
@@ -601,6 +695,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 
 - `resolveWalkerStep` (function) · `import { resolveWalkerStep } from "@jgengine/core/movement/solidObstacles"`
 
+## walker-solid-step-source — slide a step against solid geometry from a pure rules package
+
+- `resolveSourceWalkerStep` (function) · `import { resolveSourceWalkerStep } from "@jgengine/core/movement/solidObstacles"`
+
 ## wave-runner — observable serializable wave/spawn runner over the seeded spawn director — WAVE N, wave progress, budget/alert readout, onSpawn sink, snapshot/restore
 
 - `createWaveRunner` (function) · `import { createWaveRunner } from "@jgengine/core/world"`
@@ -620,6 +718,10 @@ Reach for these before hand-rolling. Each row is *the thing you need* → *the p
 - `buildTrimmedIntersections` (function) · `import { buildTrimmedIntersections } from "@jgengine/core/world"`
 - `trimBandAtJunctions` (function) · `import { trimBandAtJunctions } from "@jgengine/core/world"`
 
+## world-physics-colliders — Synchronize terrain and authored static colliders with a physics backend.
+
+- `syncWorldColliders` (function) · `import { syncWorldColliders } from "@jgengine/core/physics/worldColliders"`
+
 ## world-place — declare the place a game happens in — flat/round/voxel/board ground, surface laws, per-place physics
 
 - `world` (function) · `import { world } from "@jgengine/core/world"`