modwright 0.1.0

package/knowledge/cyberpunk2077/npc.behaviour.yaml

@@ -0,0 +1,128 @@
+game: cyberpunk2077
+topic: npc.behaviour
+title: How NPCs treat a stand-in body, and what a hidden NPC still does (attitude, streaming,
+  damage, enemy hacks)
+facts:
+  - id: cp2077.npc.behaviour.squads-obey-the-group-attitude
+    claim: "A squad treats a body by its attitude group, not by per-agent attitudes: with the body in
+      the player's group, AttitudeAgent SetAttitudeTowards(Neutral) both ways toward each squadmate
+      did not stop them attacking it at once. With the body in the squad's own group they left it
+      alone, but the player's gun lowers at a friendly, and a provoked squadmate turned the whole
+      group on itself (the released target too)."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - attitude
+      - squad
+      - group
+      - replacer
+      - combat
+  - id: cp2077.npc.behaviour.the-builtin-neutral-group
+    claim: The engine's built-in attitude groups 'friendly', 'neutral' and 'hostile' have fixed
+      relations (CanChangeAttitudeRelationFor refuses them) and can be assigned with
+      AttitudeAgent.SetAttitudeGroup, as vanilla's dynamic spawns do with 'hostile'. A body put in
+      'neutral' is left alone by a squad until it shoots one; then only that squad turns on it
+      (vanilla's per-agent AIActionHelper hostility), and the player's gun does not lower at them.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - attitude
+      - neutral
+      - group
+      - squad
+    related:
+      - cp2077.npc.behaviour.squads-obey-the-group-attitude
+  - id: cp2077.npc.behaviour.aiteleportcommand-runs-late-in-combat
+    claim: "An AITeleportCommand waits for the NPC's AI to take it: in combat it ran seconds late (the
+      NPC showed at its old spot, then jumped). The TeleportationFacility moves an unfrozen NPC at
+      once; sent before the NPC is unhidden, with the AI command after it, the NPC appeared at the
+      target spot (0 m, 0.7 m)."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - teleport
+      - ai
+      - combat
+      - npc
+  - id: cp2077.npc.behaviour.a-left-behind-world-npc-streams-out
+    claim: "A world (community) NPC left where it stood while the player travels far streams out: the
+      script's reference goes undefined, and when the player returns a new instance stands at its
+      streaming origin, beyond the old reference. World NPCs cannot be despawned from script
+      (spawn::Set::DespawnObject removes only its own set's), so a stand-in that must keep the NPC's
+      identity moves the hidden NPC along with the player's body (a teleport every second) instead."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - streaming
+      - community
+      - npc
+      - despawn
+      - follow
+  - id: cp2077.npc.behaviour.a-hidden-npc-keeps-its-hit-shapes
+    claim: "An NPC hidden by masks and toggles with collision disabled (NPCPuppet.DisableCollision) can
+      still be shot and killed: its hit shapes stay. Invulnerable god mode
+      (GodModeSystem.AddGodMode) makes it take no damage; its release must remove the god mode
+      before any scripted kill. The hit representation's scale event
+      (HitRepresentation_SetSingleScaleMultiplier_AllShapes) was sent too; whether it lets shots
+      pass is not separated from the god mode."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - damage
+      - godmode
+      - hitshape
+      - hide
+      - npc
+  - id: cp2077.npc.behaviour.an-npc-upload-on-a-stand-in-body
+    claim: "An enemy netrunner's quickhack upload aimed at the player's stand-in body runs through
+      UploadFromNPCToPlayerListener, which holds V's UI_HUDProgressBar and a 'PlayerBeingHacked'
+      save lock until the upload pool completes. Despawning the body mid-upload cuts it off: the bar
+      stays, the lock stays, and a red link from the netrunner through the squadmate it hacks
+      through (its proxy) to the body's last spot stays until that squadmate dies; it is not a
+      NetworkSystem link. Applying AIQuickHackStatusEffect.HackingInterrupted to the squadmates
+      carrying AIQuickHackStatusEffect.Hacking, and releasing a second later with the body still
+      there, ends it as \"failed\" with the bar and the link gone."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - netrunner
+      - upload
+      - quickhack
+      - hud
+      - save-lock
+      - replacer
+  - id: cp2077.npc.behaviour.a-replacer-is-the-player-main-object
+    claim: While a replacer body is enabled (the player system's replacer enable),
+      PlayerSystem.GetLocalPlayerMainGameObject returns the body, not V; code that means V must keep
+      V's own puppet from before the take.
+    status: inferred
+    verified_on: "2.31"
+    source: ModWright research
+    tags:
+      - replacer
+      - player
+      - main-object
+  - id: cp2077.npc.behaviour.spawned-npc-ability-stats-read-zero
+    claim: An NPC spawned from its record with exEntitySpawner.SpawnRecord reads 0 for the HasX /
+      CanQuickhack stats its archetype's ability groups grant (HasSandevistan, HasKerenzikov,
+      HasChargeJump, CanQuickhack), while TweakDBInterface's ability list for the record holds them
+      and the scanner shows them. An NPC placed by the world reads the same stats as 1. A script
+      gate on those stats refuses spawned NPCs that a player would expect to pass; reading the
+      ability list as well matches both.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - npc
+      - abilities
+      - stats
+      - spawn
+      - exentityspawner
+    detail: One spawned record, Character.lmg_dude, read no archetype at all in game, though the vanilla
+      index gives it ArchetypeData.HeavyRangedT2.

package/knowledge/cyberpunk2077/npc.locomotion.yaml

@@ -0,0 +1,490 @@
+game: cyberpunk2077
+topic: npc.locomotion
+title: NPC locomotion, reactions and the animation graph - what script can and cannot drive on a
+  puppet whose mover is defeated
+facts:
+  - id: cp2077.npc.locomotion.graph-archive
+    claim: The gameplay humanoid animation graph is base\gameplay\anim_graphs\humanoid.animgraph and it
+      is listed by exactly one archive, archive\pc\content\basegame_3_nightcity.archive (not the
+      animation archive). WolvenKit's `unbundle -w` matches the whole depot path, so the filename
+      alone finds nothing; a pattern such as "*anim_graphs*humanoid.animgraph" is needed. Serialized
+      with `convert serialize` the file is about 420 MB of JSON.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - animgraph
+      - humanoid
+      - archive
+      - wolvenkit
+      - resource
+  - id: cp2077.npc.locomotion.graph-feature-inputs
+    claim: 'humanoid.animgraph declares 51 animAnimFeatureEntry inputs. The locomotion one is
+      animAnimFeature_Locomotion on the input name "locomotion" and it is the only one; there is NO
+      animAnimFeature_Movement entry, so AnimFeature_Movement.SetSpeed applied on "locomotion" is
+      ignored. Other inputs worth knowing: animAnimFeatureFreezeFrame => "FreezeFrame",
+      entAnimFeature_LookAt => "lookAt", animAnimFeature_NPCState => "highLevelState" /
+      "upperBodyState" / "stanceState", animAnimFeature_HitReactionsData => "hit",
+      AnimFeature_StimReactions => "stimReaction", AnimFeature_NPCStatusEffect => "statusEffect",
+      animAnimFeatureUpdateWorkspot => "UpdateWorkspot", animAnimFeature_CrowdLocomotion =>
+      "crowd_locomotion", twelve animAnimFeature_AIAction inputs and the six
+      AnimFeature_PhotomodeBodyPartRotate ones.'
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - animgraph
+      - animfeature
+      - locomotion
+      - humanoid
+    detail: Confirms and completes a partial list read earlier in an in-game probe.
+  - id: cp2077.npc.locomotion.action-is-movelocomotionaction
+    claim: The graph's locomotion transitions are animAnimStateTransitionCondition_IntFeature conditions
+      on featureName "locomotion", featurePropertyName "action", compared against 0,1,3,4,5,6,7 (36
+      conditions) and "style" (7 conditions). Those values are moveLocomotionAction term for term
+      (Undefined 0, Exploration 1, Idle 2, IdleTurn 3, Reposition 4, Start 5, Move 6, Stop 7), the
+      enum returned by MovePoliciesComponent.GetCurrentLocomotionAction(); the same component
+      answers GetInclineAngle() and IsOnStairs(), the other two animAnimFeature_Locomotion fields.
+      The locomotion feature is therefore the move-policies/mover state published to the graph by
+      the engine, not something a caller asserts.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - animgraph
+      - locomotion
+      - movepolicies
+      - mover
+      - walk-cycle
+  - id: cp2077.npc.locomotion.feature-class-not-in-script
+    claim: "animAnimFeature_Locomotion is declared nowhere a redscript can reach: not in the shipped
+      scripts (core\\animation\\animFeature.script declares AnimFeature_Movement at :157-160,
+      AnimFeature_NPCState at :20-23, AnimFeature_StimReactions at :770-773 and forty others, but no
+      Locomotion feature; the only \"Locomotion\" classes in the tree are
+      AnimFeature_PlayerLocomotionStateMachine at :169 and the drone's
+      ApplyDroneLocomotionWrapperEvent) and not in Codeware 1.20.3, which declares
+      animAnimFeature_CrowdLocomotion (:5699) and adds the fields of AnimFeature_Movement (:238-256)
+      but not the Locomotion feature. No script can build the object the graph's locomotion input
+      expects."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - animfeature
+      - locomotion
+      - redscript
+      - codeware
+  - id: cp2077.npc.locomotion.locomotioncycle-is-a-spawn-style
+    claim: 'LocomotionCycle01..14 are a spawn-time style roll, not a walk gate:
+      NPCPuppet.SetRandomAnimWrappersForLocomotion() does RandRange(1,15) and sets exactly one of
+      them to 1.0 (then, by visual tag, LowlifeLocomotion / MidCorpLocomotion / PoshLocomotion /
+      DirtGirlLocomotion / HomelessLocomotion / FreakLocomotion / JunkieLocomotion), and its only
+      caller is OnGameAttached. The serialized humanoid.animgraph contains ZERO occurrences of the
+      string "LocomotionCycle" and none of its 84 distinct wrapperNames is one, so
+      SetAnimWrapperWeight(npc, n"LocomotionCycle01", 1.0) on a puppet running that graph cannot
+      start a walk.'
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - animwrapper
+      - locomotioncycle
+      - walk-cycle
+      - animgraph
+  - id: cp2077.npc.locomotion.graph-wrapper-names
+    claim: The locomotion-relevant anim wrappers humanoid.animgraph itself reads (on its
+      animAnimNode_WrapperValue nodes) are combatLocomotion, stealthLocomotion, alertedLocomotion,
+      FearLocomotion1..4, woundedLocomotion_l_arm / _r_arm / _l_leg / _r_leg,
+      dismemberedLocomotion_l_arm / _r_arm, blockStateLocomotion, the prop-carry set
+      (BucketLocomotion, BucketheadLocomotion, CanLocomotion, CellphoneLocomotion,
+      CellphoneTalkingLocomotion, CigaretteLocomotion, CrateLocomotion, DufflebagLocomotion,
+      LaptopbagLocomotion, PurseLocomotion, TabletLocomotion, UmbrellaLocomotion,
+      WaitressLocomotion), plus crowd, Droid, NCPD, Sandevistan, inVehicle, fear, panic, disturbed,
+      JackieWounded, the Cyb_* / Wea_* / w_* item wrappers and three sportbike seats - 84 distinct
+      names in all. They pick WHICH locomotion set plays, never whether it plays.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - animwrapper
+      - animgraph
+      - locomotion
+  - id: cp2077.npc.locomotion.no-external-locomotion-event
+    claim: humanoid.animgraph has 29 animAnimStateTransitionCondition_ExternalEvent transitions and
+      their complete set of event names is "hit" (16), "Shoot" (3), "Reload" (3), "PlayBlock" (2),
+      "PlayParry", "ActionStartup", "ActionLoop", "ActionRecovery", "RepeatActionLoop". There is no
+      locomotion event, so AnimationControllerComponent.PushEvent / PushEventToReplicate cannot
+      start the leg cycle.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - animgraph
+      - pushevent
+      - animationcontrollercomponent
+      - locomotion
+  - id: cp2077.npc.locomotion.no-mover-velocity-api
+    claim: There is no script API that sets a puppet's mover velocity. The only reference to
+      moveComponent in the whole shipped script tree is
+      MoveComponentVelocityProvider.CreateMoveComponentVelocityProvider(puppet), a read-only
+      velocity source; Codeware declares `moveComponent extends entIMoverComponent {}` with no
+      members and entIMoverComponent as an empty importonly class. The motion planner exposes
+      exactly one field, moveMotionPlannerComponent.snapToGround (writable through Codeware).
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - movecomponent
+      - mover
+      - velocity
+      - codeware
+      - snaptoground
+  - id: cp2077.npc.locomotion.movepolicies-is-script-reachable
+    claim: MovePolicies is an ordinary new-able IScriptable with SetDestinationPosition,
+      SetDestinationObject, SetMovementType, SetUseStartStop, SetIgnoreNavigation,
+      SetDistancePolicy, SetStopOnObstacle, SetCollisionAvoidancePolicy, SetPositionProvider and
+      thirty more; ScriptedPuppet.GetMovePolicesComponent() is public and
+      MovePoliciesComponent.AddPolicies / PopPolicies take it. That is exactly how the AI moves an
+      NPC (AIActionMovePolicy.Add fills one from a MovementPolicy_Record and pushes it). Speed is
+      tunable with AIHumanComponent.SetMovementParams / GetMovementParams. Pushing a destination is
+      the only script-reachable input the graph's own locomotion conditions can see, and it needs
+      the mover alive.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - movepolicies
+      - walk-cycle
+      - mover
+      - movementparameters
+  - id: cp2077.npc.locomotion.no-script-walk-with-mover-defeated
+    claim: With the mover defeated (AIHumanComponent.Toggle(false) plus per-frame SetWorldTransform) NO
+      script-reachable path drives the humanoid leg cycle. Feeding AnimFeature_Movement on
+      "locomotion", setting the LocomotionCycle0N wrappers, pushing an animation event and writing
+      mover velocity are each ruled out by a read of the graph or of the script surface. The two
+      designs that can work are (a) let the mover move the body through a MovePolicies destination
+      and correct the transform only on drift, and (b) put the puppet in a workspot with a
+      walk-in-place clip, which plays with the mover off but owns the whole body.
+    status: inferred
+    verified_on: "2.31"
+    source: ModWright research
+    tags:
+      - walk-cycle
+      - mover
+      - locomotion
+      - design
+    related:
+      - cp2077.npc.locomotion.movepolicies-is-script-reachable
+      - cp2077.npc.locomotion.workspot-jump-to-anim
+  - id: cp2077.npc.locomotion.workspot-jump-to-anim
+    claim: humanoid.animgraph carries one animAnimNode_WorkspotHub and declares
+      animAnimFeatureUpdateWorkspot => "UpdateWorkspot" and
+      animAnimFeatureWorkspotInertializationAnim => "WorkspotInertialization"; WorkspotGameSystem
+      can put an actor in a workspot (PlayInDeviceSimple, PlayNpcInWorkspot) and jump it to a named
+      animation or tag (SendJumpToAnimEnt, SendJumpToTagCommandEnt), stop it (StopNpcInWorkspot) and
+      send reaction signals (SendReactionSignal). A workspot clip plays with the mover off because
+      the hub overrides the body pose.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - workspot
+      - animgraph
+      - walk-cycle
+  - id: cp2077.npc.locomotion.quickhack-completion-effects
+    claim: QuickHack.BaseBlindHack derives from QuickHack.ControlHack and QuickHack.QuickHack; its
+      effective completionEffects are five, contributed by QuickHack and ControlHack - an armour
+      stat group, a RefreshPingEffector on the target, BaseStatusEffect.WasQuickHacked on the
+      target, BaseStatusEffect.QuickHackUploaded on the instigator and
+      Effectors.NotifyPoliceEffector on the target. A mod hack based on BaseBlindHack inherits all
+      five; an !append adds to them. BaseStatusEffect.WasQuickHacked itself carries only the
+      gameplay tag "Debuff" (inherited from BaseStatusEffect.DebuffStatusEffect).
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - quickhack
+      - controlhack
+      - completioneffects
+      - statuseffect
+      - tweakdb
+  - id: cp2077.npc.locomotion.nonstealth-quickhack-alert
+    claim: A completed non-stealth quickhack alerts the target through a DELAYED event, not through the
+      AI. NPCPuppet.OnStatusEffectApplied reads the applied effect's own gameplay tags and, when the
+      effect was not applied on spawn, the instigator is the player, the tags do not contain
+      'Stealth' and QuickHackableQueueHelper.IsAwarenessBumpingAllowed is true, schedules
+      NonStealthQuickHackVictimEvent 0.1 s later. OnNonStealthQuickHackVictimEvent then calls
+      NPCPuppet.RevealPlayerPositionIfNeeded and, if that returns false,
+      NPCStatesComponent.AlertPuppet, followed by AIActionHelper.TryChangingAttitudeToHostile.
+      AlertPuppet from Relaxed calls NPCPuppet.ChangeHighLevelState(owner, Alerted); from Alerted it
+      raises the security system's ALARM or AISquadHelper.EnterAlerted.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - quickhack
+      - alert
+      - statuseffect
+      - delaysystem
+      - reaction
+  - id: cp2077.npc.locomotion.highlevelstate-is-an-anim-feature
+    claim: NPCPuppet.ChangeHighLevelState writes an NPCStateChangeSignal into the puppet's signal table;
+      NPCStatesComponent.OnNPCStateChangeSignalReceived leads to UpdateHighLevelState, which applies
+      an AnimFeature_NPCState with state = the new high-level state on the input 'highLevelState'
+      through AnimationControllerComponent.ApplyFeature and writes the puppet-state blackboard (at
+      Combat it also calls AnimationSystem.EnterCombatMode). Since humanoid.animgraph declares
+      animAnimFeature_NPCState => "highLevelState" and tests it, entering Alerted is an
+      animation-graph state change - the alerted idle (the android's head jerk and scan) is the
+      graph's, played by the animation controller and not by the behaviour tree.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - highlevelstate
+      - animfeature
+      - npcstatescomponent
+      - alerted
+  - id: cp2077.npc.locomotion.reaction-components-are-separate
+    claim: ScriptedPuppet resolves the AI controller ('AIComponent' -> AIHumanComponent), the reaction
+      manager ('ReactionManager' -> ReactionManagerComponent) and the hit reactions
+      ('HitReactionOverride' or 'HitReaction' -> HitReactionComponent) as separate components, and
+      NPCStatesComponent (an AINetStateComponent) is a fourth. Toggling the AI controller off
+      touches none of them, so the quickhack alert path, the stim reactions, the hit reactions and
+      the high-level-state animation all keep running on a driven puppet.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - aihumancomponent
+      - reactionmanagercomponent
+      - hitreactioncomponent
+      - mover-defeat
+  - id: cp2077.npc.locomotion.disallows-awareness-bump-tag
+    claim: QuickHackableQueueHelper.IsAwarenessBumpingAllowed(target) walks the target's
+      completed-quickhack history plus the currently uploading action and everything queued behind
+      it, collects every CompletionEffects() record, and returns false if ANY of their status
+      effects has the gameplay tag 'DisallowsAwarenessBumpInQueue'. It is per-action, not
+      per-effect, so one such tag on any status effect in a hack's completionEffects suppresses the
+      NonStealthQuickHackVictimEvent for that whole hack, including the inherited WasQuickHacked
+      effect. This is the clean pre-empt for a mod hack that must not alert its target.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - quickhack
+      - gameplaytag
+      - alert
+      - tweakdb
+      - stealth
+  - id: cp2077.npc.locomotion.reaction-cancel-levers
+    claim: The script-reachable levers on ReactionManagerComponent are ClearPendingReaction() (public);
+      queueing TerminateReactionLookatEvent on the NPC, whose handler calls DeactiveLookAt() and so
+      LookAtRemoveEvent.QueueRemoveLookatEvent with the component's own handle; queueing
+      SwapPresetEvent{mappingName} to map a preset whose type is
+      gamedataReactionPresetType.NoReaction, which short-circuits the reaction helpers; and
+      IComponent.Toggle(false) on the component. None of them touches the quickhack alert path,
+      which runs in NPCPuppet's own handlers and NPCStatesComponent. LookAtRemoveEvent needs the
+      original LookAtAddEvent, so a third party cannot remove a look-at it did not add.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - reactionmanagercomponent
+      - lookat
+      - reactionpreset
+      - cancel
+  - id: cp2077.npc.locomotion.root-motion-and-uncontrolled-movement
+    claim: "humanoid.animgraph publishes a motion table (424 animMotionTableProvider_Animation nodes
+      plus multi-blend, static switch, master-slave and default providers), so its clips carry root
+      motion the mover consumes; AI action animations are launched with an explicit useRootMotion
+      flag and an updateMovePolicy flag (ActionAnimationScriptProxy.Setup / ForceLaunch). The
+      engine's term for animation- or physics-owned motion is uncontrolled movement:
+      UncontrolledMovementStartEvent carries ragdollNoGroundThreshold, ragdollOnCollision and
+      calculateEarlyPositionGroundHeight, is ended by UncontrolledMovementEndEvent, and NPCPuppet
+      re-polls every 0.2 s and clears it only when the puppet is ragdolling or its velocity is under
+      0.01."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - rootmotion
+      - uncontrolledmovement
+      - ragdoll
+      - mover
+  - id: cp2077.npc.locomotion.fling-is-two-writers
+    claim: "A reaction animation on a puppet whose transform a script owns each frame has two writers -
+      the per-frame SetWorldTransform and the animation's root motion - and the mover's velocity
+      becomes the difference between consecutive transforms over a dt it did not choose. That is the
+      shape of one in-game reading (vel 44612936794112.0 with mover 3, defeated true: the body was
+      flung, not dropped, and the fall began exactly as the android's alerted scan played)."
+    status: inferred
+    verified_on: "2.31"
+    source: ModWright research
+    tags:
+      - rootmotion
+      - mover-defeat
+      - setworldtransform
+      - fall
+    detail: "Testable indirectly: if the DisallowsAwarenessBumpInQueue tag stops the alert and the fall
+      goes with it, the reaction animation was the cause."
+  - id: cp2077.npc.locomotion.individual-time-dilation-is-entity-level
+    claim: "TimeDilationHelper.SetIndividualTimeDilation is a wrapper that bails in multiplayer and
+      calls the target's own native; the native lives on TimeDilatable extends GameObject, beside
+      HasIndividualTimeDilation, UnsetIndividualTimeDilation, GetTimeDilationValue,
+      IsIgnoringGlobalTimeDilation and IsIgnoringTimeDilation, and takes two arguments the helper
+      never passes (ignoreGlobalDilation, useRealTime). Because it is a GameObject method and not a
+      component method it is untouched by AIHumanComponent.Toggle(false): a puppet with its AI off
+      still honours it."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - timedilation
+      - timedilatable
+      - gameobject
+      - mover-defeat
+  - id: cp2077.npc.locomotion.time-dilation-is-a-clock-not-a-switch
+    claim: "Individual time dilation scales an NPC's clock in both directions and nothing in the shipped
+      scripts pauses an animation graph: the uses are 'VeryStrongHit' at the impulse ratio for 0.5
+      s, 'MeleeLegKnockdown' at 1.6 for 0.5 s (hit and death reactions), a Kerenzikov ramp, and a
+      dive at 0.05 for 2.5 s. AnimationSystem itself has only SetForcedVisible,
+      SetForcedVisibleOnlyInFrustum, EnterCombatMode and ExitCombatMode."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - timedilation
+      - animationsystem
+      - freeze
+  - id: cp2077.npc.locomotion.procedural-nodes-survive-dilation
+    claim: "The humanoid graph's head and limb motion at idle is not only clip playback: it declares
+      entAnimFeature_LookAt => \"lookAt\" and carries animAnimNode_LookAtController (3),
+      animAnimNode_AimConstraint (15), animAnimNode_OrientConstraint (60), animAnimNode_RotateBone
+      (339), animAnimNode_AddIkRequest (34), animAnimNode_Ik2Constraint (43) and
+      animAnimNode_PostProcess_Footlock (5) - procedural solvers that write a pose toward a target
+      every time the graph is sampled. A near-zero time dilation stops the clock, not the sampling,
+      which is why the idle head turn and the android's scan keep moving on a puppet whose body is
+      rigid."
+    status: inferred
+    verified_on: "2.31"
+    source: ModWright research
+    tags:
+      - animgraph
+      - lookat
+      - procedural
+      - timedilation
+      - freeze
+  - id: cp2077.npc.locomotion.freeze-levers
+    claim: "What could stop the graph, and its cost: (1) animAnimFeatureFreezeFrame on the declared
+      input \"FreezeFrame\" is the right-named lever but its class is declared neither in the
+      shipped scripts nor in Codeware 1.20.3, so script cannot build one; (2)
+      AnimationControllerComponent.SetUsesSleepMode(obj, state) is the only graph-wide script switch
+      and it governs sleeping, not pausing; (3) IComponent.Toggle(false) on the
+      AnimationControllerComponent or the entAnimatedComponent is the blunt instrument
+      (AnimatedComponent has no script API of its own), untested and likely to freeze or break the
+      pose and anything bound to a bone slot; (4) the graph resource's own isPaused and
+      timeDeltaMultiplier fields are real but have no script setter."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - freeze
+      - animationcontrollercomponent
+      - animatedcomponent
+      - animgraph
+      - codeware
+  - id: cp2077.npc.locomotion.minotaur-graph-is-mover-fed
+    claim: "The Minotaur mech's look (base\\mechanical\\mech\\mch_003__minotaur\\mch_003__minotaur.app)
+      runs base\\gameplay\\anim_graphs\\maelstrom_exo.animgraph on its `root` animated component,
+      bound to the NPC's controller AnimationController1473. The graph picks its walk from
+      locomotion.action (18 transition conditions), float inputs of the `locomotion` group
+      (directionAngle, pathCurvature, ...) and of a `locomotion_ext` group it does not declare as a
+      feature (moveAnimationSpeed, moveAnimationTime, moveScale, startDirectionAngle), and 13
+      EnumSwitch nodes on animMotionTableAction over 168 motion table providers: the mover's and the
+      motion planner's state, none of it script-settable. On a body without a mover (a vehicle) that
+      graph cannot be made to walk; a graph of the mod's own is needed."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - animgraph
+      - mech
+      - minotaur
+      - locomotion
+      - vehicle
+  - id: cp2077.npc.locomotion.minotaur-walk-clip-speeds
+    claim: cr_minotaur_hmg_locomotion_combat.anims (the Minotaur's locomotion set) holds idle_stand,
+      walk_0, walk_180, walk_090, walk_270 and the start, stop and turn transitions, and no run. By
+      their motion extraction walk_0 and walk_180 cover 1.96 m in 1.5 s (1.31 m/s) and walk_090 /
+      walk_270 cover 1.40 m (0.93 m/s); walk_090 moves along +X, walk_270 along -X.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - anims
+      - mech
+      - minotaur
+      - walk
+      - motion-extraction
+  - id: cp2077.npc.locomotion.vehicle-graph-single-clip
+    claim: "A vehicle's animation graph can be a single looping clip: the Heist parade floats'
+      q112_carp_small_animgraph.animgraph is Root -> Output -> SkAnim (isLooped 1), with no features
+      and no variables. Graph float variables are set on a vehicle from script with
+      AnimationControllerComponent.SetInputFloat, as vanilla does for a car's destruction
+      variables."
+    status: verified
+    verified_on: "2.31"
+    source: base\quest\main_quests\part1\q112\vehicles\q112_carp_small_animgraph.animgraph;
+      tools\redmod\scripts\core\components\scriptComponents\vehicleComponent.script:4710-4752;
+      core\components\animationControllerComponent.script:118-124
+    tags:
+      - animgraph
+      - vehicle
+      - animationcontrollercomponent
+      - setinputfloat
+  - id: cp2077.npc.locomotion.skspeedanim-speed-is-ground-speed
+    claim: "animAnimNode_SkSpeedAnim with no motion provider takes its Speed input as a ground speed in
+      m/s and scales the clip by the clip's own motion-extraction speed: on the mod's mech vehicle
+      (walk_0 covers 1.31 m/s at rate 1) feeding the vehicle's forward speed in m/s put the legs in
+      sync, while feeding the ratio speed / 1.31 left them lagging the body."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - animgraph
+      - skspeedanim
+      - walk
+      - vehicle
+      - mech
+  - id: cp2077.npc.locomotion.parked-vehicle-graph-idle
+    claim: "A spawned vehicle that is not being driven does not tick the graph of an extra animated
+      component on it: SetInputFloat on the mod's parked mech vehicle changed nothing, and the same
+      call after SetVehicleRemoteControlled(true) played the walk. The variables reach a secondary
+      animated component bound to the vehicle's AnimationController."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - animgraph
+      - vehicle
+      - remote-control
+      - setinputfloat
+      - mech
+  - id: cp2077.npc.locomotion.minotaur-no-foot-ik
+    claim: "The Minotaur keeps its feet on the ground only through its root: its template's
+      moveMotionPlannerComponent has snapToGround = 1 and the walk clips' motion moves the root. Its
+      graph (maelstrom_exo, shared with the Maelstrom exo boss) carries a leg IK chain
+      (SetBonePosition on ik_leftMechanicalLeg01_cache_eff from an engine-fed model-space target,
+      then animAnimNode_Ik2Constraint over l_leg_IK_01..03 with a _cache_pv pole), but the
+      Minotaur's rig (mch_003__minotaur.rig, 68 bones) has no ik_*_cache_eff or _cache_pv bone, so
+      on this rig those nodes do nothing; its only Ik2 nodes are the arms'."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - animgraph
+      - ik
+      - mech
+      - minotaur
+      - rig
+      - locomotion