Fighting Game · Guides & deep dives

V2 NPC Schedule Activity Behavior

time, current location id, and command issuing flag.

3sections1 minread
Markdown source
On this page

NPCScheduleActivityBehavior.V2 turns a selected schedule block into concrete activity steps. It sits above schedule execution and pathfinding: the NPC must be at the scheduled location before work, eat, sleep, social, idle, travel, or custom activity steps are issued.

Runtime Surface#

  • FV2NPCScheduleActivityBehaviorRequest carries the authored schedule, current time, current location id, and command issuing flag.
  • FV2NPCScheduleActivityStep carries a stable step id, action type, interaction tag, animation tag, duration, reservation requirement, and blocking flag.
  • FV2NPCScheduleActivityCommand carries the active schedule block and the concrete steps issued to the activity/AI layer.
  • FV2NPCScheduleActivityBehaviorResult reports readiness, navigation gating, active block metadata, execution/pathfinding evidence, activity steps, command payload, and validation issues.

Activity Rules#

  1. The active schedule block is resolved through the schedule execution engine.
  2. The current location is checked through schedule pathfinding. If the NPC is not at the active block's location, activity behavior blocks until navigation completes.
  3. Activity blocks require an InteractionTag so seats, beds, counters, and workstations remain explicit.
  4. Work blocks reserve the workstation, perform WorkAtStation, and play Animation.Schedule.WorkLoop.
  5. Eat blocks reserve a seat, sit, and play Animation.Schedule.Eat.
  6. Sleep blocks move to the bed, perform SleepInBed, and play Animation.Schedule.SleepLoop.
  7. Visit/social, idle, travel, and custom activities also produce deterministic fallback steps for later behavior-tree integration.

Validation Commands#

Run these targeted checks when touching schedule activity behavior:

bash
python3 V2/ue/Tools/check-v2-npc-schedule-activity-behavior.py
python3 V2/ue/Tools/check-v2-npc-schedule-pathfinding.py
python3 V2/ue/Tools/check-v2-npc-schedule-execution-engine.py
python3 V2/ue/Tools/check-v2-npc-schedule-data-format.py
python3 V2/ue/Tools/check-v2-ci-workflow.py
python3 -m json.tool V2/ue/Content/V2/Gameplay/NPC/NPCScheduleActivityBehavior_V2_Contract.json
python3 -m py_compile V2/ue/Tools/check-v2-npc-schedule-activity-behavior.py