AutoRunnerWeapons

AutoRunnerWeapons

The player car's guns, missiles, oil and smoke.

What it does

Hold Space and the machine guns fire. Press E for one missile, with a short cooldown between them. Hold Q and an oil slick lands behind the car every dropEvery seconds; R does the same with smoke.

Guns never run out. Missiles, oil and smoke do, and come back from the weapons truck through autoRunnerWeapons.grant. A key pressed for an empty weapon sends autoRunnerWeapons.empty, so a HUD can flash it.

Use it in a scene

{
  "Player": {
    "components": {
      "AutoRunnerWeapons": {
        "gunLevel": 1,
        "missiles": 2,
        "oil": 4,
        "smoke": 4
      }
    }
  }
}

Put it on a car with CarDrive and MeshPrimitive. The scene needs pools named bullet, missile, oil and smoke, or set the pool names. It is the missile blueprint's own seekTag that makes it hunt the bomber; this part only fires it.

Gun levels

export function gunMuzzles(level: number, side: number, forward: number): Muzzle[] {
  if (level <= 1) return [{ side: 0, forward, angle: 0 }];
  if (level === 2) {
    return [
      { side: -side, forward, angle: 0 },
      { side, forward, angle: 0 },
    ];
  }
  return [
    { side: -side, forward, angle: -0.035 },
    { side, forward, angle: 0.035 },
    { side: 0, forward: forward + 0.2, angle: 0 },
  ];
}

/** Rounds per second for a gun level. */
export function gunRate(level: number, base: number): number {
  return base * (level >= 3 ? 1.5 : level === 2 ? 1.2 : 1);
}

Each trigger pull fires every muzzle at once, so a level's punch is barrels times rate times damage. With the default gunRate and bulletDamage:

level 1: 1 barrel  ×  9.0 pulls/s × 7 =  63 damage/s
level 2: 2 barrels × 10.8 pulls/s × 7 = 151 damage/s
level 3: 3 barrels × 13.5 pulls/s × 7 = 284 damage/s

At level 1 the System swaps its one barrel left and right each shot, so it sounds like a twin mount. At level 3 the outer two barrels fan out by about 2 degrees.

Rounds keep the car's speed

Every round starts with the car's own speed added to its launch speed:

        vx: vx + p.dirX * w.missileSpeed,
        vz: vz + p.dirZ * w.missileSpeed,

This matters most for the slow rounds. A missile fired at the default 45 m/s from a car doing 52 m/s would start out slower than the car that fired it. With the car's speed added, it leaves at 97 m/s and pulls ahead. Oil and smoke do not move: each one lands dropBack metres behind the car, facing the way the car faces.

Settings

Events

A grant is capped at the max, so a full tank takes nothing. For guns, amount is levels.

Needs

• CarDrive supplies heading and speed.
• MeshPrimitive supplies position.
• AutoRunnerProjectile supplies the bullet and missile pools through launchProjectile.
• RoadHazard supplies the oil and smoke pools through dropHazard.
• KeyboardInput turns DOM keys into keyboard.keydown and keyboard.keyup on the bus, which is how the trigger keys arrive.