core

type Ace3DeathEvent struct {
	ID                 uint
	SoldierID          uint
	Time               time.Time
	CaptureFrame       Frame
	Reason             string
	LastDamageSourceID *uint
}

type Ace3UnconsciousEvent struct {
	ID            uint
	SoldierID     uint
	Time          time.Time
	CaptureFrame  Frame
	IsUnconscious bool // true = went unconscious, false = regained consciousness
}

type Addon struct {
	ID         uint
	Name       string
	WorkshopID string
}

type ChatEvent struct {
	ID           uint
	SoldierID    *uint
	Time         time.Time
	CaptureFrame Frame
	Channel      string
	FromName     string
	SenderName   string
	Message      string
	PlayerUID    string
}

type DeleteMarker struct {
	Name     string
	EndFrame Frame
}

type EndMissionEvent struct {
	ID           uint
	Time         time.Time
	CaptureFrame Frame
	Side         string // winning side ("WEST", "EAST", etc.) or empty
	Message      string // victory description
}

type EntityLocality struct {
	UnitsTotal    uint
	UnitsAlive    uint
	UnitsDead     uint
	Groups        uint
	Vehicles      uint
	WeaponHolders uint
}

type FiredEvent struct {
	SoldierID    uint16 // ObjectID of the soldier who fired
	Time         time.Time
	CaptureFrame Frame
	Weapon       string
	Magazine     string
	FiringMode   string
	StartPos     Position3D
	EndPos       Position3D
}

type FocusRange struct {
	Start Frame
	End   Frame
}

type Frame uint

type GeneralEvent struct {
	ID           uint
	Time         time.Time
	CaptureFrame Frame
	Name         string
	Message      string
	ExtraData    map[string]any
}

type GlobalEntityCount struct {
	UnitsAlive       uint
	UnitsDead        uint
	Groups           uint
	Vehicles         uint
	WeaponHolders    uint
	PlayersAlive     uint
	PlayersDead      uint
	PlayersConnected uint
}

type HitEvent struct {
	ID               uint
	Time             time.Time
	CaptureFrame     Frame
	VictimSoldierID  *uint
	VictimVehicleID  *uint
	ShooterSoldierID *uint
	ShooterVehicleID *uint
	WeaponVehicle    string
	WeaponName       string
	WeaponMagazine   string
	EventText        string
	Distance         float32
}

type KillEvent struct {
	ID              uint
	Time            time.Time
	CaptureFrame    Frame
	VictimSoldierID *uint
	VictimVehicleID *uint
	KillerSoldierID *uint
	KillerVehicleID *uint
	WeaponVehicle   string
	WeaponName      string
	WeaponMagazine  string
	EventText       string
	Distance        float32
}

type Marker struct {
	ID           uint
	Time         time.Time
	CaptureFrame Frame
	EndFrame     Frame // FrameForever (0) means persist until end, otherwise frame when marker disappears
	MarkerName   string
	Direction    float32
	MarkerType   string
	Text         string
	OwnerID      int
	Color        string
	Size         string
	Side         string
	Position     Position3D
	Polyline     Polyline
	Shape        string
	Alpha        float32
	Brush        string
	IsDeleted    bool
}

type MarkerState struct {
	ID           uint
	MarkerID     uint
	Time         time.Time
	CaptureFrame Frame
	Position     Position3D
	Direction    float32
	Alpha        float32
	Text         string
	Color        string
	Size         string
	MarkerType   string
	Brush        string
	Shape        string
}

type Mission struct {
	ID                           uint
	MissionName                  string
	BriefingName                 string
	MissionNameSource            string
	OnLoadName                   string
	Author                       string
	ServerName                   string
	ServerProfile                string
	StartTime                    time.Time
	WorldID                      uint
	CaptureDelay                 float32
	AddonVersion                 string
	ExtensionVersion             string
	ExtensionBuild               string
	OcapRecorderExtensionVersion string
	Tag                          string
	PlayableSlots                PlayableSlots
	SideFriendly                 SideFriendly
	Addons                       []Addon
}

type PlacedObject struct {
	ID           uint16 // ObjectID - game identifier
	JoinTime     time.Time
	JoinFrame    Frame
	ClassName    string
	DisplayName  string
	Position     Position3D
	OwnerID      uint16 // OCAP ID of soldier who placed it
	Side         string
	Weapon       string
	MagazineIcon string
}

type PlacedObjectEvent struct {
	CaptureFrame Frame
	PlacedID     uint16
	EventType    string // "detonated", "deleted", or "hit"
	Position     Position3D
	HitEntityID  *uint16 // OCAP ID of hit entity (only for "hit" events)
}

type PlayableSlots struct {
	West        uint8 `json:"west"`
	East        uint8 `json:"east"`
	Independent uint8 `json:"independent"`
	Civilian    uint8 `json:"civilian"`
	Logic       uint8 `json:"logic"`
}

type PlayerNetworkData struct {
	UID    string
	Name   string
	Ping   float32
	BW     float32
	Desync float32
}

type Polyline []Position2D

type Position2D struct {
	X float64 `json:"x"` // easting
	Y float64 `json:"y"` // northing
}

type Position3D struct {
	X float64 `json:"x"` // easting
	Y float64 `json:"y"` // northing
	Z float64 `json:"z"` // elevation ASL
}

