Class SteeringAgent

A mutable SteeringContext with a weighted blender and a one-line integrator — the convenience wrapper plan P8-2 leaves optional.

It exists because every real use of this module repeats the same three things: hold the agent's state, add up several behaviours with weights, and apply the result. None of that belongs inside a behaviour, and all of it is tedious to rewrite.

const agent = new SteeringAgent({ maxSpeed: 6, maxAcceleration: 12 });
const scratch = new Vector3();
const steering = new Vector3();

agent.beginSteering();
agent.addSteering(separation(agent, neighbors, scratch), 1.5);
agent.addSteering(alignment(agent, neighbors, scratch), 1.0);
agent.addSteering(cohesion(agent, neighbors, scratch), 1.0);
agent.endSteering(steering);       // weighted sum, truncated to the budget
agent.integrate(1 / 60, steering);
Copy

The blend is a weighted sum truncated once at the end, the simplest of the combination strategies Reynolds describes. Prioritized dithering and truncated running-sum arbitration are deliberately not here: they change which behaviours are evaluated at all, which is an application policy.

integrate is semi-implicit Euler with a speed clamp — the §38 default and the same rule MotionComponent uses (v += a·dt, clamp, x += v·dt) — so an agent driven by this class and one driven by a MotionComponent move identically. It is a convenience for standalone agents and headless tests; an agent that is a scene node should be driven by MotionSystem (§39) or a physics body instead, with position/velocity mirroring the node.

The three vectors are owned by the agent and never replaced. Allocation happens only in the constructor.