events

type AggroGained struct {
	MobId       int
	MobName     string
	TargetId    int
	TargetType  string // "player" or "mob"
	TargetName  string
	IsInitial   bool // True if this is the first aggro
	ThreatLevel int
}

type AggroLost struct {
	MobId      int
	MobName    string
	TargetId   int
	TargetType string // "player" or "mob"
	TargetName string
	Reason     string // "death", "distance", "reset", "peace", etc.
}

type AttackAvoided struct {
	AttackerId   int
	AttackerType string // "player" or "mob"
	AttackerName string
	DefenderId   int
	DefenderType string // "player" or "mob"
	DefenderName string
	AvoidType    string // "miss", "dodge", "parry", "block"
	WeaponName   string
}

type Broadcast struct {
	Text             string
	TextScreenReader string // optional text for screenreader friendliness
	IsCommunication  bool
	SourceIsMod      bool
	SkipLineRefresh  bool
}

type Buff struct {
	UserId        int
	MobInstanceId int
	BuffId        int
	Source        string // optional source such as spell,
}

type BuffsTriggered struct {
	UserId        int
	MobInstanceId int
	BuffIds       []int
}

type CharacterAlignmentChanged struct {
	UserId       int
	OldAlignment int
	NewAlignment int
}

type CharacterChanged struct {
	UserId            int
	LastCharacterName string
	CharacterName     string
}

type CharacterCreated struct {
	UserId        int
	CharacterName string
}

type CharacterStatsChanged struct {
	UserId int
}

type CharacterTrained struct {
	UserId int
}

type CharacterVitalsChanged struct {
	UserId int
}

type CombatActionCompleted struct {
	EntityId      int
	EntityType    string // "player" or "mob"
	EntityName    string
	Action        string
	ActionName    string
	Success       bool
	FailureReason string
}

type CombatActionInterrupted struct {
	EntityId          int
	EntityType        string // "player" or "mob"
	EntityName        string
	Action            string
	ActionName        string
	InterruptedById   int
	InterruptedByType string // Type of interrupter
	InterruptedByName string
	InterruptType     string // "damage", "stun", "silence", etc.
}

type CombatActionStarted struct {
	EntityId      int
	EntityType    string // "player" or "mob"
	EntityName    string
	Action        string // "spell", "ability", "item", etc.
	ActionName    string
	TargetId      int
	TargetName    string
	CastTime      float64 // Time to complete in seconds
	Interruptible bool
}

type CombatEffectTriggered struct {
	SourceId       int
	SourceName     string
	TargetId       int
	TargetType     string // "player" or "mob"
	TargetName     string
	Effect         string // "bleed", "poison", "burn", etc.
	Damage         int
	TicksRemaining int
}

type CombatEnded struct {
	EntityId   int
	EntityType string // "player" or "mob"
	EntityName string
	Reason     string // "fled", "broke", "peace", "distance", etc.
	RoomId     int
	Duration   int // Combat duration in seconds
}

type CombatStarted struct {
	AttackerId   int
	AttackerType string // "player" or "mob"
	AttackerName string
	DefenderId   int
	DefenderType string // "player" or "mob"
	DefenderName string
	RoomId       int
	InitiatedBy  string // command/action that started combat
}

type CombatantFled struct {
	EntityId    int
	EntityType  string // "player" or "mob"
	EntityName  string
	Direction   string
	Success     bool
	PreventedBy string // What prevented it (if failed)
}

type Communication struct {
	SourceUserId        int    // User that sent the message
	SourceMobInstanceId int    // Mob that sent the message
	TargetUserId        int    // Sent to only 1 person
	CommType            string // say, party, broadcast, whisper, shout
	Name                string
	Message             string
}

type DamageDealt struct {
	SourceId      int
	SourceType    string // "player" or "mob"
	SourceName    string
	TargetId      int
	TargetType    string // "player" or "mob"
	TargetName    string
	Amount        int
	DamageType    string // "physical", "magical", "fire", etc.
	WeaponName    string // Name of weapon used (if applicable)
	SpellName     string // Name of spell used (if applicable)
	IsCritical    bool
	IsKillingBlow bool
}

type DayNightCycle struct {
	IsSunrise bool
	Day       int
	Month     int
	Year      int
	Time      string
}

type EquipmentChange struct {
	UserId        int
	MobInstanceId int
	GoldChange    int
	BankChange    int
	ItemsWorn     []items.Item
	ItemsRemoved  []items.Item
}

type Event interface {
	Type() string
}

type EventFlag uint64

type EventType string

type ExitLockChanged struct {
	Event
	RoomId   int
	ExitName string
	Locked   bool // true if now locked, false if now unlocked
}