type ProjectileEvent struct {
	CaptureFrame    Frame
	FirerObjectID   uint16
	VehicleObjectID *uint16 // nil if not fired from vehicle

	WeaponDisplay   string
	MagazineDisplay string
	MuzzleDisplay   string

	SimulationType string
	MagazineIcon   string

	Trajectory []TrajectoryPoint
	Hits       []ProjectileHit
}

type ProjectileHit struct {
	CaptureFrame  Frame
	Position      Position3D
	SoldierID     *uint16  // set if soldier was hit
	VehicleID     *uint16  // set if vehicle was hit
	ComponentsHit []string // body/vehicle parts hit
}

type RadioEvent struct {
	ID           uint
	SoldierID    *uint
	Time         time.Time
	CaptureFrame Frame
	Radio        string
	RadioType    string
	StartEnd     string
	Channel      int8
	IsAdditional bool
	Frequency    float32
	Code         string
}

type ScriptCounts struct {
	Spawn   uint
	ExecVM  uint
	Exec    uint
	ExecFSM uint
	PFH     uint
}

type SectorEvent struct {
	ID           uint
	Time         time.Time
	CaptureFrame Frame
	Name         string // "captured", "contested"
	ObjectType   string // "sector", etc.
	UnitName     string // name of the sector
	Side         string // capturing side ("WEST", "EAST", etc.) or empty
	PosX         float64
	PosY         float64
	PosZ         float64
}

type SideEntityCount struct {
	Local  EntityLocality
	Remote EntityLocality
}

type SideEntityCounts struct {
	East        SideEntityCount
	West        SideEntityCount
	Independent SideEntityCount
	Civilian    SideEntityCount
}

type SideFriendly struct {
	EastWest        bool `json:"eastWest"`
	EastIndependent bool `json:"eastIndependent"`
	WestIndependent bool `json:"westIndependent"`
}

type Soldier struct {
	ID              uint16 // ObjectID - game identifier
	JoinTime        time.Time
	JoinFrame       Frame
	OcapType        string
	UnitName        string
	GroupID         string
	Side            string
	IsPlayer        bool
	RoleDescription string
	ClassName       string
	DisplayName     string
	PlayerUID       string
	SquadParams     []any
	DeleteFrame     Frame // Frame when entity was excluded (0 = active until end)
}

type SoldierScores struct {
	InfantryKills uint8 `json:"infantryKills"`
	VehicleKills  uint8 `json:"vehicleKills"`
	ArmorKills    uint8 `json:"armorKills"`
	AirKills      uint8 `json:"airKills"`
	Deaths        uint8 `json:"deaths"`
	TotalScore    uint8 `json:"totalScore"`
}

type SoldierState struct {
	SoldierID         uint16 // References Soldier.ID (ObjectID)
	Time              time.Time
	CaptureFrame      Frame
	Position          Position3D
	Bearing           uint16
	Lifestate         uint8
	InVehicle         bool
	InVehicleObjectID *uint16 // ObjectID of vehicle, if in one
	VehicleRole       string
	UnitName          string
	IsPlayer          bool
	CurrentRole       string
	HasStableVitals   bool
	IsDraggedCarried  bool
	Stance            string
	GroupID           string
	Side              string
	Scores            SoldierScores
}

type TelemetryEvent struct {
	Time         time.Time
	CaptureFrame Frame

	// FPS data (also written to mission recording by DB backends)
	FpsAverage float32
	FpsMin     float32

	// Per-side entity counts
	SideEntityCounts SideEntityCounts

	// Global entity counts (all sides combined)
	GlobalCounts GlobalEntityCount

	// Running script counts
	Scripts ScriptCounts

	// Weather snapshot
	Weather WeatherData

	// Per-player network stats (variable length)
	Players []PlayerNetworkData
}

type TimeState struct {
	ID             uint
	Time           time.Time
	CaptureFrame   Frame
	SystemTimeUTC  string
	MissionDate    string
	TimeMultiplier float32
	MissionTime    float32
}

type TrajectoryPoint struct {
	Position Position3D
	FrameNum Frame
}

type UploadMetadata struct {
	WorldName       string
	MissionName     string
	MissionDuration float64
	Tag             string
	EndFrame        Frame
	FocusRanges     []FocusRange
}

type Vehicle struct {
	ID            uint16 // ObjectID - game identifier
	JoinTime      time.Time
	JoinFrame     Frame
	OcapType      string
	ClassName     string
	DisplayName   string
	Customization string
	Side          string // Config side: WEST, EAST, GUER, CIV (from "str side vehicle")
	DeleteFrame   Frame  // Frame when entity was excluded (0 = active until end)
}

type VehicleState struct {
	VehicleID       uint16 // References Vehicle.ID (ObjectID)
	Time            time.Time
	CaptureFrame    Frame
	Position        Position3D
	Bearing         uint16
	IsAlive         bool
	Crew            string
	Fuel            float32
	Damage          float32
	Locked          bool
	EngineOn        bool
	Side            string
	VectorDir       string
	VectorUp        string
	TurretAzimuth   float32
	TurretElevation float32
}

type WeatherData struct {
	Fog           float32
	Overcast      float32
	Rain          float32
	Humidity      float32
	Waves         float32
	WindDir       float32
	WindStr       float32
	Gusts         float32
	Lightnings    float32
	MoonIntensity float32
	MoonPhase     float32
	SunOrMoon     float32
}

type World struct {
	ID                uint
	Author            string
	WorkshopID        string
	DisplayName       string
	WorldName         string
	WorldNameOriginal string
	WorldSize         float32
	Latitude          float32
	Longitude         float32
	Location          Position3D
}