luaengine

type BotAPI interface {
	// Movement
	GetPosition() (x, y, z, o float32)
	MoveTo(x, y, z float32) error
	StopMoving() error
	IsMoving() bool

	// Combat
	AttackTarget(guid uint64) error
	StopAttack() error
	SetTarget(guid uint64) error
	CastSpell(spellID uint32, targetGUID uint64) error
	IsSpellReady(spellID uint32) bool
	GetHealth() (current, max uint32)
	GetPower() (current, max uint32)
	GetLevel() uint32
	InCombat() bool
	IsAlive() bool
	GetTargetGUID() uint64

	// Objects
	GetNearbyUnits(maxDist float32) []UnitInfo
	GetNearbyPlayers(maxDist float32) []UnitInfo
	GetUnitInfo(guid uint64) *UnitInfo

	// Actions
	SendChat(message string) error
	SendCommand(command string) error
	SendGuildCommand(command string) error
	Loot(guid uint64) error
	LootAll(guid uint64) error

	// Logging
	Log(format string, args ...interface{})

	// Extended for Lua AI framework (scripts/ai/*)
	GetClass() uint8
	HasAuraOn(guid uint64, spellID uint32) bool
	CanCast(spellID uint32, targetGUID uint64) bool
	GetPetGUID() uint64
	PetAttack(target uint64)
	GetStance() int
	GetOwnGUID() uint64    // own character GUID for faction/self checks
	SetLevel(level uint32) // force level for scenario prep (GM .level may not update internal state immediately)

	GetPowerType() uint8
	IsBehindTarget(targetGUID uint64) bool

	// Facing for proper melee combat (server rejects swings on bad facing / requires facing target)
	GetFacing() float32
	SetFacing(o float32) error
	FaceTarget(guid uint64) bool
	SetSheathed(state uint32) error

	// ValidationMode reports whether the bot is running with heavy validation
	// instrumentation enabled. Must be cheap to call every tick when false.
	// See AZEROTHGHOST_E2E_QUALITY_ASSURANCE_PLAN.md (Performance Isolation section).
	ValidationMode() bool

	// ConsumeTeleport returns true once after a completed near/far teleport
	// (summon, MSG_MOVE_TELEPORT, SMSG_NEW_WORLD). Scripts should interrupt sticky
	// chase/combat state and restart from the new position.
	ConsumeTeleport() bool
}

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

type UnitInfo struct {
	GUID      uint64
	Entry     uint32
	Health    uint32
	MaxHealth uint32
	Level     uint32
	PosX      float32
	PosY      float32
	PosZ      float32
	IsAlive   bool
	IsPlayer  bool
	Distance  float32
	Name      string
	Faction   uint32
	NPCFlags  uint32
	Flags     uint32
	DynFlags  uint32
	Lootable  bool
}