Fighting Game · Guides & deep dives

V2 NPC Schedule Editor

declares the NPC selector, visual timeline, drag-drop block support, and location palette.

3sections1 minread
Markdown source
On this page

NPCScheduleEditor.V2 is a V2Editor TimelineVisualizer surface for editing an NPC's daily schedule as deterministic row models. It exposes a visual timeline per NPC, drag-drop activity block moves, and location assignment while keeping all editor state machine-checkable.

Runtime Surface#

  • FV2NPCScheduleEditorWidgetSpec targets the TimelineVisualizer surface and declares the NPC selector, visual timeline, drag-drop block support, and location palette.
  • FV2NPCScheduleEditorViewportSpec defines visible minute range, horizontal zoom, header width, row height, and timeline width.
  • FV2NPCScheduleEditorRequest carries one optional edit action: MoveBlock or AssignLocation.
  • FV2NPCScheduleEditorModel returns the updated schedule, row layout, selected block, playhead position, and validation issues.

Editor Rules#

  1. The model builds one stable row per schedule block for the selected NPC.
  2. Drag-drop moves rewrite the target block start and end minutes without inventing unrelated schedule data.
  3. Location assignment rewrites only the target block location id.
  4. Offscreen rows clamp to the timeline bounds so the layout remains stable.
  5. Overlapping blocks, invalid drag ranges, missing blocks, invalid locations, invalid source schedules, and invalid viewports produce blocking issues.
  6. The editor module checker includes this spec so the schedule editor remains part of the V2Editor automation surface.

Validation Commands#

Run these targeted checks when touching the NPC schedule editor:

bash
python3 V2/ue/Tools/check-v2-npc-schedule-editor.py
python3 V2/ue/Tools/check-v2-editor-module.py
python3 V2/ue/Tools/check-v2-npc-schedule-debug-visualization.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/Editor/NPCScheduleEditor/NPCScheduleEditor_V2_Contract.json
python3 -m py_compile V2/ue/Tools/check-v2-npc-schedule-editor.py V2/ue/Tools/check-v2-editor-module.py