Marks on the Hull

        "ShipDamageFX": {}

/** What the engine plugin has to be able to do. */
export interface ShipDamageFXExtension {
  /**
   * Detach every child of `meshId` whose name ends with one of `suffixes` and set
   * it tumbling. On a GLB ship the primitives are hidden (the model is what you
   * see), so the plugin must reveal them — otherwise a wing "comes off" invisibly.
   */
  shedSubparts(meshId: string, suffixes: readonly string[], spec: DebrisSpec): void;
  /**
   * Clone `meshId`'s own primitives into wreckage without removing them, for a
   * ship that has to survive the effect (the player, who respawns).
   */
  blowApart(meshId: string, spec: DebrisSpec): void;
  /**
   * Stick a crater at a world point on the child nearest it. `suffixes` narrows the
   * search to one part when the hit named one; null means "anywhere on the hull".
   */
  addHole(
    meshId: string,
    suffixes: readonly string[] | null,
    x: number, y: number, z: number,
    diameter: number,
    maxPerPart: number,
  ): void;
  /** Stick a crater on the nearest piece of already-detached wreckage. */
  addHoleOnDebris(x: number, y: number, z: number, diameter: number, maxPerPart: number): void;
  /** Advance wreckage and expire it. Driven by the System, so it respects pause. */
  tick(dt: number): void;
  dispose(): void;
}