Fighting Game · Guides & deep dives

V2 NPC Schedule Social Interaction

location, availability, priority, and conversation animation metadata.

3sections1 minread
Markdown source
On this page

NPCScheduleSocialInteraction.V2 evaluates nearby NPC participants against relationship-aware social rules. It recognizes friends in the same location, selects conversation animation tags, and emits group conversation commands when enough friends are present.

Runtime Surface#

  • FV2NPCScheduleSocialParticipant describes another NPC with relationship, location, availability, priority, and conversation animation metadata.
  • FV2NPCScheduleSocialRule describes conversation or group-conversation requirements, activity/behavior tags, animation tags, group id, and priority.
  • FV2NPCScheduleSocialCommand is the data-only schedule command issued to AI.
  • FV2NPCScheduleSocialInteractionResult returns the active schedule block, selected participants, command payload, and validation issues.

Interaction Rules#

  1. Available friends at the same location are eligible for social interaction.
  2. Group rules require at least two matching friends and emit a stable group id.
  3. Conversation rules select a conversation animation tag for a single friend.
  4. Rule and participant priority produce deterministic selection.
  5. Social commands can be suppressed while still reporting recognized friends.
  6. Missing current location, participant ids, participant locations, and invalid command output produce blocking issues.

Validation Commands#

Run these targeted checks when touching schedule social interaction:

bash
python3 V2/ue/Tools/check-v2-npc-schedule-social-interaction.py
python3 V2/ue/Tools/check-v2-npc-schedule-weather-response.py
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/NPCScheduleSocialInteraction_V2_Contract.json
python3 -m py_compile V2/ue/Tools/check-v2-npc-schedule-social-interaction.py