Fighting Game · Guides & deep dives

V2 NPC Schedule Day Of Week

flag, and holiday id.

3sections1 minread
Markdown source
On this page

NPCScheduleDayOfWeek.V2 selects a resolved schedule from an authored base schedule, a calendar date, and enabled day-pattern replacements. It supports weekday schedules, weekend schedules, and holiday overrides with priority-based selection.

Runtime Surface#

  • FV2NPCScheduleCalendarDate carries year, month, day, day of week, holiday flag, and holiday id.
  • FV2NPCScheduleDayPattern binds a pattern id, pattern type, target weekday or holiday id, replacement schedule, priority, enabled state, and tags.
  • FV2NPCScheduleDayOfWeekRequest carries the base schedule, date, apply toggle, and available patterns.
  • FV2NPCScheduleDayPatternSelection records the pattern that won selection.
  • FV2NPCScheduleDayOfWeekResult returns the resolved schedule and flags for weekday, weekend, and holiday override selection.

Selection Rules#

  1. Holiday override patterns have enough priority to win over weekend or weekday patterns when the calendar date carries the matching holiday id.
  2. Weekend patterns match Saturday and Sunday.
  3. Weekday patterns match Monday through Friday.
  4. Specific-day patterns can target a single authored day.
  5. Suppressed day-pattern evaluation returns the base schedule unchanged.
  6. Invalid calendar dates, pattern ids, replacement schedules, and missing holiday ids produce blocking issues before selection.

Validation Commands#

Run these targeted checks when touching schedule day-of-week selection:

bash
python3 V2/ue/Tools/check-v2-npc-schedule-day-of-week.py
python3 V2/ue/Tools/check-v2-npc-schedule-variation.py
python3 V2/ue/Tools/check-v2-npc-schedule-interruption.py
python3 V2/ue/Tools/check-v2-npc-schedule-location-binding.py
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/NPCScheduleDayOfWeek_V2_Contract.json
python3 -m py_compile V2/ue/Tools/check-v2-npc-schedule-day-of-week.py