MazeWalkerTv/ACTIVE_FIGHTS_SYSTEM.md

Active Fights Display System

Overview

A complete system for tracking, displaying, and interacting with active fights between runners (AI agents) and monsters in the maze.

Components Created

1. FightTracker.cs (Core Manager)

• Purpose: Tracks all active fights in real-time
• Key Features:
  • StartFight(AIAgent runner, Monster monster) - Called when combat begins
  • EndFight(AIAgent runner, Monster monster) - Called when combat ends
  • GetDisplayFights() - Returns sorted list of fights to display
  • Automatically cleans up old fights after fightDisplayDuration (default: 3 seconds after ending)
  • Sorting: Fights sorted by number of participants in room (descending), then by active status

2. ActiveFightsUIPanel.cs (UI Display)

• Purpose: Displays active fights with zoom functionality
• Features:
  • Shows runner name vs monster type
  • Each fight entry has:
  • Fight description text (e.g., "Alice vs Monster_12345")
  • Status indicator (red dot = active, orange dot = ended)
  • Zoom button to center camera on fight location
  • Panel positioned in top-right corner
  • Auto-updates every 0.5 seconds
  • Clean, dark-themed UI that doesn't obstruct gameplay

3. MazeCameraController.cs (Enhanced with zoom)

• New Method: ZoomToRoom(MazeRoom room, float zoomPadding = 1.3f, float transitionDuration = 0.5f)
• Features:
  • Smooth pan to room center
  • Smooth zoom with adjustable padding (1.3 = 30% larger than room)
  • Adjustable transition speed (default: 0.5 seconds)
  • Works with both orthographic and perspective cameras
  • Bound checks for camera limits

Integration Points

AIAgent.cs

• Added fightingMonsters HashSet to track active fights
• Modified CombatUpdate() to:
  • Report fight start when monster enters melee range
  • Report fight end when monster leaves range or dies
  • Track multiple concurrent fights
• Modified Die() to end all active fights when agent dies

Monster.cs

• Added previousTarget tracking
• Modified AcquireTarget() to:
  • Report fight start when acquiring new target
  • Report fight end when target is lost/killed
• Modified Die() to report fight end

MazeController.cs

• Added InitializeFightTracking() in Start()
• Automatically creates FightTracker and ActiveFightsUIPanel if not present
• Ensures components are initialized before agents/monsters spawn

Data Structure

FightData (struct)

public string runnerName;       // Agent's display name
public int runnerId;            // Agent's ID
public string monsterType;      // Monster identifier
public MazeRoom room;           // Room where fight occurs
public bool isActive;           // True if fight is ongoing
public float timeSinceEnd;      // Time since fight ended
public AIAgent runner;          // Reference to agent
public Monster monster;         // Reference to monster

Features

✅ Real-time Fight Tracking

• Fights automatically detected when agents and monsters are in melee range

✅ Smart Display

• Shows only active fights + recent fights (for a few seconds after they end)
• Fights ranked by number of participants in the room (higher = more intense)

✅ Interactive Zoom

• Click "Zoom" button to smoothly pan and zoom camera to fight location
• Camera zooms to 30% larger than room size for good visibility
• Smooth 0.5-second transition

✅ Visual Feedback

• Red indicator dot for active fights
• Orange indicator dot for recently-ended fights
• Runner name vs monster type displayed
• Clear, unobtrusive UI panel

✅ Automatic Cleanup

• Old fights automatically removed from display
• Dead fighters automatically cleaned up from tracking

Configuration

FightTracker Settings

[SerializeField] private float fightDisplayDuration = 3f; // How long to show ended fights

Camera Zoom Settings (in MazeCameraController)

[SerializeField] private float zoomMin = 5f;
[SerializeField] private float zoomMax = 120f;

UI Panel Settings (in ActiveFightsUIPanel)

[SerializeField] private float updateInterval = 0.5f;  // How often to update display
[SerializeField] private float panelMaxHeight = 400f;  // Maximum panel height

Usage Example

// FightTracker is a singleton - access it anywhere:
FightTracker tracker = FightTracker.Instance;

// Get current fights for display
List<FightData> fights = tracker.GetDisplayFights();

// Zoom to a room
MazeCameraController camera = FindObjectOfType<MazeCameraController>();
camera.ZoomToRoom(room, 1.3f, 0.5f); // zoom to room with 30% padding in 0.5s

Debug Information

The system logs the following to console:

• When fights start (via AIAgent and Monster combat methods)
• When fights end (via death or separation)
• Fight tracking status in FightTracker

Enable debug logging in FightTracker, AIAgent, and Monster if needed for troubleshooting.

Future Enhancements

Potential additions:

• Sound effects when fights start/end
• Different colors/icons for different monster types
• Fight statistics (damage dealt, healing, etc.)
• Fight history/replay system
• Animation transitions for UI panel entries
• Custom zoom speeds/durations per difficulty level