Components

<Afterburner>Copy Anchor Link

A group with a nozzle at its origin. The plume streams along the group's local +Z, aft of a model that flies along -Z, and follows the group every frame. It takes every <group> prop (position, rotation, scale, children…), plus:

params is compared field by field, so an inline object is fine. A change rewrites only this nozzle's instance.

Left out, throttle is the nearest <Engine>'s, from @aeronautic/controls, else the flight's inside a <FlightProvider>, else 1.1, full reheat.

AfterburnerHandleCopy Anchor Link

What ref gives you. It's stable for the component's life, and safe to use before the nozzle is in a batch.

type AfterburnerHandle = {
  throttle: number;
  setParams: (params: AfterburnerParamsInput) => void;
  updateParams: (params: AfterburnerParamsInput) => void;
  setOffset: (offset: AfterburnerOffset) => void;
  setDirection: (direction: [number, number, number]) => void;
  readonly params: Readonly<AfterburnerParams> | null;
  readonly object: Group | null;
  readonly nozzle: AfterburnerNozzle | null;
  readonly batch: AfterburnerBatchHandle | null;
};

A prop overrides what the handle wrote whenever that prop changes.

<AfterburnerBatch>Copy Anchor Link

The batch its children draw with. Without one, nozzles share a batch per scene, preset and flight.

useAfterburnerBatch()Copy Anchor Link

Returns the nearest <AfterburnerBatch>'s AfterburnerBatchHandle from inside one, or null outside.

const Overlay = () => {
  const batch = useAfterburnerBatch();
  useFrame(() => console.log(batch?.stats()));
  return null;
};