@carbonenginejs/runtime 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/trinity/eve/spaceObject/EveSpaceObject2.js

@@ -19,6 +19,7 @@ import { BLUELISTEVENT } from '#consts/blue';
 import { EveComponentType, ShouldReflect } from '../EveComponentTypes.js';
 import { ImpactConfiguration } from '../../generated/include/enums.js';
 import { EveLODHelper } from '../EveLODHelper.js';
+import { EveDamageOverlay as _EveDamageOverlay } from '../overlays/EveDamageOverlay.js';
 import { TriBatchType, ReflectionMode } from '#consts/graphics';
 import { MatrixCopyFrom3x4 } from '../lights/lightConversion.js';
 import { getBoneList } from '../../core/animation/Tr2GrannyAnimation.js';
@@ -55,11 +56,11 @@ const TRANSPARENT_CENTER = vec3.create();
 const OVERLAY_TYPE_OPAQUEONLY = 0;
 const OVERLAY_TYPE_ALL = 1;
 
-/**
- * The hull of an EVE space object - its mesh, locators, locator sets, decals,
- * attachments, lights, effect children, overlay effects, impact overlay and
- * controllers - together with the curve-driven world transform, visibility, LOD
- * and batch submission that drive them each frame.
+/**
+ * The hull of an EVE space object - its mesh, locators, locator sets, decals,
+ * attachments, lights, effect children, overlay effects, impact overlay and
+ * controllers - together with the curve-driven world transform, visibility, LOD
+ * and batch submission that drive them each frame.
  */
 let _EveSpaceObject;
 new class extends _identity {
@@ -71,7 +72,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "EveSpaceObject2",
         family: "eve/spaceObject"
-      }), carbon.inherit(ITr2BoundingBox, ITr2Renderable, IEveSpaceObject2, IEveInheritPropertiesOwner)], [[[edit, edit.notify, edit, edit.persist, type, type.int32, void 0, type.enum("trinity.EntityComponents.ReflectionMode")], 16, "reflectionMode"], [[edit, edit.persist, void 0, type.list("IEveSpaceObjectChild")], 16, "effectChildren"], [[edit, edit.persist, void 0, type.list("IEveTransform")], 16, "children"], [[edit, edit.notify, edit, edit.persist, type, type.string], 16, "name"], [[edit, edit.notify, edit, edit.readwrite, type, type.boolean], 16, "mute"], [[edit, edit.readwrite, void 0, type.objectRef("EveChildInheritProperties")], 16, "inheritProperties"], [[edit, edit.persist, void 0, type.list("EveCustomMask")], 16, "customMasks"], [[edit, edit.persist, void 0, type.list("EveMeshOverlayEffect")], 16, "overlayEffects"], [[edit, edit.read, void 0, type.objectRef("Tr2BindingVector3")], 16, "positionDelta"], [[edit, edit.read, type, type.int32, void 0, type.enum("trinity.Tr2Lod")], 16, "lodLevel"], [[edit, edit.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[edit, edit.readwrite, type, type.boolean], 16, "isPickable"], [[edit, edit.read, type, type.float32], 16, "estimatedPixelDiameter"], [[edit, edit.read, type, type.float32], 16, "estimatedPixelDiameterWithChildren"], [[edit, edit.read, type, type.vec3], 16, "generatedShapeEllipsoidCenter"], [[edit, edit.read, type, type.vec3], 16, "generatedShapeEllipsoidRadius"], [[edit, edit.read, void 0, type.objectRef("Tr2GrannyAnimation")], 16, "animationUpdater"], [[edit, edit.persist, type, type.string], 16, "dna"], [[edit, edit.notify, edit, edit.persist, type, type.boolean], 16, "castShadow"], [[edit, edit.persist, type, type.boolean], 16, "isAnimated"], [[edit, edit.persist, type, type.boolean], 16, "dynamicBoundingSphereEnabled"], [[edit, edit.persist, void 0, type.list("IEveSpaceObjectAttachment")], 16, "attachments"], [[edit, edit.persist, void 0, type.list("EveSpaceObjectDecal")], 16, "decals"], [[edit, edit.notify, edit, edit.persist, void 0, type.list("Tr2Light")], 16, "lights"], [[edit, edit.persist, void 0, type.list("Tr2ExternalParameter")], 16, "externalParameters"], [[edit, edit.persist, void 0, type.list("ITr2Controller")], 16, "controllers"], [[edit, edit.persist, void 0, type.list("EveLocator2")], 16, "locators"], [[edit, edit.persist, void 0, type.objectRef("Tr2MeshBase")], 16, "mesh"], [[edit, edit.persist, void 0, type.objectRef("EveImpactOverlay")], 16, "impactOverlay"], [[edit, edit.persist, type, type.vec3], 16, "clipSphereCenter"], [[edit, edit.notify, edit, edit.readwrite, type, type.float32], 16, "clipSphereFactor2"], [[edit, edit.notify, edit, edit.readwrite, type, type.float32], 16, "clipSphereFactor"], [[edit, edit.persist, void 0, type.list("TriObserverLocal")], 16, "observers"], [[edit, edit.read, type, type.vec3], 16, "worldPosition"], [[edit, edit.persist, void 0, type.objectRef("ITriQuaternionFunction")], 16, "rotationCurve"], [[edit, edit.read, type, type.quat], 16, "worldRotation"], [[edit, edit.persist, type, type.float32], 16, "modelScale"], [[edit, edit.persist, void 0, type.list("EveLocatorSets")], 16, "locatorSets"], [[edit, edit.readwrite, type, type.float32], 16, "activationStrength"], [[edit, edit.readwrite, type, type.color], 16, "albedoColor"], [[edit, edit.notify, edit, edit.persist, type, type.boolean], 16, "display"], [[edit, edit.persist, type, type.boolean], 16, "update"], [[edit, edit.read, type, type.float32], 16, "secondaryLightingSphereRadius"], [[edit, edit.persist, type, type.vec3], 16, "boundingSphereCenter"], [[edit, edit.notify, edit, edit.readwrite, type, type.float32], 16, "dirtLevel"], [[edit, edit.readwrite, type, type.vec4], 16, "customShaderData"], [[edit, edit.read, type, type.vec4], 16, "spaceObjectShipData"], [[edit, edit.read, type, type.int32], 16, "lastDamageLocatorHit"], [[edit, edit.notify, edit, edit.readwrite, type, type.boolean], 16, "damageLocatorAutoFilterEnabled"], [[edit, edit.persist, type, type.float32], 16, "boundingSphereRadius"], [[edit, edit.read, type, type.vec3], 16, "modelWorldPosition"], [[edit, edit.persist, void 0, type.objectRef("ITriVectorFunction")], 16, "modelTranslationCurve"], [[edit, edit.persist, void 0, type.objectRef("ITriQuaternionFunction")], 16, "modelRotationCurve"], [[edit, edit.persist, type, type.vec3], 16, "shapeEllipsoidCenter"], [[edit, edit.persist, type, type.vec3], 16, "shapeEllipsoidRadius"], [[edit, edit.persist, void 0, type.objectRef("ITriVectorFunction")], 16, "translationCurve"], [[edit, edit.read, type, type.mat4], 16, "worldTransform"], [[edit, edit.read, type, type.mat4], 16, "inverseWorldTransform"], [[edit, edit.read, type, type.mat4], 16, "lastWorldTransform"], [[edit, edit.read, type, type.vec3], 16, "worldVelocity"], [[edit, edit.readwrite, void 0, type.objectRef("ITr2AudGeometry")], 16, "audioGeometry"], [[type, type.boolean], 16, "isVisible"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetMesh"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetOverlayEffects"], [[carbon, carbon.method, impl, impl.adapted], 18, "AddController"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddObserver"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetInheritProperties"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetEffectChildByName"], [[carbon, carbon.method, impl, impl.implemented], 18, "OnListModified"], [[carbon, carbon.method, impl, impl.adapted], 18, "AddToEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddLight"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "RemoveFromEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetModelRotationCurve"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetModelRotationCurve"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetModelTranslationCurve"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetModelTranslationCurve"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateWorldTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateWorldBounds"], [[carbon, carbon.method, impl, impl.implemented], 18, "PrepareShaderData"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateShLighting"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearShLighting"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetParentData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectStructs"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateSyncronous"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateAsyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Native impostor, raytracing, and audio-emitter realization are not ported yet; graph visibility and LOD state are preserved.")], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Impostor submission and decal mesh caches are not ported yet; Trinity returns the backend-neutral renderable graph.")], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Overlay area-block batches are deferred; the view position arrives via the appended render-context argument instead of Carbon's renderer global.")], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon rebuilds from the geometry-resource notify callback; the GPU-free port rebuilds lazily on first batch use from the mesh areas alone.")], 18, "RebuildCachedData"], [[carbon, carbon.method, impl, impl.implemented], 18, "ReleaseCachedData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPickingBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetID"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("LOD draw args are left as a geometry source descriptor and primitive-count gating is not ported yet; Carbon bakes both here.")], 18, "GetShadowBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Overlay selection is fully represented in the CPU graph; realized-LOD draw arguments are not ported yet.")], 18, "GetBatchesFromOverlayVector"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Portable mesh area access replaces Carbon's native mesh-area vectors.")], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon reads the Tr2Renderer view-position global; the relocated camera state arrives via the threaded render context.")], 18, "GetSortValue"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Trinity retains and fills persistent VS/PS RawData; the engine owns device buffers, GPU-derived offsets, upload, and binding.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLights"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The optional length-one array replaces Carbon's float& sizeInShadow out-parameter.")], 18, "IsCastingShadow"], [[carbon, carbon.method, impl, impl.implemented], 18, "RegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "UnRegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "DisplayChildren"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetObserverTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocalToWorldTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetModelCenterWorldPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetWorldPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetWorldRotation"], [[carbon, carbon.method, impl, impl.implemented], 18, "FindSoundEmitter"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetMute"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayAnimationEx"], [[carbon, carbon.method, impl, impl.adapted], 18, "CalculateSkinnedBoundingBoxFromTransform"], [[carbon, carbon.method, impl, impl.adapted], 18, "CalculateSkinnedBoundingSphere"], [[carbon, carbon.method, impl, impl.implemented], 18, "InvalidateMergedLocators"], [[carbon, carbon.method, impl, impl.adapted], 18, "EnsureChildLocatorMerged"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateDamageLocatorFilter"], [[carbon, carbon.method, impl, impl.implemented], 18, "RunDamageLocatorFilter"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearImpactDamage"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearAnimations"], [[carbon, carbon.method, impl, impl.implemented], 18, "CreateImpactFromPosition"], [[carbon, carbon.method, impl, impl.adapted], 18, "CreateImpact"], [[carbon, carbon.method, impl, impl.implemented], 18, "EndAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "FreezeHighDetailMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocatorCount"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorCount"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorsForSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "MergeToLocatorSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddLocatorSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearLocatorSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetCloseLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetGoodLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetDamageLocatorDirection"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS keeps output parameters last and returns a validity flag for targetable callers.")], 18, "GetDamageLocatorPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocatorBindPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetClosestDamageLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("TriRand is represented by Math.random; all locator scoring remains source-faithful.")], 18, "GetGoodDamageLocatorIndex"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRadius"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetMissPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetImpactConfiguration"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetImpactOverlay"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetImpactOverlay"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasImpactConfigurationShield"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses an out-last signature; the ellipsoid intersection is otherwise source-faithful CPU math.")], 18, "GetImpactPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateImpact"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocator"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetTransformedDamageLocator"], [[carbon, carbon.method, impl, impl.adapted], 18, "IsImpostor"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorPositionFromSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorRotationFromSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "HandleControllerEvent"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChainAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChainAnimationEx"], [[carbon, carbon.method, impl, impl.adapted], 18, "RebuildBoundingSphereInformation"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's CcpMath::Sphere is represented by core-math sph3; object-shaped center/radius input is accepted at adapter boundaries.")], 18, "SetBoundingSphereInformation"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetControllerVariables"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Geometry resources without multi-LOD support expose their sole browser LOD as index zero.")], 18, "GetLastUsedMeshLod"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetLocatorTransform"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetLocalBoundingBox"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetWorldBoundingBox"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsBoundingBoxReady"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphere"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("TriFrustum is supplied structurally by the active engine; both exact and estimated browser frustum methods are supported.")], 18, "EstimatePixelDiameter"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsInFrustum"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphereCenter"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphereRadius"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBoneCount"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetImpactDamageState"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetImpactAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetControllerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetProceduralContainerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "StartControllers"], [[carbon, carbon.method, impl, impl.adapted], 18, "TransformLocators"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorInObjectSpace"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShapeEllipsoid"]], 0, void 0, _EveEntity));
+      }), carbon.inherit(ITr2BoundingBox, ITr2Renderable, IEveSpaceObject2, IEveInheritPropertiesOwner)], [[[edit, edit.notify, edit, edit.persist, type, type.int32, void 0, type.enum("trinity.EntityComponents.ReflectionMode")], 16, "reflectionMode"], [[edit, edit.persist, void 0, type.list("IEveSpaceObjectChild")], 16, "effectChildren"], [[edit, edit.persist, void 0, type.list("IEveTransform")], 16, "children"], [[edit, edit.notify, edit, edit.persist, type, type.string], 16, "name"], [[edit, edit.notify, edit, edit.readwrite, type, type.boolean], 16, "mute"], [[edit, edit.readwrite, void 0, type.objectRef("EveChildInheritProperties")], 16, "inheritProperties"], [[edit, edit.persist, void 0, type.list("EveCustomMask")], 16, "customMasks"], [[edit, edit.persist, void 0, type.list("EveMeshOverlayEffect")], 16, "overlayEffects"], [[edit, edit.read, void 0, type.objectRef("Tr2BindingVector3")], 16, "positionDelta"], [[edit, edit.read, type, type.int32, void 0, type.enum("trinity.Tr2Lod")], 16, "lodLevel"], [[edit, edit.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[edit, edit.readwrite, type, type.boolean], 16, "isPickable"], [[edit, edit.read, type, type.float32], 16, "estimatedPixelDiameter"], [[edit, edit.read, type, type.float32], 16, "estimatedPixelDiameterWithChildren"], [[edit, edit.read, type, type.vec3], 16, "generatedShapeEllipsoidCenter"], [[edit, edit.read, type, type.vec3], 16, "generatedShapeEllipsoidRadius"], [[edit, edit.read, void 0, type.objectRef("Tr2GrannyAnimation")], 16, "animationUpdater"], [[edit, edit.persist, type, type.string], 16, "dna"], [[edit, edit.notify, edit, edit.persist, type, type.boolean], 16, "castShadow"], [[edit, edit.persist, type, type.boolean], 16, "isAnimated"], [[edit, edit.persist, type, type.boolean], 16, "dynamicBoundingSphereEnabled"], [[edit, edit.persist, void 0, type.list("IEveSpaceObjectAttachment")], 16, "attachments"], [[edit, edit.persist, void 0, type.list("EveSpaceObjectDecal")], 16, "decals"], [[edit, edit.notify, edit, edit.persist, void 0, type.list("Tr2Light")], 16, "lights"], [[edit, edit.persist, void 0, type.list("Tr2ExternalParameter")], 16, "externalParameters"], [[edit, edit.persist, void 0, type.list("ITr2Controller")], 16, "controllers"], [[edit, edit.persist, void 0, type.list("EveLocator2")], 16, "locators"], [[edit, edit.persist, void 0, type.objectRef("Tr2MeshBase")], 16, "mesh"], [[edit, edit.persist, void 0, type.objectRef("EveImpactOverlay")], 16, "impactOverlay"], [[edit, edit.persist, type, type.vec3], 16, "clipSphereCenter"], [[edit, edit.notify, edit, edit.readwrite, type, type.float32], 16, "clipSphereFactor2"], [[edit, edit.notify, edit, edit.readwrite, type, type.float32], 16, "clipSphereFactor"], [[edit, edit.persist, void 0, type.list("TriObserverLocal")], 16, "observers"], [[edit, edit.read, type, type.vec3], 16, "worldPosition"], [[edit, edit.persist, void 0, type.objectRef("ITriQuaternionFunction")], 16, "rotationCurve"], [[edit, edit.read, type, type.quat], 16, "worldRotation"], [[edit, edit.persist, type, type.float32], 16, "modelScale"], [[edit, edit.persist, void 0, type.list("EveLocatorSets")], 16, "locatorSets"], [[edit, edit.readwrite, type, type.float32], 16, "activationStrength"], [[edit, edit.readwrite, type, type.color], 16, "albedoColor"], [[edit, edit.notify, edit, edit.persist, type, type.boolean], 16, "display"], [[edit, edit.persist, type, type.boolean], 16, "update"], [[edit, edit.read, type, type.float32], 16, "secondaryLightingSphereRadius"], [[edit, edit.persist, type, type.vec3], 16, "boundingSphereCenter"], [[edit, edit.notify, edit, edit.readwrite, type, type.float32], 16, "dirtLevel"], [[edit, edit.readwrite, type, type.vec4], 16, "customShaderData"], [[edit, edit.read, type, type.vec4], 16, "spaceObjectShipData"], [[edit, edit.read, type, type.int32], 16, "lastDamageLocatorHit"], [[edit, edit.notify, edit, edit.readwrite, type, type.boolean], 16, "damageLocatorAutoFilterEnabled"], [[edit, edit.persist, type, type.float32], 16, "boundingSphereRadius"], [[edit, edit.read, type, type.vec3], 16, "modelWorldPosition"], [[edit, edit.persist, void 0, type.objectRef("ITriVectorFunction")], 16, "modelTranslationCurve"], [[edit, edit.persist, void 0, type.objectRef("ITriQuaternionFunction")], 16, "modelRotationCurve"], [[edit, edit.persist, type, type.vec3], 16, "shapeEllipsoidCenter"], [[edit, edit.persist, type, type.vec3], 16, "shapeEllipsoidRadius"], [[edit, edit.persist, void 0, type.objectRef("ITriVectorFunction")], 16, "translationCurve"], [[edit, edit.read, type, type.mat4], 16, "worldTransform"], [[edit, edit.read, type, type.mat4], 16, "inverseWorldTransform"], [[edit, edit.read, type, type.mat4], 16, "lastWorldTransform"], [[edit, edit.read, type, type.vec3], 16, "worldVelocity"], [[edit, edit.readwrite, void 0, type.objectRef("ITr2AudGeometry")], 16, "audioGeometry"], [[type, type.boolean], 16, "isVisible"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetMesh"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetOverlayEffects"], [[carbon, carbon.method, impl, impl.adapted], 18, "AddController"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddObserver"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetInheritProperties"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetEffectChildByName"], [[carbon, carbon.method, impl, impl.implemented], 18, "OnListModified"], [[carbon, carbon.method, impl, impl.adapted], 18, "AddToEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddLight"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "RemoveFromEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetModelRotationCurve"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetModelRotationCurve"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetModelTranslationCurve"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetModelTranslationCurve"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateWorldTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateWorldBounds"], [[carbon, carbon.method, impl, impl.implemented], 18, "PrepareShaderData"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateShLighting"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearShLighting"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetParentData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectStructs"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateSyncronous"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateAsyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Native impostor, raytracing, and audio-emitter realization are not ported yet; graph visibility and LOD state are preserved.")], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Impostor submission and decal mesh caches are not ported yet; Trinity returns the backend-neutral renderable graph.")], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Overlay area-block batches are deferred; the view position arrives via the appended render-context argument instead of Carbon's renderer global.")], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon rebuilds from the geometry-resource notify callback; the GPU-free port rebuilds lazily on first batch use from the mesh areas alone.")], 18, "RebuildCachedData"], [[carbon, carbon.method, impl, impl.implemented], 18, "ReleaseCachedData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPickingBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetID"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("LOD draw args are left as a geometry source descriptor and primitive-count gating is not ported yet; Carbon bakes both here.")], 18, "GetShadowBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Overlay selection is fully represented in the CPU graph; realized-LOD draw arguments are not ported yet.")], 18, "GetBatchesFromOverlayVector"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Portable mesh area access replaces Carbon's native mesh-area vectors.")], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon reads the Tr2Renderer view-position global; the relocated camera state arrives via the threaded render context.")], 18, "GetSortValue"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Trinity retains and fills persistent VS/PS RawData; the engine owns device buffers, GPU-derived offsets, upload, and binding.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLights"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The optional length-one array replaces Carbon's float& sizeInShadow out-parameter.")], 18, "IsCastingShadow"], [[carbon, carbon.method, impl, impl.implemented], 18, "RegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "UnRegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "DisplayChildren"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetObserverTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocalToWorldTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetModelCenterWorldPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetWorldPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetWorldRotation"], [[carbon, carbon.method, impl, impl.implemented], 18, "FindSoundEmitter"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetMute"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayAnimationEx"], [[carbon, carbon.method, impl, impl.adapted], 18, "CalculateSkinnedBoundingBoxFromTransform"], [[carbon, carbon.method, impl, impl.adapted], 18, "CalculateSkinnedBoundingSphere"], [[carbon, carbon.method, impl, impl.implemented], 18, "InvalidateMergedLocators"], [[carbon, carbon.method, impl, impl.adapted], 18, "EnsureChildLocatorMerged"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateDamageLocatorFilter"], [[carbon, carbon.method, impl, impl.implemented], 18, "RunDamageLocatorFilter"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearImpactDamage"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearAnimations"], [[carbon, carbon.method, impl, impl.implemented], 18, "CreateImpactFromPosition"], [[carbon, carbon.method, impl, impl.adapted], 18, "CreateImpact"], [[carbon, carbon.method, impl, impl.implemented], 18, "EndAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "FreezeHighDetailMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocatorCount"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorCount"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorsForSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "MergeToLocatorSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddLocatorSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearLocatorSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetCloseLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetGoodLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetDamageLocatorDirection"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS keeps output parameters last and returns a validity flag for targetable callers.")], 18, "GetDamageLocatorPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocatorBindPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetClosestDamageLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("TriRand is represented by Math.random; all locator scoring remains source-faithful.")], 18, "GetGoodDamageLocatorIndex"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRadius"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetMissPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetImpactConfiguration"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetImpactOverlay"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetImpactOverlay"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasImpactConfigurationShield"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses an out-last signature; the ellipsoid intersection is otherwise source-faithful CPU math.")], 18, "GetImpactPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateImpact"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocator"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetTransformedDamageLocator"], [[carbon, carbon.method, impl, impl.adapted], 18, "IsImpostor"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorPositionFromSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorRotationFromSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "HandleControllerEvent"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChainAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChainAnimationEx"], [[carbon, carbon.method, impl, impl.adapted], 18, "RebuildBoundingSphereInformation"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's CcpMath::Sphere is represented by core-math sph3; object-shaped center/radius input is accepted at adapter boundaries.")], 18, "SetBoundingSphereInformation"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetControllerVariables"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Geometry resources without multi-LOD support expose their sole browser LOD as index zero.")], 18, "GetLastUsedMeshLod"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetLocatorTransform"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetLocalBoundingBox"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetWorldBoundingBox"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsBoundingBoxReady"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphere"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("TriFrustum is supplied structurally by the active engine; both exact and estimated browser frustum methods are supported.")], 18, "EstimatePixelDiameter"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsInFrustum"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphereCenter"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphereRadius"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBoneCount"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetImpactDamageState"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetImpactAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "CollectPartDamageOverlays"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetControllerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetProceduralContainerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "StartControllers"], [[carbon, carbon.method, impl, impl.adapted], 18, "TransformLocators"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetTransformedLocatorsFromSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorInObjectSpace"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShapeEllipsoid"]], 0, void 0, _EveEntity));
     }
     /** m_reflectionMode (EntityComponents::ReflectionMode - enum ReflectionMode) [READWRITE, PERSIST, NOTIFY, ENUM] */
     reflectionMode = (_initProto(this), _init_reflectionMode(this, 3));
