Fighting Game · Guides & deep dives

V2 NPC Schedule LOD

distance, teleport behavior, animation suppression, and command issue policy.

3sections1 minread
Markdown source
On this page

NPCScheduleLOD.V2 keeps distant scheduled NPCs deterministic without paying the full nearby simulation cost. It uses the same schedule execution and pathfinding targets as the full system, then chooses whether to retain navigation/activity behavior or simplify the update.

Runtime Surface#

  • FV2NPCScheduleLODConfig defines full-simulation distance, simplified distance, teleport behavior, animation suppression, and command issue policy.
  • FV2NPCScheduleLODRequest supplies schedule, current time, current location, player distance, and config.
  • FV2NPCScheduleLODCommand records the resulting LOD action: retain navigation/activity behavior for nearby NPCs or snap a distant NPC to the schedule target.
  • FV2NPCScheduleLODResult returns the selected mode, target location, active block, reused execution/pathfinding/activity results, and validation issues.

Runtime Rules#

  1. NPCs below the simplified distance stay in FullSimulation.
  2. Nearby NPCs retain schedule pathfinding, navigation command issue, and complex activity commands when already at the scheduled interaction.
  3. Distant NPCs switch to Simplified, suppress navigation walking, teleport to the schedule target location, and skip complex activity animations.
  4. The LOD target always comes from schedule pathfinding so simplified NPCs land at the same block/location the full system would target.
  5. Invalid configs, negative distances, missing current locations, invalid pathfinding, invalid nearby activity behavior, and malformed LOD commands produce blocking issues.

Validation Commands#

Run these targeted checks when touching NPC schedule LOD:

bash
python3 V2/ue/Tools/check-v2-npc-schedule-lod.py
python3 V2/ue/Tools/check-v2-npc-schedule-pathfinding.py
python3 V2/ue/Tools/check-v2-npc-schedule-activity-behavior.py
python3 V2/ue/Tools/check-v2-ci-workflow.py
python3 V2/tools/validate-v2-docs.py
python3 -m json.tool V2/ue/Content/V2/Gameplay/NPC/NPCScheduleLOD_V2_Contract.json