type GainExperience struct {
	UserId     int
	Experience int
	Scale      int
}

type GenericEvent interface {
	Event
	Data(name string) any
}

type HealingReceived struct {
	SourceId   int
	SourceType string // "player", "mob", "item", "regen"
	SourceName string
	TargetId   int
	TargetType string // "player" or "mob"
	TargetName string
	Amount     int
	HealType   string // "spell", "potion", "regen", "item", etc.
	SpellName  string // Name of healing spell (if applicable)
	IsOverheal bool
}

type Input struct {
	UserId        int
	MobInstanceId int
	InputText     string
	ReadyTurn     uint64
	Flags         EventFlag
}

type ItemOwnership struct {
	UserId        int
	MobInstanceId int
	Item          items.Item
	Gained        bool
}

type LevelUp struct {
	UserId         int
	RoomId         int
	Username       string
	CharacterName  string
	LevelsGained   int
	NewLevel       int
	StatsDelta     stats.Statistics
	TrainingPoints int
	StatPoints     int
	LivesGained    int
}

type Listener func(Event) ListenerReturn

type ListenerId uint64

type ListenerReturn int8

type ListenerWrapper struct {
	// contains filtered or unexported fields
}

type Log struct {
	FollowAdd    connections.ConnectionId
	FollowRemove connections.ConnectionId
	Level        string
	Data         []any
}

type Looking struct {
	UserId int
	RoomId int
	Target string
	Hidden bool
}

type MSP struct {
	UserId    int
	SoundType string // SOUND or MUSIC
	SoundFile string
	Volume    int    // 1-100
	Category  string // special category/type for MSP string
}

type Message struct {
	UserId          int
	ExcludeUserIds  []int
	RoomId          int
	Text            string
	IsQuiet         bool // whether it can only be heard by superior "hearing"
	IsCommunication bool // If true, this is a communication such as "say" or "emote"
}

type MobDeath struct {
	MobId         int
	InstanceId    int
	RoomId        int
	CharacterName string
	Level         int
	PlayerDamage  map[int]int
}

type MobIdle struct {
	MobInstanceId int
}

type MobStatusChanged struct {
	MobId    int
	Status   string // "stunned", "blinded", "slowed", etc.
	Added    bool   // True if added, false if removed
	Duration int    // Duration in seconds (0 for permanent)
	SourceId int    // Who applied the status
}

type MobVitalsChanged struct {
	MobId      int
	OldHealth  int
	NewHealth  int
	OldMana    int
	NewMana    int
	ChangeType string // "damage", "heal", "regen", etc.
}

type NewRound struct {
	RoundNumber uint64
	TimeNow     time.Time
}

type NewTurn struct {
	TurnNumber uint64
	TimeNow    time.Time
}

type Party struct {
	LeaderUserId  int
	UserIds       []int
	InviteUserIds []int
	AutoAttackers []int
	Position      map[int]string
}

type PartyUpdated struct {
	Action  string // create, disband, membership
	UserIds []int
}

type PlayerDeath struct {
	UserId        int
	RoomId        int
	Username      string
	CharacterName string
	Permanent     bool
	KilledByUsers []int
}

type PlayerDespawn struct {
	UserId        int
	RoomId        int
	Username      string
	CharacterName string
	TimeOnline    string
}

type PlayerDrop struct {
	UserId int
	RoomId int
}

type PlayerSpawn struct {
	UserId        int
	ConnectionId  uint64
	RoomId        int
	Username      string
	CharacterName string
}

type Quest struct {
	UserId     int
	QuestToken string
}

type Queue[T any] struct {
	// contains filtered or unexported fields
}

type QueueFlag int

type RebuildMap struct {
	MapRootRoomId int
	SkipIfExists  bool
}

type RedrawPrompt struct {
	UserId        int
	OnlyIfChanged bool
}

type RoomAction struct {
	RoomId       int
	SourceUserId int
	SourceMobId  int
	Action       string
	Details      any
	ReadyTurn    uint64
}

type RoomChange struct {
	UserId        int
	MobInstanceId int
	FromRoomId    int
	ToRoomId      int
	Unseen        bool
}

type ScriptedEvent struct {
	Name string
	Data map[string]any
}

type System struct {
	Command     string
	Data        any
	Description string
}

type TargetChanged struct {
	EntityId      int
	EntityType    string // "player" or "mob"
	EntityName    string
	OldTargetId   int
	OldTargetType string
	OldTargetName string
	NewTargetId   int
	NewTargetType string
	NewTargetName string
	Reason        string // "manual", "death", "fled", "taunt", etc.
}

type UserSettingChanged struct {
	UserId int
	Name   string
}

type WebClientCommand struct {
	ConnectionId uint64
	Text         string
}