2 * Copyright (C) 2005-2009 MaNGOS <http://getmangos.com/>
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 #ifndef MANGOS_CREATURE_EAI_H
20 #define MANGOS_CREATURE_EAI_H
24 #include "CreatureAI.h"
30 #define EVENT_UPDATE_TIME 500
36 EVENT_T_TIMER
= 0, // InitialMin, InitialMax, RepeatMin, RepeatMax
37 EVENT_T_TIMER_OOC
= 1, // InitialMin, InitialMax, RepeatMin, RepeatMax
38 EVENT_T_HP
= 2, // HPMax%, HPMin%, RepeatMin, RepeatMax
39 EVENT_T_MANA
= 3, // ManaMax%,ManaMin% RepeatMin, RepeatMax
40 EVENT_T_AGGRO
= 4, // NONE
41 EVENT_T_KILL
= 5, // RepeatMin, RepeatMax
42 EVENT_T_DEATH
= 6, // NONE
43 EVENT_T_EVADE
= 7, // NONE
44 EVENT_T_SPELLHIT
= 8, // SpellID, School, RepeatMin, RepeatMax
45 EVENT_T_RANGE
= 9, // MinDist, MaxDist, RepeatMin, RepeatMax
46 EVENT_T_OOC_LOS
= 10, // NoHostile, MaxRnage, RepeatMin, RepeatMax
47 EVENT_T_SPAWNED
= 11, // Condition, CondValue1
48 EVENT_T_TARGET_HP
= 12, // HPMax%, HPMin%, RepeatMin, RepeatMax
49 EVENT_T_TARGET_CASTING
= 13, // RepeatMin, RepeatMax
50 EVENT_T_FRIENDLY_HP
= 14, // HPDeficit, Radius, RepeatMin, RepeatMax
51 EVENT_T_FRIENDLY_IS_CC
= 15, // DispelType, Radius, RepeatMin, RepeatMax
52 EVENT_T_FRIENDLY_MISSING_BUFF
= 16, // SpellId, Radius, RepeatMin, RepeatMax
53 EVENT_T_SUMMONED_UNIT
= 17, // CreatureId, RepeatMin, RepeatMax
54 EVENT_T_TARGET_MANA
= 18, // ManaMax%, ManaMin%, RepeatMin, RepeatMax
55 EVENT_T_QUEST_ACCEPT
= 19, // QuestID
56 EVENT_T_QUEST_COMPLETE
= 20, //
57 EVENT_T_REACHED_HOME
= 21, // NONE
58 EVENT_T_RECEIVE_EMOTE
= 22, // EmoteId, Condition, CondValue1, CondValue2
63 enum EventAI_ActionType
65 ACTION_T_NONE
= 0, // No action
66 ACTION_T_TEXT
= 1, // TextId1, optionally -TextId2, optionally -TextId3(if -TextId2 exist). If more than just -TextId1 is defined, randomize. Negative values.
67 ACTION_T_SET_FACTION
= 2, // FactionId (or 0 for default)
68 ACTION_T_MORPH_TO_ENTRY_OR_MODEL
= 3, // Creature_template entry(param1) OR ModelId (param2) (or 0 for both to demorph)
69 ACTION_T_SOUND
= 4, // SoundId
70 ACTION_T_EMOTE
= 5, // EmoteId
71 ACTION_T_RANDOM_SAY
= 6, // UNUSED
72 ACTION_T_RANDOM_YELL
= 7, // UNUSED
73 ACTION_T_RANDOM_TEXTEMOTE
= 8, // UNUSED
74 ACTION_T_RANDOM_SOUND
= 9, // SoundId1, SoundId2, SoundId3 (-1 in any field means no output if randomed that field)
75 ACTION_T_RANDOM_EMOTE
= 10, // EmoteId1, EmoteId2, EmoteId3 (-1 in any field means no output if randomed that field)
76 ACTION_T_CAST
= 11, // SpellId, Target, CastFlags
77 ACTION_T_SUMMON
= 12, // CreatureID, Target, Duration in ms
78 ACTION_T_THREAT_SINGLE_PCT
= 13, // Threat%, Target
79 ACTION_T_THREAT_ALL_PCT
= 14, // Threat%
80 ACTION_T_QUEST_EVENT
= 15, // QuestID, Target
81 ACTION_T_CAST_EVENT
= 16, // QuestID, SpellId, Target - must be removed as hack?
82 ACTION_T_SET_UNIT_FIELD
= 17, // Field_Number, Value, Target
83 ACTION_T_SET_UNIT_FLAG
= 18, // Flags (may be more than one field OR'd together), Target
84 ACTION_T_REMOVE_UNIT_FLAG
= 19, // Flags (may be more than one field OR'd together), Target
85 ACTION_T_AUTO_ATTACK
= 20, // AllowAttackState (0 = stop attack, anything else means continue attacking)
86 ACTION_T_COMBAT_MOVEMENT
= 21, // AllowCombatMovement (0 = stop combat based movement, anything else continue attacking)
87 ACTION_T_SET_PHASE
= 22, // Phase
88 ACTION_T_INC_PHASE
= 23, // Value (may be negative to decrement phase, should not be 0)
89 ACTION_T_EVADE
= 24, // No Params
90 ACTION_T_FLEE_FOR_ASSIST
= 25, // No Params
91 ACTION_T_QUEST_EVENT_ALL
= 26, // QuestID
92 ACTION_T_CAST_EVENT_ALL
= 27, // CreatureId, SpellId
93 ACTION_T_REMOVEAURASFROMSPELL
= 28, // Target, Spellid
94 ACTION_T_RANGED_MOVEMENT
= 29, // Distance, Angle
95 ACTION_T_RANDOM_PHASE
= 30, // PhaseId1, PhaseId2, PhaseId3
96 ACTION_T_RANDOM_PHASE_RANGE
= 31, // PhaseMin, PhaseMax
97 ACTION_T_SUMMON_ID
= 32, // CreatureId, Target, SpawnId
98 ACTION_T_KILLED_MONSTER
= 33, // CreatureId, Target
99 ACTION_T_SET_INST_DATA
= 34, // Field, Data
100 ACTION_T_SET_INST_DATA64
= 35, // Field, Target
101 ACTION_T_UPDATE_TEMPLATE
= 36, // Entry, Team
102 ACTION_T_DIE
= 37, // No Params
103 ACTION_T_ZONE_COMBAT_PULSE
= 38, // No Params
104 ACTION_T_CALL_FOR_HELP
= 39, // Radius
105 ACTION_T_SET_SHEATH
= 40, // Sheath (0-passive,1-melee,2-ranged)
112 TARGET_T_SELF
= 0, //Self cast
114 //Hostile targets (if pet then returns pet owner)
115 TARGET_T_HOSTILE
, //Our current target (ie: highest aggro)
116 TARGET_T_HOSTILE_SECOND_AGGRO
, //Second highest aggro (generaly used for cleaves and some special attacks)
117 TARGET_T_HOSTILE_LAST_AGGRO
, //Dead last on aggro (no idea what this could be used for)
118 TARGET_T_HOSTILE_RANDOM
, //Just any random target on our threat list
119 TARGET_T_HOSTILE_RANDOM_NOT_TOP
, //Any random target except top threat
121 //Invoker targets (if pet then returns pet owner)
122 TARGET_T_ACTION_INVOKER
, //Unit who caused this Event to occur (only works for EVENT_T_AGGRO, EVENT_T_KILL, EVENT_T_DEATH, EVENT_T_SPELLHIT, EVENT_T_OOC_LOS, EVENT_T_FRIENDLY_HP, EVENT_T_FRIENDLY_IS_CC, EVENT_T_FRIENDLY_MISSING_BUFF)
124 //Hostile targets (including pets)
125 TARGET_T_HOSTILE_WPET
, //Current target (can be a pet)
126 TARGET_T_HOSTILE_WPET_SECOND_AGGRO
, //Second highest aggro (generaly used for cleaves and some special attacks)
127 TARGET_T_HOSTILE_WPET_LAST_AGGRO
, //Dead last on aggro (no idea what this could be used for)
128 TARGET_T_HOSTILE_WPET_RANDOM
, //Just any random target on our threat list
129 TARGET_T_HOSTILE_WPET_RANDOM_NOT_TOP
, //Any random target except top threat
131 TARGET_T_ACTION_INVOKER_WPET
,
138 CAST_INTURRUPT_PREVIOUS
= 0x01, //Interrupt any spell casting
139 CAST_TRIGGERED
= 0x02, //Triggered (this makes spell cost zero mana and have no cast time)
140 CAST_FORCE_CAST
= 0x04, //Forces cast even if creature is out of mana or out of range
141 CAST_NO_MELEE_IF_OOM
= 0x08, //Prevents creature from entering melee if out of mana or out of range
142 CAST_FORCE_TARGET_SELF
= 0x10, //Forces the target to cast this spell on itself
143 CAST_AURA_NOT_PRESENT
= 0x20, //Only casts the spell if the target does not have an aura from the spell
148 EFLAG_REPEATABLE
= 0x01, //Event repeats
149 EFLAG_NORMAL
= 0x02, //Event only occurs in Normal instance difficulty
150 EFLAG_HEROIC
= 0x04, //Event only occurs in Heroic instance difficulty
151 EFLAG_RESERVED_3
= 0x08,
152 EFLAG_RESERVED_4
= 0x10,
153 EFLAG_RESERVED_5
= 0x20,
154 EFLAG_RESERVED_6
= 0x40,
155 EFLAG_DEBUG_ONLY
= 0x80, //Event only occurs in debug build
158 enum SpawnedEventMode
160 SPAWNED_EVENT_ALWAY
= 0,
161 SPAWNED_EVENT_MAP
= 1,
162 SPAWNED_EVENT_ZONE
= 2
165 // String text additional data, used in (CreatureEventAI)
166 struct StringTextData
174 typedef UNORDERED_MAP
<int32
, StringTextData
> CreatureEventAI_TextMap
;
176 struct CreatureEventAI_Action
178 EventAI_ActionType type
: 16;
188 // ACTION_T_SET_FACTION = 2
191 uint32 factionId
; // faction or 0 for default)
193 // ACTION_T_MORPH_TO_ENTRY_OR_MODEL = 3
196 uint32 creatureId
; // set one from fields (or 0 for both to demorph)
199 // ACTION_T_SOUND = 4
204 // ACTION_T_EMOTE = 5
209 // ACTION_T_RANDOM_SOUND = 9
212 int32 soundId1
; // (-1 in any field means no output if randomed that field)
216 // ACTION_T_RANDOM_EMOTE = 10
219 int32 emoteId1
; // (-1 in any field means no output if randomed that field)
223 // ACTION_T_CAST = 11
230 // ACTION_T_SUMMON = 12
237 // ACTION_T_THREAT_SINGLE_PCT = 13
243 // ACTION_T_THREAT_ALL_PCT = 14
248 // ACTION_T_QUEST_EVENT = 15
254 // ACTION_T_CAST_EVENT = 16
261 // ACTION_T_SET_UNIT_FIELD = 17
268 // ACTION_T_SET_UNIT_FLAG = 18, // value provided mask bits that will be set
269 // ACTION_T_REMOVE_UNIT_FLAG = 19, // value provided mask bits that will be clear
275 // ACTION_T_AUTO_ATTACK = 20
278 uint32 state
; // 0 = stop attack, anything else means continue attacking
280 // ACTION_T_COMBAT_MOVEMENT = 21
283 uint32 state
; // 0 = stop combat based movement, anything else continue attacking
285 // ACTION_T_SET_PHASE = 22
290 // ACTION_T_INC_PHASE = 23
295 // ACTION_T_QUEST_EVENT_ALL = 26
300 // ACTION_T_CAST_EVENT_ALL = 27
306 // ACTION_T_REMOVEAURASFROMSPELL = 28
312 // ACTION_T_RANGED_MOVEMENT = 29
318 // ACTION_T_RANDOM_PHASE = 30
325 // ACTION_T_RANDOM_PHASE_RANGE = 31
330 } random_phase_range
;
331 // ACTION_T_SUMMON_ID = 32
338 // ACTION_T_KILLED_MONSTER = 33
344 // ACTION_T_SET_INST_DATA = 34
350 // ACTION_T_SET_INST_DATA64 = 35
356 // ACTION_T_UPDATE_TEMPLATE = 36
362 // ACTION_T_CALL_FOR_HELP = 39
367 // ACTION_T_SET_SHEATH = 40
382 struct CreatureEventAI_Event
388 uint32 event_inverse_phase_mask
;
390 EventAI_Type event_type
: 16;
391 uint8 event_chance
: 8;
392 uint8 event_flags
: 8;
397 // EVENT_T_TIMER_OOC = 1
407 // EVENT_T_TARGET_HP = 12
408 // EVENT_T_TARGET_MANA = 18
422 // EVENT_T_SPELLHIT = 8
426 uint32 schoolMask
; // -1 (==0xffffffff) is ok value for full mask, or must be more limited mask like (0 < 1) = 1 for normal/physical school
438 // EVENT_T_OOC_LOS = 10
446 // EVENT_T_SPAWNED = 11
450 uint32 conditionValue1
;
452 // EVENT_T_TARGET_CASTING = 13
458 // EVENT_T_FRIENDLY_HP = 14
466 // EVENT_T_FRIENDLY_IS_CC = 15
469 uint32 dispelType
; // unused ?
474 // EVENT_T_FRIENDLY_MISSING_BUFF = 16
482 // EVENT_T_SUMMONED_UNIT = 17
489 // EVENT_T_QUEST_ACCEPT = 19
490 // EVENT_T_QUEST_COMPLETE = 20
495 // EVENT_T_RECEIVE_EMOTE = 22
500 uint32 conditionValue1
;
501 uint32 conditionValue2
;
514 CreatureEventAI_Action action
[MAX_ACTIONS
];
517 typedef UNORDERED_MAP
<uint32
, std::vector
<CreatureEventAI_Event
> > CreatureEventAI_Event_Map
;
519 struct CreatureEventAI_Summon
527 uint32 SpawnTimeSecs
;
531 typedef UNORDERED_MAP
<uint32
, CreatureEventAI_Summon
> CreatureEventAI_Summon_Map
;
533 struct CreatureEventAIHolder
535 CreatureEventAIHolder(CreatureEventAI_Event p
) : Event(p
), Time(0), Enabled(true){}
537 CreatureEventAI_Event Event
;
542 bool UpdateRepeatTimer(Creature
* creature
, uint32 repeatMin
, uint32 repeatMax
);
545 class MANGOS_DLL_SPEC CreatureEventAI
: public CreatureAI
549 explicit CreatureEventAI(Creature
*c
);
552 CreatureEventAIList
.clear();
554 void JustRespawned();
556 void JustReachedHome();
557 void EnterCombat(Unit
*enemy
);
558 void EnterEvadeMode();
559 void JustDied(Unit
* killer
);
560 void KilledUnit(Unit
* victim
);
561 void JustSummoned(Creature
* pUnit
);
562 void AttackStart(Unit
*who
);
563 void MoveInLineOfSight(Unit
*who
);
564 void SpellHit(Unit
* pUnit
, const SpellEntry
* pSpell
);
565 void UpdateAI(const uint32 diff
);
566 bool IsVisible(Unit
*) const;
567 void ReceiveEmote(Player
* pPlayer
, uint32 text_emote
);
568 static int Permissible(const Creature
*);
570 bool ProcessEvent(CreatureEventAIHolder
& pHolder
, Unit
* pActionInvoker
= NULL
);
571 void ProcessAction(CreatureEventAI_Action
const& action
, uint32 rnd
, uint32 EventId
, Unit
* pActionInvoker
);
572 inline uint32
GetRandActionParam(uint32 rnd
, uint32 param1
, uint32 param2
, uint32 param3
);
573 inline int32
GetRandActionParam(uint32 rnd
, int32 param1
, int32 param2
, int32 param3
);
574 inline Unit
* GetTargetByType(uint32 Target
, Unit
* pActionInvoker
);
575 inline Unit
* SelectUnit(AttackingTarget target
, uint32 position
);
577 void DoScriptText(int32 textEntry
, WorldObject
* pSource
, Unit
* target
);
578 void DoZoneInCombat(Unit
* pUnit
);
579 void DoMeleeAttackIfReady();
580 bool CanCast(Unit
* Target
, SpellEntry
const *Spell
, bool Triggered
);
582 bool SpawnedEventConditionsCheck(CreatureEventAI_Event
const& event
);
584 Unit
* DoSelectLowestHpFriendly(float range
, uint32 MinHPDiff
);
585 void DoFindFriendlyMissingBuff(std::list
<Creature
*>& _list
, float range
, uint32 spellid
);
586 void DoFindFriendlyCC(std::list
<Creature
*>& _list
, float range
);
588 //Holder for events (stores enabled, time, and eventid)
589 std::list
<CreatureEventAIHolder
> CreatureEventAIList
;
590 uint32 EventUpdateTime
; //Time between event updates
591 uint32 EventDiff
; //Time between the last event call
594 //Variables used by Events themselves
595 uint8 Phase
; //Current phase, max 32 phases
596 bool CombatMovementEnabled
; //If we allow targeted movment gen (movement twoards top threat)
597 bool MeleeEnabled
; //If we allow melee auto attack
598 uint32 AttackDistance
; //Distance to attack from
599 float AttackAngle
; //Angle of attack