Entity Combat Initiative Integration

[FirebrickRed]

Summary

Integrate entities into combat initiative system. Support individual initiative for named entities and group initiative for entity groups. Foundation for full combat system.

Phase: 5 - Combat Integration (Future)
Systems: Combat System, Initiative Tracker, Entity System

Prerequisites

• Unified Entity System Foundation #72 - Unified Entity System Foundation
• Entity Group Management System #79 - Group Management (for group initiative)
• Entity HP Tracking & Damage System #82 - HP Tracking (combat requires HP)

Goals

• Individual initiative for named entities
• Group initiative for entity groups
• Auto-roll initiative on combat start
• Integration with scoreboard teams (from character nameplate work)
• Manual initiative adjustment by DM
• Turn order tracking

Initiative Types

Individual Initiative:

# Named boss monster
id: dragon
name: "Flamewing the Red"
initiative:
  type: individual
  modifier: 2  # DEX modifier

Group Initiative:

# Group of kobolds
group: true
id: kobold_warband
group_initiative: true
# All kobolds roll once, act on same turn

Commands

# Start combat (auto-roll initiative)
/combat start
> Rolling initiative...
> 1. Alice (20)
> 2. Flamewing the Red (18) [Entity]
> 3. Bob (15)
> 4. Kobold Warband (12) [3 entities, group initiative]
> 5. Charlie (8)

# Manually set entity initiative
/combat initiative flamewing set 15
> Flamewing the Red initiative: 18 → 15

Integration

// Scoreboard teams for turn order display
Team initiativeTeam = scoreboard.registerNewTeam("init_18");
initiativeTeam.prefix(Component.text("18 - "));
initiativeTeam.addEntry("Flamewing the Red");

Auto-Start from Scenarios

# From Issue #81 scenarios
on_spawn:
  - type: combat_start  # Triggers initiative tracker
  
# Entities auto-added to initiative

Next Steps

This is future work - no immediate next steps. Completes entity/combat foundation.

Related Issues

• Unified Entity System Foundation #72 - Unified Entity System Foundation (prerequisite)
• Entity Group Management System #79 - Group Management (group initiative)
• Entity HP Tracking & Damage System #82 - HP Tracking (combat requires HP)
• Pre-Planned Combat Scenario System #81 - Pre-Planned Scenarios (auto-start combat)