@@ -211,10 +212,10 @@ new class extends _identity {
     /** m_psData.customData (Vector4) [READWRITE] - script/SOF-driven custom shader data. */
     customShaderData = (_init_extra_dirtLevel(this), _init_customShaderData(this, vec4.create()));
 
-    /**
-     * m_spaceObjectShipData (Vector4) [READ] - the packed shader ship data:
-     * .y activation strength, .z dirt level, .w bounding-sphere radius
-     * (PrepareShaderData, cpp:734-744). .x is authored elsewhere and left alone.
+    /**
+     * m_spaceObjectShipData (Vector4) [READ] - the packed shader ship data:
+     * .y activation strength, .z dirt level, .w bounding-sphere radius
+     * (PrepareShaderData, cpp:734-744). .x is authored elsewhere and left alone.
      */
     spaceObjectShipData = (_init_extra_customShaderData(this), _init_spaceObjectShipData(this, vec4.create()));
 
@@ -301,10 +302,10 @@ new class extends _identity {
 
     /** EVE_SPACEOBJECT_CUSTOWMASK_MAX (EveSpaceObject2.h:49) - custom-mask slots. */
 
-    /**
-     * Carbon g_secondaryLightingRadiusCutoffFactor (cpp:52), a registered engine
-     * setting defaulting to 0.3. It scales this hull's bounding radius into the
-     * cutoff below which a secondary light source is too small to matter.
+    /**
+     * Carbon g_secondaryLightingRadiusCutoffFactor (cpp:52), a registered engine
+     * setting defaulting to 0.3. It scales this hull's bounding radius into the
+     * cutoff below which a secondary light source is too small to matter.
      */
 
     /** Scratch for the per-frame shader-data fill; never allocate in it. */
@@ -315,7 +316,7 @@ new class extends _identity {
     // (cpp:3747 takes the world translation out of the STORED transposed matrix).
     // Carbon's paired m_perObjectDataVs/m_perObjectDataPs GPU buffers are the
     // engine's business; Invalidate on these records carries the same signal.
-    /** The ParentData Carbon builds on the stack for the decal pass
+    /** The ParentData Carbon builds on the stack for the decal pass
      * (EveSpaceObject2.cpp:1696), held here so the pass does not allocate. */
     #decalParentData = new IEveSpaceObject2ParentData();
     #vsData = RawData.create("EveSpaceObjectVSData");
@@ -331,12 +332,12 @@ new class extends _identity {
       this.mesh = mesh ?? null;
     }
 
-    /**
-     * Links the authored controllers, pushes authored inherit properties down to
-     * the effect children and lights, and derives the impact overlay's damage
-     * locator count from the "damage" locator set - which Carbon does at build
-     * time - so a field-populated graph reaches the same live state as the
-     * authoring path.
+    /**
+     * Links the authored controllers, pushes authored inherit properties down to
+     * the effect children and lights, and derives the impact overlay's damage
+     * locator count from the "damage" locator set - which Carbon does at build
+     * time - so a field-populated graph reaches the same live state as the
+     * authoring path.
      */
     Initialize() {
       for (const controller of this.controllers) {
@@ -367,9 +368,9 @@ new class extends _identity {
       return this.mesh;
     }
 
-    /**
-     * Replaces the hull mesh; the cached area blocks are only rebuilt on the next
-     * batch call.
+    /**
+     * Replaces the hull mesh; the cached area blocks are only rebuilt on the next
+     * batch call.
      */
     SetMesh(mesh) {
       this.mesh = mesh ?? null;
@@ -380,9 +381,9 @@ new class extends _identity {
       return this.overlayEffects;
     }
 
-    /**
-     * Appends a controller, links it to this object when it is not already linked,
-     * and replays the current controller variables onto it.
+    /**
+     * Appends a controller, links it to this object when it is not already linked,
+     * and replays the current controller variables onto it.
      */
     AddController(controller) {
       // The link and the variable replay are the INSERTED arm's (cpp:297-311).
@@ -390,20 +391,20 @@ new class extends _identity {
       return controller;
     }
 
-    /**
-     * Appends a placement observer, which is repositioned from the observer
-     * transform on every synchronous update; the observer is returned for
-     * chaining.
+    /**
+     * Appends a placement observer, which is repositioned from the observer
+     * transform on every synchronous update; the observer is returned for
+     * chaining.
      */
     AddObserver(observer) {
       this.observers.push(observer);
       return observer;
     }
 
-    /**
-     * Sets the colour set that effect children and lights inherit, creating the
-     * inherit-properties holder on first use, and pushes it to the existing
-     * children and lights.
+    /**
+     * Sets the colour set that effect children and lights inherit, creating the
+     * inherit-properties holder on first use, and pushes it to the existing
+     * children and lights.
      */
     SetInheritProperties(colorSet) {
       if (!this.inheritProperties) {
@@ -424,9 +425,9 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Returns the first effect child with the given name, or null when none
-     * matches.
+    /**
+     * Returns the first effect child with the given name, or null when none
+     * matches.
      */
     GetEffectChildByName(name) {
       const target = String(name ?? "");
@@ -438,20 +439,20 @@ new class extends _identity {
       return null;
     }
 
-    /**
-     * Carbon OnListModified (EveSpaceObject2.cpp:291-469), the owner reacting to
-     * its own lists. Carbon installs itself on six of them at cpp:217-222 and the
-     * lists notify it; a JavaScript array has no notify slot, so the managed child
-     * mutation drives the same call.
-     *
-     * Controllers link and replay the recorded variables on insert, unlink on
-     * remove, and unlink every one on unload. Effect children take ownership,
-     * replay variables and register with the component registry; removal
-     * unregisters and clears ownership. Overlay effects replay variables only.
-     * Inherited properties reach a newly inserted child or light. The LightOwner
-     * component follows the list edges: registered on the first light, dropped on
-     * the last removal or an unload. Decals renumber their priorities, which is
-     * the one arm needing SWAPPED and MOVED.
+    /**
+     * Carbon OnListModified (EveSpaceObject2.cpp:291-469), the owner reacting to
+     * its own lists. Carbon installs itself on six of them at cpp:217-222 and the
+     * lists notify it; a JavaScript array has no notify slot, so the managed child
+     * mutation drives the same call.
+     *
+     * Controllers link and replay the recorded variables on insert, unlink on
+     * remove, and unlink every one on unload. Effect children take ownership,
+     * replay variables and register with the component registry; removal
+     * unregisters and clears ownership. Overlay effects replay variables only.
+     * Inherited properties reach a newly inserted child or light. The LightOwner
+     * component follows the list edges: registered on the first light, dropped on
+     * the last removal or an unload. Decals renumber their priorities, which is
+     * the one arm needing SWAPPED and MOVED.
      */
     OnListModified(event, key = 0, key2 = 0, value = null, list = null) {
       const masked = event & BLUELISTEVENT.BELIST_EVENTMASK;
@@ -495,10 +496,10 @@ new class extends _identity {
       if (list === this.decals) this.#OnDecalListModified(masked, key, key2);
     }
 
-    /**
-     * Carbon cpp:413-431: the LightOwner component follows the list EDGES - the
-     * first light registers it, the last removal or an unload drops it. The same
-     * size rule RegisterComponents applies at registration time.
+    /**
+     * Carbon cpp:413-431: the LightOwner component follows the list EDGES - the
+     * first light registers it, the last removal or an unload drops it. The same
+     * size rule RegisterComponents applies at registration time.
      */
     #OnLightListModified(masked) {
       const registry = this.GetComponentRegistry();
@@ -510,11 +511,11 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Carbon cpp:433-468: a decal's priority IS its index, so every structural
-     * change renumbers from the affected position. The append special case is
-     * Carbon's own comment - "in case someone calls the append function of
-     * bluelist from python" - and it renumbers the last entry alone.
+    /**
+     * Carbon cpp:433-468: a decal's priority IS its index, so every structural
+     * change renumbers from the affected position. The append special case is
+     * Carbon's own comment - "in case someone calls the append function of
+     * bluelist from python" - and it renumbers the last entry alone.
      */
     #OnDecalListModified(masked, key, key2) {
       const decals = this.decals;
@@ -538,10 +539,10 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Appends an effect child, first giving it the hull's inherited properties and
-     * then replaying the current controller variables onto it, so a late addition
-     * starts in the same state as the rest.
+    /**
+     * Appends an effect child, first giving it the hull's inherited properties and
+     * then replaying the current controller variables onto it, so a late addition
+     * starts in the same state as the rest.
      */
     AddToEffectChildrenList(child) {
       // The ownership, the inherited properties and the variable replay are the
@@ -558,9 +559,9 @@ new class extends _identity {
       CjsModel.addChild(this, "lights", light);
     }
 
-    /**
-     * Drops every light from the hull; component registration is not revisited
-     * here.
+    /**
+     * Drops every light from the hull; component registration is not revisited
+     * here.
      */
     ClearLights() {
       // UNLOADSTART, which is what drops the LightOwner component registration
@@ -568,9 +569,9 @@ new class extends _identity {
       CjsModel.clearChildren(this, "lights");
     }
 
-    /**
-     * Removes an effect child, returning false when it is not attached to this
-     * hull.
+    /**
+     * Removes an effect child, returning false when it is not attached to this
+     * hull.
      */
     RemoveFromEffectChildrenList(child) {
       // The unregister and the cleared ownership are the REMOVED arm's
@@ -580,9 +581,9 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Sets the curve that rotates the model within the hull's ball rotation, or
-     * clears it when passed nothing.
+    /**
+     * Sets the curve that rotates the model within the hull's ball rotation, or
+     * clears it when passed nothing.
      */
     SetModelRotationCurve(curve) {
       this.modelRotationCurve = curve ?? null;
@@ -593,9 +594,9 @@ new class extends _identity {
       return this.modelRotationCurve;
     }
 
-    /**
-     * Sets the curve that offsets the model within the hull's ball position, or
-     * clears it when passed nothing.
+    /**
+     * Sets the curve that offsets the model within the hull's ball position, or
+     * clears it when passed nothing.
      */
     SetModelTranslationCurve(curve) {
       this.modelTranslationCurve = curve ?? null;
@@ -606,10 +607,10 @@ new class extends _identity {
       return this.modelTranslationCurve;
     }
 
-    /**
-     * Rebuilds the hull world transform for a frame from the ball position and rotation curves plus the optional model translation and rotation curves, applies modelScale as a uniform scale, then refreshes the inverse transform and the world bounds; the previous world transform is kept for motion vectors and the world velocity comes from the position curve's derivative.
-     * @param {number} time Frame time; repeating the previous call's time is a no-op.
-     * @returns {boolean} False when the transform had already been built for this time.
+    /**
+     * Rebuilds the hull world transform for a frame from the ball position and rotation curves plus the optional model translation and rotation curves, applies modelScale as a uniform scale, then refreshes the inverse transform and the world bounds; the previous world transform is kept for motion vectors and the world velocity comes from the position curve's derivative.
+     * @param {number} time Frame time; repeating the previous call's time is a no-op.
+     * @returns {boolean} False when the transform had already been built for this time.
      */
     UpdateWorldTransform(time) {
       const nextTime = Number(time) || 0;
@@ -663,9 +664,9 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Refreshes Carbon's realized world-space sphere from the dynamic skinned
-     * sphere when available, otherwise from the authored local sphere.
+    /**
+     * Refreshes Carbon's realized world-space sphere from the dynamic skinned
+     * sphere when available, otherwise from the authored local sphere.
      */
     UpdateWorldBounds() {
       const updater = this.animationUpdater;
@@ -683,10 +684,10 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Carbon EveSpaceObject2::PrepareShaderData (cpp:734-763): refreshes the
-     * world bounds, packs the ship data, and derives the clip-sphere dissolve
-     * values into the persistent per-object records.
+    /**
+     * Carbon EveSpaceObject2::PrepareShaderData (cpp:734-763): refreshes the
+     * world bounds, packs the ship data, and derives the clip-sphere dissolve
+     * values into the persistent per-object records.
      */
     PrepareShaderData(updateContext = null) {
       this.UpdateWorldBounds();
@@ -716,14 +717,14 @@ new class extends _identity {
       this.#psData.Set("clipSphereFactor2", [this.clipSphereFactor2]);
     }
 
-    /**
-     * Carbon EveSpaceObject2::UpdateShLighting (cpp:1411-1421): asks the scene's
-     * SH lighting manager for this hull's secondary-lighting coefficients, faded
-     * in across the low-detail threshold so a hull entering that range does not
-     * pop. The coefficients are cleared first, which is also what leaves the
-     * unwritten tail zero on the L1 path.
-     * @param {Object} manager - Tr2ShLightingManager
-     * @param {Object} [updateContext] - frame context, for the detail thresholds
+    /**
+     * Carbon EveSpaceObject2::UpdateShLighting (cpp:1411-1421): asks the scene's
+     * SH lighting manager for this hull's secondary-lighting coefficients, faded
+     * in across the low-detail threshold so a hull entering that range does not
+     * pop. The coefficients are cleared first, which is also what leaves the
+     * unwritten tail zero on the L1 path.
+     * @param {Object} manager - Tr2ShLightingManager
+     * @param {Object} [updateContext] - frame context, for the detail thresholds
      */
     UpdateShLighting(manager, updateContext = null) {
       const coefficients = this.#psData.Get("shLightingCoefficients");
@@ -739,21 +740,21 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Carbon EveSpaceObject2::ClearShLighting (cpp:1423-1426): drops this hull's
-     * secondary-lighting contribution back to nothing.
+    /**
+     * Carbon EveSpaceObject2::ClearShLighting (cpp:1423-1426): drops this hull's
+     * secondary-lighting contribution back to nothing.
      */
     ClearShLighting() {
       this.#psData.Get("shLightingCoefficients").fill(0);
       return true;
     }
 
-    /**
-     * Carbon EveSpaceObject2::GetParentData (cpp:1872-1885): the values an
-     * attachment needs from its hull. `shLighting` is a LIVE view into the PS
-     * record, exactly as Carbon hands out a raw pointer into m_psData - an
-     * attachment reading it sees the hull's current coefficients.
-     * @param {Object} [out] - caller-owned record, refreshed in place
+    /**
+     * Carbon EveSpaceObject2::GetParentData (cpp:1872-1885): the values an
+     * attachment needs from its hull. `shLighting` is a LIVE view into the PS
+     * record, exactly as Carbon hands out a raw pointer into m_psData - an
+     * attachment reading it sees the hull's current coefficients.
+     * @param {Object} [out] - caller-owned record, refreshed in place
      */
     GetParentData(out = new IEveSpaceObject2ParentData()) {
       mat4.copy(out.transform, this.worldTransform);
@@ -770,11 +771,11 @@ new class extends _identity {
       return out;
     }
 
-    /**
-     * Carbon EveSpaceObject2::GetPerObjectStructs (cpp:1485-1490): hands a copy
-     * of both records to a caller, with the VS record's customData taken from the
-     * PS record as Carbon does.
-     * @returns {{vs: RawData, ps: RawData}} independent copies, not live records
+    /**
+     * Carbon EveSpaceObject2::GetPerObjectStructs (cpp:1485-1490): hands a copy
+     * of both records to a caller, with the VS record's customData taken from the
+     * PS record as Carbon does.
+     * @returns {{vs: RawData, ps: RawData}} independent copies, not live records
      */
     GetPerObjectStructs(vsData = RawData.create("EveSpaceObjectVSData"), psData = RawData.create("EveSpaceObjectPSData")) {
       vsData.CopyFrom(this.#vsData);
@@ -786,9 +787,9 @@ new class extends _identity {
       };
     }
 
-    /**
-     * Refreshes the world transform, then - when the update flag is on - places the observers, stamps the LOD-gated curve clock while advancing the overlay effects, runs the effect children's synchronous pass with the current placement, and updates the impact overlay; the overlay effects receive the context time as both clocks, as Carbon does.
-     * @returns {boolean} False when the update flag is off; the world transform is refreshed either way.
+    /**
+     * Refreshes the world transform, then - when the update flag is on - places the observers, stamps the LOD-gated curve clock while advancing the overlay effects, runs the effect children's synchronous pass with the current placement, and updates the impact overlay; the overlay effects receive the context time as both clocks, as Carbon does.
+     * @returns {boolean} False when the update flag is off; the world transform is refreshed either way.
      */
     UpdateSyncronous(updateContext = null) {
       const time = _EveSpaceObject.#GetContextValue(updateContext, "GetTime", "currentTime", "time");
@@ -829,9 +830,9 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Runs the controllers at a frequency derived from the hull's estimated pixel diameter against the context's high-detail threshold, advances the object curve sets only on frames the synchronous LOD gate stamped, then updates the transform children, the effect children and the impact overlay.
-     * @returns {number} The controller update frequency in 0..1, which is also handed to the effect children; 0 when the hull is not visible or the update flag is off.
+    /**
+     * Runs the controllers at a frequency derived from the hull's estimated pixel diameter against the context's high-detail threshold, advances the object curve sets only on frames the synchronous LOD gate stamped, then updates the transform children, the effect children and the impact overlay.
+     * @returns {number} The controller update frequency in 0..1, which is also handed to the effect children; 0 when the hull is not visible or the update flag is off.
      */
     UpdateAsyncronous(updateContext = null) {
       if (!this.update) {
@@ -908,9 +909,9 @@ new class extends _identity {
       return frequency;
     }
 
-    /**
-     * Updates Carbon's visibility, pixel-size, and mesh-LOD state, then forwards
-     * visibility to the explicitly owned visual branches.
+    /**
+     * Updates Carbon's visibility, pixel-size, and mesh-LOD state, then forwards
+     * visibility to the explicitly owned visual branches.
      */
     UpdateVisibility(updateContext = null, _parentTransform = _EveSpaceObject.#identityTransform) {
       this.isVisible = false;
@@ -981,10 +982,13 @@ new class extends _identity {
           decal.UpdateVisibility(updateContext, parentData);
         }
       }
+
+      // Carbon EveSpaceObject2.cpp:1715-1716 sizes EVERY object, mesh or not: a
+      // mesh-less modular object still draws its impacts at this LOD.
+      _EveSpaceObject.#SetSphere(_EveSpaceObject.#worldSphere, this.modelWorldPosition, this.#boundingSphereWorldRadius);
+      this.#meshScreenSize = _EveSpaceObject.#GetEstimatedPixelSize(frustum, _EveSpaceObject.#worldSphere) * lodFactor;
+      if (!this.#allowLodSelection) this.#meshScreenSize = Infinity;
       if (this.mesh && this.#boundingSphereWorldRadius > 0) {
-        _EveSpaceObject.#SetSphere(_EveSpaceObject.#worldSphere, this.modelWorldPosition, this.#boundingSphereWorldRadius);
-        this.#meshScreenSize = _EveSpaceObject.#GetEstimatedPixelSize(frustum, _EveSpaceObject.#worldSphere) * lodFactor;
-        if (!this.#allowLodSelection) this.#meshScreenSize = Infinity;
         this.mesh.UseWithScreenSize?.(this.#meshScreenSize, this.#boundingSphereWorldRadius);
       }
       return this.isVisible;
@@ -998,6 +1002,10 @@ new class extends _identity {
       }
       if (this.mesh && this.#isMeshVisible && this.mesh.IsLoading?.() !== true) {
         out.push(this);
+      } else if (!this.mesh && this.impactOverlay && this.#isMeshVisible) {
+        // A mesh-less modular object still draws its impacts (Carbon
+        // EveSpaceObject2.cpp:1545-1548).
+        out.push(this);
       }
       if (this.DisplayChildren()) {
         for (const child of this.children) child?.GetRenderables(out);
@@ -1019,13 +1027,18 @@ new class extends _identity {
       return out;
     }
 
-    /** Carbon ITr2Renderable contract (EveSpaceObject2.cpp:1097-1140): activated
-     * attachments recurse, the impact overlay contributes, the hull mesh delegates
-     * per batch type, and TRANSPARENT routes through the distance-sorted area
-     * path. GetBatchesFromOverlayVector (precomputed overlay area blocks) is
+    /** Carbon ITr2Renderable contract (EveSpaceObject2.cpp:1097-1140): activated
+     * attachments recurse, the impact overlay contributes, the hull mesh delegates
+     * per batch type, and TRANSPARENT routes through the distance-sorted area
+     * path. GetBatchesFromOverlayVector (precomputed overlay area blocks) is
      * deferred with the overlay realization work. */
     GetBatches(batches, batchType, perObjectData, reason, renderContext = null) {
-      if (!this.mesh) return false;
+      if (!this.mesh) {
+        // Mesh-less objects (modular ships) still render their impact effects
+        // (Carbon EveSpaceObject2.cpp:1127-1135).
+        if (!this.impactOverlay) return false;
+        return this.impactOverlay.GetBatches(batches, batchType, perObjectData, this.#meshScreenSize);
+      }
       if (this.mesh.display === false) return false;
 
       // Returns whether any batch was committed (JS addition; Carbon returns
@@ -1062,11 +1075,11 @@ new class extends _identity {
     // from the geometry resource when it exposes them; a failed lookup keeps
     // Carbon's origin-center fallback.
 
-    /**
-     * Commits the mesh's transparent areas back-to-front, ordering them by the
-     * squared distance from the view position to each area's world-space
-     * bounding-box center and falling back to the object origin when the geometry
-     * resource cannot supply a box.
+    /**
+     * Commits the mesh's transparent areas back-to-front, ordering them by the
+     * squared distance from the view position to each area's world-space
+     * bounding-box center and falling back to the object origin when the geometry
+     * resource cannot supply a box.
      */
     #GetSortedTransparentBatches(areas, batches, perObjectData, renderContext) {
       const geometry = this.mesh.GetGeometryResource() ?? null;
@@ -1104,10 +1117,10 @@ new class extends _identity {
       }
     }
 
-    /** Rebuilds the cached overlay/shadow area-block lists from the current mesh
-     * (Carbon RebuildCachedData, EveSpaceObject2.cpp:2077-2097, triggered there by
-     * the geometry-resource load callback). TYPE_ALL = shadow-casting OPAQUE +
-     * TRANSPARENT + DECAL areas; TYPE_OPAQUEONLY = shadow-casting OPAQUE; the
+    /** Rebuilds the cached overlay/shadow area-block lists from the current mesh
+     * (Carbon RebuildCachedData, EveSpaceObject2.cpp:2077-2097, triggered there by
+     * the geometry-resource load callback). TYPE_ALL = shadow-casting OPAQUE +
+     * TRANSPARENT + DECAL areas; TYPE_OPAQUEONLY = shadow-casting OPAQUE; the
      * shadow list groups OPAQUE areas by shared material. All coalesced. */
     RebuildCachedData() {
       this.ReleaseCachedData();
@@ -1127,9 +1140,9 @@ new class extends _identity {
       this.#cachedAreaBlocksBuilt = true;
     }
 
-    /**
-     * Drops the cached overlay and shadow area-block lists so the next batch call
-     * rebuilds them from the current mesh.
+    /**
+     * Drops the cached overlay and shadow area-block lists so the next batch call
+     * rebuilds them from the current mesh.
      */
     ReleaseCachedData() {
       for (const blocks of this.#overlayMeshAreaBlocks) {
@@ -1139,25 +1152,25 @@ new class extends _identity {
       this.#cachedAreaBlocksBuilt = false;
     }
 
-    /**
-     * Rebuilds the cached area blocks on first use when a mesh is attached; Carbon
-     * instead rebuilds them from the geometry-resource load callback.
+    /**
+     * Rebuilds the cached area blocks on first use when a mesh is attached; Carbon
+     * instead rebuilds them from the geometry-resource load callback.
      */
     #EnsureCachedAreaBlocks() {
       if (!this.#cachedAreaBlocksBuilt && this.mesh) this.RebuildCachedData();
     }
 
-    /**
-     * Carbon EveSpaceObject2::GetPickingBatches (cpp:3645-3675): collects the
-     * geometry a pick pass should test, by mask. It is ordinary batch collection
-     * - the pick itself is an engine pass that renders these and reads IDs back.
-     *
-     * The OPAQUE bit deliberately pulls in the transparent and additive OVERLAY
-     * effects too, so a cloaking hull stays pickable.
-     *
-     * @param {Object} batches - the picking accumulator
-     * @param {Number} pickTypes - a Tr2PickType mask
-     * @param {Object} perObjectData - this hull's per-object record
+    /**
+     * Carbon EveSpaceObject2::GetPickingBatches (cpp:3645-3675): collects the
+     * geometry a pick pass should test, by mask. It is ordinary batch collection
+     * - the pick itself is an engine pass that renders these and reads IDs back.
+     *
+     * The OPAQUE bit deliberately pulls in the transparent and additive OVERLAY
+     * effects too, so a cloaking hull stays pickable.
+     *
+     * @param {Object} batches - the picking accumulator
+     * @param {Number} pickTypes - a Tr2PickType mask
+     * @param {Object} perObjectData - this hull's per-object record
      */
     GetPickingBatches(batches, pickTypes = TR2_PICK_TYPE_DEFAULT, perObjectData = null) {
       if (pickTypes & Tr2PickType.PICK_TYPE_PICKING) {
@@ -1186,20 +1199,20 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Carbon EveSpaceObject2::GetID (cpp:3640-3643): a picked area resolves to
-     * the hull itself, so the area index is deliberately ignored.
-     * @param {Number} [_areaID] - the picked area, unused by this class
-     * @returns {EveSpaceObject2} this
+    /**
+     * Carbon EveSpaceObject2::GetID (cpp:3640-3643): a picked area resolves to
+     * the hull itself, so the area index is deliberately ignored.
+     * @param {Number} [_areaID] - the picked area, unused by this class
+     * @returns {EveSpaceObject2} this
      */
     GetID(_areaID = 0) {
       return this;
     }
 
-    /** Carbon GetShadowBatches (EveSpaceObject2.cpp:1143-1184): one batch per
-     * cached shared-material OPAQUE area block, using the area's own material.
-     * Carbon bakes LOD draw args at this point; doing the same is not ported, so
-     * they travel as a geometry source descriptor and shadowPixelSize goes unused
+    /** Carbon GetShadowBatches (EveSpaceObject2.cpp:1143-1184): one batch per
+     * cached shared-material OPAQUE area block, using the area's own material.
+     * Carbon bakes LOD draw args at this point; doing the same is not ported, so
+     * they travel as a geometry source descriptor and shadowPixelSize goes unused
      * until LOD selection is ported. */
     GetShadowBatches(batches, perObjectData, _shadowPixelSize) {
       if (!this.mesh || this.mesh.display === false) return false;
@@ -1222,10 +1235,10 @@ new class extends _identity {
       return committed;
     }
 
-    /** Carbon GetBatchesFromOverlayVector (EveSpaceObject2.cpp:1199-1285): the
-     * impact overlay's armor-damage shader draws over the TYPE_ALL blocks at
-     * maximum priority; each displayed overlay effect draws its per-batch-type
-     * effects over its overlay-type blocks (OPAQUE -> TYPE_OPAQUEONLY, everything
+    /** Carbon GetBatchesFromOverlayVector (EveSpaceObject2.cpp:1199-1285): the
+     * impact overlay's armor-damage shader draws over the TYPE_ALL blocks at
+     * maximum priority; each displayed overlay effect draws its per-batch-type
+     * effects over its overlay-type blocks (OPAQUE -> TYPE_OPAQUEONLY, everything
      * else -> TYPE_ALL). */
     GetBatchesFromOverlayVector(batches, perObjectData, batchType, mesh) {
       const impactEffect = this.impactOverlay?.GetArmorDamageShader?.(batchType) ?? null;
@@ -1270,10 +1283,10 @@ new class extends _identity {
       return (batches.GetBatchCount?.() ?? 0) > committedBefore;
     }
 
-    /**
-     * Builds and commits one render batch drawing a single cached area block with
-     * the given material and optional priority, skipping the block when the
-     * material yields no valid batch.
+    /**
+     * Builds and commits one render batch drawing a single cached area block with
+     * the given material and optional priority, skipping the block when the
+     * material yields no valid batch.
      */
     #CommitBlockBatch(batches, material, geometry, meshIndex, block, perObjectData, priority, lod, vertexDeclaration) {
       const batch = new Tr2RenderBatch();
@@ -1291,18 +1304,18 @@ new class extends _identity {
 
     // EveMeshOverlayEffect::GetEffects (display-gated, per batch type).
 
-    /**
-     * Returns an overlay effect's display-gated effect list for a batch type, or
-     * null when it contributes none.
+    /**
+     * Returns an overlay effect's display-gated effect list for a batch type, or
+     * null when it contributes none.
      */
     #OverlayEffectsFor(overlay, batchType) {
       return overlay?.GetEffects?.(batchType) ?? null;
     }
 
-    /**
-     * Reports whether the hull mesh has transparent areas or any overlay effect
-     * does, which tells the renderer to route this object through the sorted
-     * transparent pass.
+    /**
+     * Reports whether the hull mesh has transparent areas or any overlay effect
+     * does, which tells the renderer to route this object through the sorted
+     * transparent pass.
      */
     HasTransparentBatches() {
       if (!this.mesh) return false;
@@ -1313,9 +1326,9 @@ new class extends _identity {
       return false;
     }
 
-    /**
-     * Returns the distance from the render context's view position to the hull
-     * world translation, used to order transparent renderables back-to-front.
+    /**
+     * Returns the distance from the render context's view position to the hull
+     * world translation, used to order transparent renderables back-to-front.
      */
     GetSortValue(renderContext = null) {
       const viewPosition = renderContext?.GetViewPosition();
@@ -1325,9 +1338,9 @@ new class extends _identity {
       return Math.hypot(x, y, z);
     }
 
-    /** Carbon allocates Tr2PerObjectDataWithPersistentBuffers<EveSpaceObject2>.
-     * This port retains persistent VS/PS RawData and returns those records
-     * directly. GPU-derived bone-ring offsets remain at their CPU defaults until
+    /** Carbon allocates Tr2PerObjectDataWithPersistentBuffers<EveSpaceObject2>.
+     * This port retains persistent VS/PS RawData and returns those records
+     * directly. GPU-derived bone-ring offsets remain at their CPU defaults until
      * an engine supplies them; other CPU-known values are already encoded. */
     GetPerObjectData(_accumulator = null) {
       // Carbon cpp:1437-1445: the bone ring is uploaded and its OFFSETS stamped
@@ -1351,13 +1364,13 @@ new class extends _identity {
       return this.GetPerObjectData(accumulator);
     }
 
-    /** Carbon EveSpaceObject2::GetLights (cpp:3536-3555): display gate only
-     * (no lights-empty early-out, unlike EveChildMesh), then per light
-     * AddLight(manager, worldTransform, 1, bones, boneCount) FOLLOWED by
-     * SetBrightnessMultiplier(m_activationStrength) - the order is contract:
-     * the submission uses the multiplier stamped on the PREVIOUS pass (first
-     * pass uses the Tr2Light default 1) - one frame of activation-strength
-     * lag, preserved verbatim. cpp:3554's dead `DisplayChildren()` local is
+    /** Carbon EveSpaceObject2::GetLights (cpp:3536-3555): display gate only
+     * (no lights-empty early-out, unlike EveChildMesh), then per light
+     * AddLight(manager, worldTransform, 1, bones, boneCount) FOLLOWED by
+     * SetBrightnessMultiplier(m_activationStrength) - the order is contract:
+     * the submission uses the multiplier stamped on the PREVIOUS pass (first
+     * pass uses the Tr2Light default 1) - one frame of activation-strength
+     * lag, preserved verbatim. cpp:3554's dead `DisplayChildren()` local is
      * not ported. */
     GetLights(lightManager) {
       if (!this.display) {
@@ -1376,11 +1389,11 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Carbon EveSpaceObject2::IsCastingShadow (cpp:2252-2274): applies the
-     * display, world-sphere and reflection gates, then tests the realized sphere
-     * against the supplied shadow frustum. Carbon's float& result is represented
-     * by an optional length-one array.
+    /**
+     * Carbon EveSpaceObject2::IsCastingShadow (cpp:2252-2274): applies the
+     * display, world-sphere and reflection gates, then tests the realized sphere
+     * against the supplied shadow frustum. Carbon's float& result is represented
+     * by an optional length-one array.
      */
     IsCastingShadow(cameraFrustum, shadowFrustum, renderReason, sizeInShadowOut = null) {
       if (!this.display || this.#boundingSphereWorldRadius <= 0) {
@@ -1403,9 +1416,9 @@ new class extends _identity {
       return sizeInShadow > 15;
     }
 
-    /** Carbon EveSpaceObject2::RegisterComponents (cpp:3568-3609): registers its
-     * own components and its children with the scene registration container "so
-     * we don't have to traverse the tree every frame". RegisterAudioGeometry
+    /** Carbon EveSpaceObject2::RegisterComponents (cpp:3568-3609): registers its
+     * own components and its children with the scene registration container "so
+     * we don't have to traverse the tree every frame". RegisterAudioGeometry
      * (cpp:3572-3575) is audio-engine-owned and unported. Gate m_display. */
     RegisterComponents() {
       const registry = this.GetComponentRegistry();
@@ -1428,10 +1441,10 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveSpaceObject2::UnRegisterComponents (cpp:3615-3638): forwards
-     * the un-registration to the children only - EveEntity::UnRegister already
-     * called UnRegisterAllComponents(this) first (EveEntity.cpp:90) - and does
-     * not re-check display. UnregisterAudioGeometry (cpp:3617) is
+    /** Carbon EveSpaceObject2::UnRegisterComponents (cpp:3615-3638): forwards
+     * the un-registration to the children only - EveEntity::UnRegister already
+     * called UnRegisterAllComponents(this) first (EveEntity.cpp:90) - and does
+     * not re-check display. UnregisterAudioGeometry (cpp:3617) is
      * audio-engine-owned and unported. */
     UnRegisterComponents() {
       const registry = this.GetComponentRegistry();
@@ -1445,25 +1458,25 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Reports whether children and effect children should be shown; always true on
-     * the base hull, subclasses gate it on activation state.
+    /**
+     * Reports whether children and effect children should be shown; always true on
+     * the base hull, subclasses gate it on activation state.
      */
     DisplayChildren() {
       return true;
     }
 
-    /**
-     * Returns the transform placement observers are attached to - the live hull
-     * world transform.
+    /**
+     * Returns the transform placement observers are attached to - the live hull
+     * world transform.
      */
     GetObserverTransform() {
       return this.worldTransform;
     }
 
-    /**
-     * Returns the transform effect children are placed against - the live hull
-     * world transform, not a copy.
+    /**
+     * Returns the transform effect children are placed against - the live hull
+     * world transform, not a copy.
      */
     GetLocalToWorldTransform() {
       return this.worldTransform;
@@ -1474,26 +1487,26 @@ new class extends _identity {
       vec3.transformMat4(out, this.boundingSphereCenter, this.worldTransform);
     }
 
-    /**
-     * Returns the live curve-sampled ball position; the array is the object's own
-     * field and is rewritten by the next transform update.
+    /**
+     * Returns the live curve-sampled ball position; the array is the object's own
+     * field and is rewritten by the next transform update.
      */
     GetWorldPosition() {
       return this.worldPosition;
     }
 
-    /**
-     * Returns the live curve-sampled ball rotation, which excludes the model
-     * rotation curve; the quaternion is the object's own field and is rewritten by
-     * the next transform update.
+    /**
+     * Returns the live curve-sampled ball rotation, which excludes the model
+     * rotation curve; the quaternion is the object's own field and is rewritten by
+     * the next transform update.
      */
     GetWorldRotation() {
       return this.worldRotation;
     }
 
-    /**
-     * Finds a sound emitter by observer name on this hull and then recursively in
-     * the effect children, returning null when no emitter carries the name.
+    /**
+     * Finds a sound emitter by observer name on this hull and then recursively in
+     * the effect children, returning null when no emitter carries the name.
      */
     FindSoundEmitter(name) {
       const target = String(name ?? "");
@@ -1511,9 +1524,9 @@ new class extends _identity {
       return null;
     }
 
-    /**
-     * Sets the mute flag and pushes it to every effect child and placement
-     * observer.
+    /**
+     * Sets the mute flag and pushes it to every effect child and placement
+     * observer.
      */
     SetMute(mute) {
       this.mute = !!mute;
@@ -1525,19 +1538,19 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Plays an animation with explicit loop, start, and speed settings
-     * (Carbon PlayAnimationEx, MAP_METHOD_AND_WRAP_OPTIONAL_ARGS).
+    /**
+     * Plays an animation with explicit loop, start, and speed settings
+     * (Carbon PlayAnimationEx, MAP_METHOD_AND_WRAP_OPTIONAL_ARGS).
      */
     PlayAnimationEx(animName, loopCount, start, speed, clearWhenDone = true) {
       this.#PlayAnimation(animName, true, loopCount, start, speed, clearWhenDone);
     }
 
-    /**
-     * Calculates the skinned bounding box under a transform (CMF path: the
-     * local box corners transformed with perspective divide). The granny path
-     * is unported. Returns an inverted-empty { min, max } box when dynamic
-     * bounds are disabled, as Carbon's BoundingBoxInitialize does.
+    /**
+     * Calculates the skinned bounding box under a transform (CMF path: the
+     * local box corners transformed with perspective divide). The granny path
+     * is unported. Returns an inverted-empty { min, max } box when dynamic
+     * bounds are disabled, as Carbon's BoundingBoxInitialize does.
      */
     CalculateSkinnedBoundingBoxFromTransform(transform) {
       const min = vec3.fromValues(Infinity, Infinity, Infinity);
@@ -1561,10 +1574,10 @@ new class extends _identity {
       };
     }
 
-    /**
-     * Calculates the skinned bounding sphere (CMF path: the current bounding
-     * sphere; granny path unported). Returns (0,0,0,-1) when dynamic bounds
-     * are disabled.
+    /**
+     * Calculates the skinned bounding sphere (CMF path: the current bounding
+     * sphere; granny path unported). Returns (0,0,0,-1) when dynamic bounds
+     * are disabled.
      */
     CalculateSkinnedBoundingSphere(out = vec4.create()) {
       if (this.dynamicBoundingSphereEnabled && this.mesh?.GetGeometryResource()?.IsUsingCMF?.()) {
@@ -1583,9 +1596,9 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Rebuilds the locator sets visible on this object from its own authored sets
-     * plus the sets owned by child meshes and nested child containers.
+    /**
+     * Rebuilds the locator sets visible on this object from its own authored sets
+     * plus the sets owned by child meshes and nested child containers.
      */
     EnsureChildLocatorMerged() {
       if (!this.#mergedLocatorSetsDirty) return;
@@ -1628,10 +1641,12 @@ new class extends _identity {
         if (sourceSet.HasName(_EveSpaceObject.#damageLocatorSetName)) {
           this.#mergedDamageLocatorSources.push({
             owner: source.owner,
-            partTag: source.owner.GetPartTag(),
+            // The SOURCE's tag, not the owner's (Carbon EveSpaceObject2.cpp:1941):
+            // one shared instanced child owns many parts' sets.
+            partTag: source.partTag,
             start,
             count: sourceSet.GetLocators().length,
-            // Carbon LocatorSourceRange.childToObject (EveSpaceObject2.cpp:1938):
+            // Carbon LocatorSourceRange.childToObject (EveSpaceObject2.cpp:1944):
             // lets GetLocatorInObjectSpace pose merged damage locators against
             // the owning child's skeleton, then lift them into object space.
             childToObject: source.childToObject
@@ -1649,11 +1664,11 @@ new class extends _identity {
       this.#damageFilterAreas.length = 0;
     }
 
-    /**
-     * Collects prepared hull and child geometry and opens raycast sessions
-     * (Carbon CollectOccluders, EveSpaceObject2.cpp:1960-2028): occluders carry
-     * areaStart/areaCount ranges into the shared #damageFilterAreas pool, and
-     * records with no matching areas are skipped rather than raycast whole.
+    /**
+     * Collects prepared hull and child geometry and opens raycast sessions
+     * (Carbon CollectOccluders, EveSpaceObject2.cpp:1960-2028): occluders carry
+     * areaStart/areaCount ranges into the shared #damageFilterAreas pool, and
+     * records with no matching areas are skipped rather than raycast whole.
      */
     #CollectDamageFilterOccluders() {
       this.#damageFilterOccluders.length = 0;
@@ -1800,35 +1815,35 @@ new class extends _identity {
       if (this.#damageFilterState === 0) this.#damageFilterState = 1;
     }
 
-    /**
-     * Clears all impact and damage effects on the impact overlay.
+    /**
+     * Clears all impact and damage effects on the impact overlay.
      */
     ClearImpactDamage() {
       if (this.impactOverlay) this.impactOverlay.Clear();
       this.EnsureChildLocatorMerged();
       for (const range of this.#mergedDamageLocatorSources) {
-        const overlay = range.owner.GetDamageOverlay();
+        const overlay = range.owner.GetPartDamageOverlay(range.partTag);
         if (overlay) overlay.Clear();
       }
     }
 
-    /**
-     * Clears all animations on the animation updater.
+    /**
+     * Clears all animations on the animation updater.
      */
     ClearAnimations() {
       this.animationUpdater?.ClearAnimations?.();
     }
 
-    /**
-     * Creates an impact facing a position on the closest facing damage locator.
+    /**
+     * Creates an impact facing a position on the closest facing damage locator.
      */
     CreateImpactFromPosition(position, direction, lifeTime, size) {
       const closestDamageLocator = this.#GetClosestLocatorIndex(position, _EveSpaceObject.#damageLocatorSetName);
       return this.CreateImpact(closestDamageLocator, direction, lifeTime, size);
     }
 
-    /**
-     * Creates an impact effect on a damage locator through the impact overlay.
+    /**
+     * Creates an impact effect on a damage locator through the impact overlay.
      */
     CreateImpact(damageLocatorIndex, direction, lifeTime, size) {
       if (this.impactOverlay) {
@@ -1837,7 +1852,10 @@ new class extends _identity {
           this.EnsureChildLocatorMerged();
           for (const range of this.#mergedDamageLocatorSources) {
             if (damageLocatorIndex < range.start || damageLocatorIndex >= range.start + range.count) continue;
-            return this.#EnsureChildDamageOverlay(range).CreateImpact(damageLocatorIndex - range.start, size, false);
+            // Carbon EveSpaceObject2.cpp:3644-3651: parts honour the impact
+            // switch here, and spawn debris except at low LOD.
+            if (!_EveDamageOverlay.impactEffectEnabled) return -1;
+            return this.#EnsureChildDamageOverlay(range).CreateImpact(damageLocatorIndex - range.start, size, this.lodLevel !== Tr2Lod.TR2_LOD_LOW);
           }
         }
         return this.impactOverlay.CreateImpact(damageLocatorIndex, direction, lifeTime, size, 1, this.lodLevel, this);
@@ -1845,16 +1863,16 @@ new class extends _identity {
       return -1;
     }
 
-    /**
-     * Ends the current animation on the animation updater.
+    /**
+     * Ends the current animation on the animation updater.
      */
     EndAnimation() {
       this.animationUpdater?.EndAnimation?.();
     }
 
-    /**
-     * Freezes LOD selection at the current mesh and marks decal geometry
-     * frozen.
+    /**
+     * Freezes LOD selection at the current mesh and marks decal geometry
+     * frozen.
      */
     FreezeHighDetailMesh() {
       this.#allowLodSelection = false;
@@ -1863,23 +1881,23 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Gets the number of damage locators on this object.
+    /**
+     * Gets the number of damage locators on this object.
      */
     GetDamageLocatorCount() {
       return this.GetLocatorCount(_EveSpaceObject.#damageLocatorSetName);
     }
 
-    /**
-     * Gets the number of locators in a named locator set.
+    /**
+     * Gets the number of locators in a named locator set.
      */
     GetLocatorCount(locatorSetName) {
       return this.#GetLocatorsForSet(locatorSetName)?.length ?? 0;
     }
 
-    /**
-     * Gets the first locator list whose set has the requested Carbon name.
-     * The returned list remains owned by the locator set.
+    /**
+     * Gets the first locator list whose set has the requested Carbon name.
+     * The returned list remains owned by the locator set.
      */
     GetLocatorsForSet(locatorSetName) {
       return this.#GetLocatorsForSet(locatorSetName);
@@ -1913,9 +1931,9 @@ new class extends _identity {
       this.InvalidateMergedLocators("structure");
     }
 
-    /**
-     * Gets the closest locator in a set to a world position, ignoring locator
-     * facing. Returns -1 when the set is missing or empty.
+    /**
+     * Gets the closest locator in a set to a world position, ignoring locator
+     * facing. Returns -1 when the set is missing or empty.
      */
     GetCloseLocatorIndex(position, locatorSetName) {
       const locators = this.#GetLocatorsForSet(locatorSetName);
@@ -1939,19 +1957,19 @@ new class extends _identity {
       return closestIndex;
     }
 
-    /**
-     * Carbon's script surface maps GetGoodLocatorIndex to GetCloseLocatorIndex
-     * (EveSpaceObject2_Blue.cpp); the internal randomized fit heuristic is not
-     * script-exposed.
+    /**
+     * Carbon's script surface maps GetGoodLocatorIndex to GetCloseLocatorIndex
+     * (EveSpaceObject2_Blue.cpp); the internal randomized fit heuristic is not
+     * script-exposed.
      */
     GetGoodLocatorIndex(position, locatorSetName) {
       return this.GetCloseLocatorIndex(position, locatorSetName);
     }
 
-    /**
-     * Gets the local direction of an indexed damage locator, (0,0,0) for
-     * indices out of range (Carbon script GetDamageLocatorDirection maps to
-     * GetDamageLocatorDirectionLocal).
+    /**
+     * Gets the local direction of an indexed damage locator, (0,0,0) for
+     * indices out of range (Carbon script GetDamageLocatorDirection maps to
+     * GetDamageLocatorDirectionLocal).
      */
     GetDamageLocatorDirection(index, inWorldSpaceOrOut = vec3.create(), out = vec3.create()) {
       const targetableCall = typeof inWorldSpaceOrOut === "boolean";
@@ -1980,10 +1998,10 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Gets a damage locator's BIND position in object space - the merged set's
-     * authored position, no animation (Carbon EveSpaceObject2.cpp:2785-2796).
-     * Impact overlays seed decals here so they stay put on animated parts.
+    /**
+     * Gets a damage locator's BIND position in object space - the merged set's
+     * authored position, no animation (Carbon EveSpaceObject2.cpp:2785-2796).
+     * Impact overlays seed decals here so they stay put on animated parts.
      */
     GetDamageLocatorBindPosition(index, out = vec3.create()) {
       const locators = this.#GetLocatorsForSet(_EveSpaceObject.#damageLocatorSetName);
@@ -2118,15 +2136,15 @@ new class extends _identity {
       if (this.impactOverlay.UpdateImpact(out, direction, impactIndex)) return true;
       this.EnsureChildLocatorMerged();
       for (const range of this.#mergedDamageLocatorSources) {
-        const overlay = range.owner.GetDamageOverlay();
+        const overlay = range.owner.GetPartDamageOverlay(range.partTag);
         if (overlay && overlay.HasImpact(impactIndex)) return true;
       }
       return false;
     }
 
-    /**
-     * Gets the local position of an indexed damage locator, (0,0,0) for
-     * indices out of range.
+    /**
+     * Gets the local position of an indexed damage locator, (0,0,0) for
+     * indices out of range.
      */
     GetDamageLocator(index, out = vec3.create()) {
       const locators = this.#GetLocatorsForSet(_EveSpaceObject.#damageLocatorSetName);
@@ -2138,9 +2156,9 @@ new class extends _identity {
       return out;
     }
 
-    /**
-     * Gets the world-space position of an indexed damage locator, (0,0,0) for
-     * indices out of range (returned untransformed, as Carbon does).
+    /**
+     * Gets the world-space position of an indexed damage locator, (0,0,0) for
+     * indices out of range (returned untransformed, as Carbon does).
      */
     GetTransformedDamageLocator(index, out = vec3.create()) {
       const locators = this.#GetLocatorsForSet(_EveSpaceObject.#damageLocatorSetName);
@@ -2152,18 +2170,18 @@ new class extends _identity {
       return vec3.transformMat4(out, out, this.worldTransform);
     }
 
-    /**
-     * Checks whether this object is in impostor mode. The impostor system that
-     * raises the flag is unported, so this reports the default until then.
+    /**
+     * Checks whether this object is in impostor mode. The impostor system that
+     * raises the flag is unported, so this reports the default until then.
      */
     IsImpostor() {
       return this.#impostorMode;
     }
 
-    /**
-     * Gets a locator position from a named set. Out-of-range or missing-set
-     * queries return the world translation in world space and (0,0,0) in
-     * object space, as Carbon does.
+    /**
+     * Gets a locator position from a named set. Out-of-range or missing-set
+     * queries return the world translation in world space and (0,0,0) in
+     * object space, as Carbon does.
      */
     GetLocatorPositionFromSet(index, inWorldSpace, locatorSetName, out = vec3.create()) {
       const locators = this.#GetLocatorsForSet(locatorSetName);
@@ -2181,9 +2199,9 @@ new class extends _identity {
       return out;
     }
 
-    /**
-     * Gets a locator direction from a named set. Out-of-range or missing-set
-     * queries return (0,1,0), as Carbon does.
+    /**
+     * Gets a locator direction from a named set. Out-of-range or missing-set
+     * queries return (0,1,0), as Carbon does.
      */
     GetLocatorRotationFromSet(index, inWorldSpace, locatorSetName, out = vec3.create()) {
       const locators = this.#GetLocatorsForSet(locatorSetName);
@@ -2198,9 +2216,9 @@ new class extends _identity {
       return out;
     }
 
-    /**
-     * Raises a named controller event on this hull's controllers and forwards it
-     * to the effect children and overlay effects.
+    /**
+     * Raises a named controller event on this hull's controllers and forwards it
+     * to the effect children and overlay effects.
      */
     HandleControllerEvent(name) {
       const eventName = String(name ?? "");
@@ -2215,24 +2233,24 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Plays an animation once, replacing the current one
-     * (Carbon script PlayAnimation maps to PlayAnimationOnce).
+    /**
+     * Plays an animation once, replacing the current one
+     * (Carbon script PlayAnimation maps to PlayAnimationOnce).
      */
     PlayAnimation(animName) {
       this.#PlayAnimation(animName, true, 1, 0, 1, true);
     }
 
-    /**
-     * Chains an animation once after the current one (Carbon ChainAnimation).
+    /**
+     * Chains an animation once after the current one (Carbon ChainAnimation).
      */
     ChainAnimation(animName) {
       this.#PlayAnimation(animName, false, 1, 0, 1, true);
     }
 
-    /**
-     * Chains an animation with explicit loop, start, and speed settings
-     * (Carbon ChainAnimationEx).
+    /**
+     * Chains an animation with explicit loop, start, and speed settings
+     * (Carbon ChainAnimationEx).
      */
     ChainAnimationEx(animName, loopCount, start, speed) {
       this.#PlayAnimation(animName, false, loopCount, start, speed, true);
@@ -2242,17 +2260,17 @@ new class extends _identity {
     // into the animation updater, which owns playback state; a missing updater
     // is a Carbon-faithful no-op.
 
-    /**
-     * Forwards a playback request to the animation updater, which owns all
-     * animation state; a hull without an updater does nothing, as in Carbon.
+    /**
+     * Forwards a playback request to the animation updater, which owns all
+     * animation state; a hull without an updater does nothing, as in Carbon.
      */
     #PlayAnimation(animName, replace, loopCount, delay, speed, clearWhenDone) {
       this.animationUpdater?.PlayAnimation?.(String(animName ?? ""), replace, loopCount, delay, speed, clearWhenDone);
     }
 
-    /**
-     * Recalculates the authored bounding sphere from the mesh geometry
-     * resource. Fails when no mesh or ready geometry resource is attached.
+    /**
+     * Recalculates the authored bounding sphere from the mesh geometry
+     * resource. Fails when no mesh or ready geometry resource is attached.
      */
     RebuildBoundingSphereInformation() {
       const mesh = this.mesh;
@@ -2282,9 +2300,9 @@ new class extends _identity {
       return this;
     }
 
-    /**
-     * Returns a plain-object snapshot of the controller variables currently
-     * stamped on this hull.
+    /**
+     * Returns a plain-object snapshot of the controller variables currently
+     * stamped on this hull.
      */
     GetControllerVariables() {
       return Object.fromEntries(this.#controllerVariables);
@@ -2298,11 +2316,11 @@ new class extends _identity {
       return geometryResource.GetLodIndexForScreenSize?.(this.mesh?.GetMeshIndex?.() ?? 0, this.#meshScreenSize) ?? 0;
     }
 
-    /**
-     * Gets a named locator's transform (Carbon script GetLocatorTransform maps
-     * to GetEveLocatorTransform): the identity for unknown names, the animated
-     * bone world transform when the animation updater resolves the name, else
-     * the authored locator transform.
+    /**
+     * Gets a named locator's transform (Carbon script GetLocatorTransform maps
+     * to GetEveLocatorTransform): the identity for unknown names, the animated
+     * bone world transform when the animation updater resolves the name, else
+     * the authored locator transform.
      */
     GetLocatorTransform(name, out = mat4.create()) {
       const target = String(name ?? "");
@@ -2322,11 +2340,11 @@ new class extends _identity {
       return mat4.copy(out, locator.GetTransform());
     }
 
-    /**
-     * Gets the local axis-aligned bounding box: dynamic skinned bounds when
-     * enabled, else the mesh box, else the cached box (at worst it lags one
-     * frame). With out arguments it fills them and returns true; without, it
-     * returns { min, max }.
+    /**
+     * Gets the local axis-aligned bounding box: dynamic skinned bounds when
+     * enabled, else the mesh box, else the cached box (at worst it lags one
+     * frame). With out arguments it fills them and returns true; without, it
+     * returns { min, max }.
      */
     GetLocalBoundingBox(minBounds, maxBounds) {
       const min = vec3.create();
@@ -2376,9 +2394,9 @@ new class extends _identity {
       return geometryResource ? geometryResource.IsGood() : false;
     }
 
-    /**
-     * Gets Carbon's realized world sphere, optionally accumulated with transform
-     * and effect children when query is EVE_BOUNDS_WITH_CHILDREN.
+    /**
+     * Gets Carbon's realized world sphere, optionally accumulated with transform
+     * and effect children when query is EVE_BOUNDS_WITH_CHILDREN.
      */
     GetBoundingSphere(out = sph3.create(), query = 0) {
       if (this.boundingSphereRadius <= 0 && this.#dynamicBoundingSphere[3] <= 0) return false;
@@ -2414,9 +2432,9 @@ new class extends _identity {
       return this.#isInFrustum;
     }
 
-    /**
-     * Gets the bounding sphere center, preferring the dynamic skinned sphere
-     * when one is published.
+    /**
+     * Gets the bounding sphere center, preferring the dynamic skinned sphere
+     * when one is published.
      */
     GetBoundingSphereCenter(out = vec3.create()) {
       if (this.#dynamicBoundingSphere[3] !== -1) {
@@ -2425,9 +2443,9 @@ new class extends _identity {
       return vec3.copy(out, this.boundingSphereCenter);
     }
 
-    /**
-     * Gets the model-scaled bounding sphere radius, preferring the dynamic
-     * skinned sphere when one is published.
+    /**
+     * Gets the model-scaled bounding sphere radius, preferring the dynamic
+     * skinned sphere when one is published.
      */
     GetBoundingSphereRadius() {
       if (this.#dynamicBoundingSphere[3] !== -1) {
@@ -2436,9 +2454,9 @@ new class extends _identity {
       return this.modelScale * this.boundingSphereRadius;
     }
 
-    /**
-     * Gets the number of mesh-bound bones. Carbon dereferences the animation
-     * updater unchecked; CarbonEngineJS reports 0 when none is attached.
+    /**
+     * Gets the number of mesh-bound bones. Carbon dereferences the animation
+     * updater unchecked; CarbonEngineJS reports 0 when none is attached.
      */
     GetBoneCount() {
       const updater = this.animationUpdater;
@@ -2454,10 +2472,10 @@ new class extends _identity {
       return updater.GetMeshBindingBoneCount?.() ?? 0;
     }
 
-    /**
-     * Pushes shield, armor and hull damage levels to the impact overlay and
-     * mirrors them into the ShieldDamage, ArmorDamage and HullDamage controller
-     * variables so bound effects follow.
+    /**
+     * Pushes shield, armor and hull damage levels to the impact overlay and
+     * mirrors them into the ShieldDamage, ArmorDamage and HullDamage controller
+     * variables so bound effects follow.
      */
     SetImpactDamageState(shield, armor, hull, doCreateArmorImpacts = true) {
       if (this.impactOverlay) {
@@ -2473,8 +2491,8 @@ new class extends _identity {
       this.SetControllerVariable("HullDamage", hull);
     }
 
-    /**
-     * Toggles a named impact-overlay animation (boosters, hardeners, ...).
+    /**
+     * Toggles a named impact-overlay animation (boosters, hardeners, ...).
      */
     SetImpactAnimation(name, enable, duration) {
       if (!this.impactOverlay) return;
@@ -2488,17 +2506,19 @@ new class extends _identity {
 
     /** Creates and synchronizes the damage overlay owned by one child-locator range. */
     #EnsureChildDamageOverlay(range) {
-      let overlay = range.owner.GetDamageOverlay();
+      let overlay = range.owner.GetPartDamageOverlay(range.partTag);
       if (!overlay) {
-        overlay = range.owner.EnsureDamageOverlay();
+        // Carbon EveSpaceObject2.cpp:3529-3555: the child creates the part's
+        // overlay, then it is fetched back by the same part tag.
+        range.owner.CreatePartDamageOverlay(range.partTag);
+        overlay = range.owner.GetPartDamageOverlay(range.partTag);
         const shipDamage = this.impactOverlay.GetDamageOverlay();
-        // The part's OWN armour shader (Carbon EveSpaceObject2.cpp:3529, commit
-        // 6975d9f1): an animated part needs the skinned variant, which the
-        // ship-wide effect is not.
-        overlay.SetArmorDamageShaderEffect(range.owner.GetArmorDamageShaderEffect());
+        // The part's OWN armour shader (commit 6975d9f1): an animated part
+        // needs the skinned variant, which the ship-wide effect is not.
+        overlay.SetArmorDamageShaderEffect(range.owner.GetPartArmorDamageShaderEffect(range.partTag));
         const flicker = shipDamage.GetHullDamageFlickerCurve();
         if (flicker) overlay.SetHullDamageFlickerCurve(_TriPerlinCurve.from(flicker.GetValues()));
-        overlay.SetSeed(shipDamage.GetSeed() + range.owner.GetPartTag());
+        overlay.SetSeed(shipDamage.GetSeed() + range.partTag);
       }
       overlay.SetDamageLocatorCount(range.count);
       overlay.SetEnabledDamageLocators(this.#damageLocatorEnabled.slice(range.start, range.start + range.count));
@@ -2506,10 +2526,25 @@ new class extends _identity {
       return overlay;
     }
 
-    /**
-     * Stores a controller variable on the hull and pushes it to the controllers,
-     * effect children and overlay effects; the stored value is replayed onto
-     * controllers and children added later.
+    /**
+     * Appends every part's existing damage overlay with its range start in the
+     * merged damage locator set, as [overlay, start] pairs (Carbon
+     * EveSpaceObject2.cpp:3561-3574).
+     */
+    CollectPartDamageOverlays(out = []) {
+      this.EnsureChildLocatorMerged();
+      for (const range of this.#mergedDamageLocatorSources) {
+        if (!range.owner) continue;
+        const overlay = range.owner.GetPartDamageOverlay(range.partTag);
+        if (overlay) out.push([overlay, range.start]);
+      }
+      return out;
+    }
+
+    /**
+     * Stores a controller variable on the hull and pushes it to the controllers,
+     * effect children and overlay effects; the stored value is replayed onto
+     * controllers and children added later.
      */
     SetControllerVariable(name, value) {
       const key = String(name ?? "");
@@ -2526,9 +2561,9 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Forwards a procedural-container variable to every effect child; the hull
-     * itself keeps no copy.
+    /**
+     * Forwards a procedural-container variable to every effect child; the hull
+     * itself keeps no copy.
      */
     SetProceduralContainerVariable(name, value) {
       for (const child of this.effectChildren) {
@@ -2536,9 +2571,9 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Starts this hull's controllers and those of its effect children and overlay
-     * effects.
+    /**
+     * Starts this hull's controllers and those of its effect children and overlay
+     * effects.
      */
     StartControllers() {
       for (const controller of this.controllers) {
@@ -2552,13 +2587,13 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Applies bone and model transforms to locators and returns
-     * [position, rotation, boneIndex] tuples, as the Carbon script surface
-     * does (TransformLocators maps to PyTransformLocators). Accepts either
-     * locator records ({ position, direction, boneIndex }, Carbon's
-     * LocatorStructureList shape) or the same [position, rotation, boneIndex]
-     * tuple shape it returns.
+    /**
+     * Applies bone and model transforms to locators and returns
+     * [position, rotation, boneIndex] tuples, as the Carbon script surface
+     * does (TransformLocators maps to PyTransformLocators). Accepts either
+     * locator records ({ position, direction, boneIndex }, Carbon's
+     * LocatorStructureList shape) or the same [position, rotation, boneIndex]
+     * tuple shape it returns.
      */
     TransformLocators(locators = []) {
       const result = [];
@@ -2584,13 +2619,33 @@ new class extends _identity {
       return result;
     }
 
+    /**
+     * Returns the named set's locators - including those merged in from parts -
+     * posed by the current bones and model curves, as [position, rotation,
+     * boneIndex] tuples (Carbon script GetTransformedLocatorsFromSet maps to
+     * PyGetTransformedLocatorsFromSet, EveSpaceObject2_Blue.cpp:146-181).
+     */
+    GetTransformedLocatorsFromSet(locatorSetName) {
+      const result = [];
+      for (const locator of this.GetLocatorsForSet(locatorSetName) ?? []) {
+        const position = vec3.clone(locator.position);
+        const rotation = quat.clone(locator.direction);
+        this.#TransformLocator(position, rotation, locator.boneIndex);
+        if (this.modelTranslationCurve || this.modelRotationCurve) {
+          this.#ApplyModelTransform(position, rotation);
+        }
+        result.push([position, rotation, locator.boneIndex]);
+      }
+      return result;
+    }
+
     // Carbon Blue TransformLocator: bone-attached records pick up the mesh
     // bone matrix; without bone data the authored values pass through.
 
-    /**
-     * Applies the mesh bone matrix to a locator position and rotation for
-     * bone-attached locators; the authored values pass through unchanged when
-     * there is no usable bone data.
+    /**
+     * Applies the mesh bone matrix to a locator position and rotation for
+     * bone-attached locators; the authored values pass through unchanged when
+     * there is no usable bone data.
      */
     #TransformLocator(position, rotation, boneIndex) {
       const updater = this.animationUpdater;
@@ -2610,10 +2665,10 @@ new class extends _identity {
     // origin (pure GetValueAt, no playback advance): translation adds, model
     // rotation rotates the position and pre-multiplies.
 
-    /**
-     * Applies the model translation and rotation curves sampled at time 0 to a
-     * locator position and rotation, matching Carbon's Blue locator surface, which
-     * reads the curves without advancing playback.
+    /**
+     * Applies the model translation and rotation curves sampled at time 0 to a
+     * locator position and rotation, matching Carbon's Blue locator surface, which
+     * reads the curves without advancing playback.
      */
     #ApplyModelTransform(position, rotation) {
       if (this.modelTranslationCurve) {
@@ -2631,9 +2686,9 @@ new class extends _identity {
 
     // Carbon GetLocatorsForSet: first set matching the name wins.
 
-    /**
-     * Returns the locator list of the first locator set carrying the name, or null
-     * when no set matches; the list stays owned by the locator set.
+    /**
+     * Returns the locator list of the first locator set carrying the name, or null
+     * when no set matches; the list stays owned by the locator set.
      */
     #GetLocatorsForSet(locatorSetName) {
       const target = String(locatorSetName ?? "");
@@ -2646,26 +2701,26 @@ new class extends _identity {
       return null;
     }
 
-    /**
-     * Writes a locator's object-space position and direction (Carbon
-     * EveSpaceObject2.cpp:3751-3772, rewritten upstream by 3d988b1d).
-     *
-     * A merged damage locator (mergedDamageIndex >= 0, indexing the merged
-     * damage set) delegates to the owning child's animated pose - the locator's
-     * boneIndex addresses the CHILD's skeleton, never this object's - then
-     * lifts the result through the range's childToObject transform; Carbon
-     * normalizes the direction HERE but not in EveGetLocatorPose, and that
-     * asymmetry is preserved. Every other locator resolves against this
-     * object's own animation updater.
-     *
-     * Overridable on purpose: Carbon's EveSwarm overrides this.
+    /**
+     * Writes a locator's object-space position and direction (Carbon
+     * EveSpaceObject2.cpp:3784-3805, rewritten upstream by 3d988b1d).
+     *
+     * A merged damage locator (mergedDamageIndex >= 0, indexing the merged
+     * damage set) delegates to the owning child's animated pose - the locator's
+     * boneIndex addresses the CHILD's skeleton, never this object's - then
+     * lifts the result through the range's childToObject transform; Carbon
+     * normalizes the direction HERE but not in EveGetLocatorPose, and that
+     * asymmetry is preserved. Every other locator resolves against this
+     * object's own animation updater.
+     *
+     * Overridable on purpose: Carbon's EveSwarm overrides this.
      */
     GetLocatorInObjectSpace(outPosition, outDirection, locator, mergedDamageIndex = -1) {
       if (mergedDamageIndex >= 0) {
         this.EnsureChildLocatorMerged();
         for (const range of this.#mergedDamageLocatorSources) {
           if (range.owner && mergedDamageIndex >= range.start && mergedDamageIndex < range.start + range.count) {
-            if (range.owner.GetDamageLocatorAnimatedLocal(mergedDamageIndex - range.start, outPosition, outDirection)) {
+            if (range.owner.GetPartDamageLocatorAnimatedLocal(range.partTag, mergedDamageIndex - range.start, outPosition, outDirection)) {
               vec3.transformMat4(outPosition, outPosition, range.childToObject);
               _EveSpaceObject.#TransformNormal(outDirection, outDirection, range.childToObject);
               vec3.normalize(outDirection, outDirection);
@@ -2681,10 +2736,10 @@ new class extends _identity {
     // Carbon GetClosestLocatorIndex: facing-gated closest search; 0 when the
     // set is missing, -1 when no locator faces the position.
 
-    /**
-     * Returns the index of the nearest locator in a named set that faces the given
-     * world position - 0 when the set is missing, -1 when no locator faces the
-     * position.
+    /**
+     * Returns the index of the nearest locator in a named set that faces the given
+     * world position - 0 when the set is missing, -1 when no locator faces the
+     * position.
      */
     #GetClosestLocatorIndex(position, locatorSetName) {
       const locators = this.#GetLocatorsForSet(locatorSetName);
@@ -2711,9 +2766,9 @@ new class extends _identity {
       return closestIndex;
     }
 
-    /**
-     * Reports whether a locator faces a position, by testing that stepping the
-     * object-space position back along the locator direction shortens it.
+    /**
+     * Reports whether a locator faces a position, by testing that stepping the
+     * object-space position back along the locator direction shortens it.
      */
 
     /** Rotates a direction by a matrix's rotation basis, ignoring its translation. */
@@ -2737,15 +2792,15 @@ new class extends _identity {
       vec3.copy(this.generatedShapeEllipsoidRadius, outRadii);
     }
 
-    /**
-     * Maps the negated dot product of a locator direction and an offset direction
-     * onto Carbon's square-root fit score, the ranking used to pick a varied
-     * damage locator.
+    /**
+     * Maps the negated dot product of a locator direction and an offset direction
+     * onto Carbon's square-root fit score, the ranking used to pick a varied
+     * damage locator.
      */
 
-    /**
-     * Intersects a ray with an axis-aligned ellipsoid in the ellipsoid's own space and writes the hit point into out.
-     * @returns {number|null} The ray parameter at the hit, or null when the ray is degenerate or misses.
+    /**
+     * Intersects a ray with an axis-aligned ellipsoid in the ellipsoid's own space and writes the hit point into out.
+     * @returns {number|null} The ray parameter at the hit, or null when the ray is degenerate or misses.
      */
 
     /** Reports whether a point lies inside an axis-aligned ellipsoid. */
@@ -2753,42 +2808,42 @@ new class extends _identity {
     // Mesh bone matrices come from the animation updater; only mat4-shaped
     // entries are usable.
 
-    /**
-     * Unpacks one bone from the updater's palette into a mat4, or null when the
-     * index is out of range.
-     *
-     * The palette is Carbon's storage - one contiguous Float4x3 buffer, stride
-     * 12 - so a bone is expanded rather than borrowed. Carbon does the same at
-     * every read site with TriMatrixCopyFrom3x4.
+    /**
+     * Unpacks one bone from the updater's palette into a mat4, or null when the
+     * index is out of range.
+     *
+     * The palette is Carbon's storage - one contiguous Float4x3 buffer, stride
+     * 12 - so a bone is expanded rather than borrowed. Carbon does the same at
+     * every read site with TriMatrixCopyFrom3x4.
      */
 
-    /**
-     * Replays every stored controller variable onto a newly added controller or
-     * effect child through the named setter, so late additions start with the same
-     * state.
+    /**
+     * Replays every stored controller variable onto a newly added controller or
+     * effect child through the named setter, so late additions start with the same
+     * state.
      */
 
-    /**
-     * Samples a curve into out through whichever of Update or GetValueAt it
-     * exposes, writing the fallback when there is no curve and copying back curves
-     * that return a new array instead of filling out.
+    /**
+     * Samples a curve into out through whichever of Update or GetValueAt it
+     * exposes, writing the fallback when there is no curve and copying back curves
+     * that return a new array instead of filling out.
      */
 
-    /**
-     * Reads a numeric value from the update context, preferring a getter method
-     * and falling back to the named properties, and yields 0 when nothing supplies
-     * it.
+    /**
+     * Reads a numeric value from the update context, preferring a getter method
+     * and falling back to the named properties, and yields 0 when nothing supplies
+     * it.
      */
 
-    /**
-     * Returns a world sphere's on-screen diameter in pixels from the frustum's
-     * exact query, or 0 when the frustum does not expose it.
+    /**
+     * Returns a world sphere's on-screen diameter in pixels from the frustum's
+     * exact query, or 0 when the frustum does not expose it.
      */
 
-    /**
-     * Returns a world sphere's on-screen diameter in pixels, preferring the
-     * frustum's cheaper estimated query and falling back to the exact one, or 0
-     * when the frustum exposes neither.
+    /**
+     * Returns a world sphere's on-screen diameter in pixels, preferring the
+     * frustum's cheaper estimated query and falling back to the exact one, or 0
+     * when the frustum exposes neither.
      */
 
     /** Writes a center and radius into a caller-owned sph3. */