<-返回:World 数据库

The smart_scripts table has 31 attributes. It serves to make scripts in SQL language. The important thing is always to analyze, who is the event that motivates the execution of an action and of course, who is the objective. As a recommendation, you can review the scripts that are already inside the table, to understand how it works. The advantage, for which several use this method, is that it is not required to compile, when adding records, with restarting the server, if it is well programmed, you can appreciate the changes. Another reason is the portability, but it depends on the point of view of the developer, the response you can get.

表结构

• EntryOrGuid > 0: entry of the creature / game object / etc.
• EntryOrGuid < 0: guid of the creature / game object / etc.
• Depends on source_type.

When using GUID-specific SAI, the extra_flag DONT_OVERRIDE_SAI_ENTRY allows us to not require duplicating rows shared between all creatures of the same entry.

For example, you can keep all movement-related scripting in the GUID script, while combat scripting is handled by the ENTRY script.

For creatures that use this flag, SAI row IDs cannot overlap, thus we use row IDs starting with 1000 and incrementing it (e.g. 1000, 1001, 1002, …).

Object type: creature, game object, spell. see table below for values

Incremental id bound to each entryorguid & source_type (0, 1, 2, …).

Simple event linking;

• Example: if id = 0 and link = 1; id 1 will only be able to occur if id = 0 was triggered (id 1 has to use event_type SMART_EVENT_LINK).
• Smart_event to be used.

Thanks to the use of links, you can execute several actions, keeping the same event.

When dealing with phases, phase IDs have to be used. There are 13 (12+1) different phases: 1, 2, … 12 and the default 0.

Example: The script is in phase 0 by default - If we want it to go to phase 1, we got two choices:

• SMART_ACTION_INC_PHASE by 1 or SMART_ACTION_SET_PHASE 1

If the script is in phase 0 and want to skip to phase 2:

• SMART_ACTION_INC_PHASE by 2 or SMART_ACTION_SET_PHASE 2

If the script is in phase 1 and want to skip to phase 2:

• SMART_ACTION_INC_PHASE by 1 or SMART_ACTION_SET_PHASE 2

^Name^Flag^Hex^Comment^

• Event will only be able to occur if creature/GO is in this phase.
• Example: If we want an event to only be able to occure in phase 1 and 4, event_phase_mask = 1+8 = 9

This is the probability of the event to occur as a percentage from 0-100. So, if you want the event to occur roughly half of the time, then set this to 50.

Sets if the event should not repeat or should only happen in a given instance/dungeon difficulty (if applicable); Values can be added together (bitwise math).

Description Name Value (Param1) Param2 Param3 Param4 Param5 Param6 Comment SMARTAI_TEMPLATE_BASIC 0 SMARTAI_TEMPLATE_CASTER 1 spellid repeatMin repeatMax range manaPCT +JOIN: target_param1 as castFlag SMARTAI_TEMPLATE_TURRET 2 spellid repeatMin repeatMax range manaPCT +JOIN: target_param1 as castflag SMARTAI_TEMPLATE_PASSIVE 3 SMARTAI_TEMPLATE_CAGED_GO_PART 4 creatureID give credit at point end (0/1) SMARTAI_TEMPLATE_CAGED_NPC_PART 5 gameObjectID despawntime run (0/1) dist TextGroupID

Name Value target_param1 target_param2 target_param3 target_param4 target_x target_y target_z target_o Comment SMART_TARGET_NONE 0 None. SMART_TARGET_SELF 1 Self cast. SMART_TARGET_VICTIM 2 Our current target. (ie: highest aggro) SMART_TARGET_HOSTILE_SECOND_AGGRO 3 Max Range (0: Unlimited) Player Only (0/1) Power Type + 1 Missing Aura Second highest aggro. SMART_TARGET_HOSTILE_LAST_AGGRO 4 Max Range (0: Unlimited) Player Only (0/1) Power Type + 1 Missing Aura Dead last on aggro. SMART_TARGET_HOSTILE_RANDOM 5 Max Range (0: Unlimited) Player Only (0/1) Power Type + 1 Missing Aura Just any random target on our threat list. SMART_TARGET_HOSTILE_RANDOM_NOT_TOP 6 Max Range (0: Unlimited) Player Only (0/1) Power Type + 1 Missing Aura Any random target except top threat. SMART_TARGET_ACTION_INVOKER 7 Unit who caused this Event to occur. SMART_TARGET_POSITION 8 x y z o Use xyz from event params. SMART_TARGET_CREATURE_RANGE 9 creature_template.entry (0 any) minDist maxDist alive state (1 alive, 2 dead, 0 both) All creatures with the specified ID within the specified range and the specified alive state. SMART_TARGET_CREATURE_GUID 10 creature.guid creature_template.entry getFromHashMap (0/1, this does not work in instances!) Creature with specified GUID and/or specified creature template ID. SMART_TARGET_CREATURE_DISTANCE 11 creature_template.entry (0 any) maxDist alive state (1 alive, 2 dead, 0 both) All creatures with the specified ID within the specified distance and the specified alive state. SMART_TARGET_STORED 12 id Uses pre-stored target(list) SMART_TARGET_GAMEOBJECT_RANGE 13 gameobject_template.entry (0 any) minDist maxDist All game objects with the specified ID within the specified range. SMART_TARGET_GAMEOBJECT_GUID 14 gameobject.guid gameobject_template.entry getFromHashMap (0/1, this does not work in instances!) Object with specified GUID and/or specified game object template ID. SMART_TARGET_GAMEOBJECT_DISTANCE 15 gameobject_template.entry (0 any) maxDist All objects with the specified ID within the specified distance. SMART_TARGET_INVOKER_PARTY 16 Invoker's party members SMART_TARGET_PLAYER_RANGE 17 minDist maxDist maxCount When target.o is set and it didnt find any targets in min-max range, it will try all possible targets in max range instead. All players up to maxCount within the specified range. Excluding GMs and Dead. SMART_TARGET_PLAYER_DISTANCE 18 maxDist All players within the specified distance. SMART_TARGET_CLOSEST_CREATURE 19 creature_template.entry (0 any) maxDist (Can be from 0-100 yards) dead? (0/1) Closest creature with the specified ID within the specified range. SMART_TARGET_CLOSEST_GAMEOBJECT 20 gameobject_template.entry (0 any) maxDist (Can be from 0-100 yards) Closest object with specified ID within specified range. SMART_TARGET_CLOSEST_PLAYER 21 maxDist Closest player within specified range. SMART_TARGET_ACTION_INVOKER_VEHICLE 22 Unit's vehicle who caused this Event to occur SMART_TARGET_OWNER_OR_SUMMONER 23 use owner of owner (0/1) Unit's owner or summoner SMART_TARGET_THREAT_LIST 24 maxDist (0 any) All units on creature's threat list within the specified distance if maxDist > 0 SMART_TARGET_CLOSEST_ENEMY 25 maxDist playerOnly (0/1) Any attackable target (creature or player) within maxDist SMART_TARGET_CLOSEST_FRIENDLY 26 maxDist playerOnly (0/1) Any friendly unit (creature, player or pet) within maxDist SMART_TARGET_LOOT_RECIPIENTS 27 All players that have tagged this creature (for kill credit) SMART_TARGET_FARTHEST 28 maxDist playerOnly (0/1) isInLos (0/1) Farthest unit on the threat list SMART_TARGET_VEHICLE_PASSENGER 29 seat number (vehicle can target it's own accessory) SMART_TARGET_PLAYER_WITH_AURA 201 spellID Negative (0/1) MaxDist MinDist Number to resize the target list Target players with or without aura SMART_TARGET_RANDOM_POINT 202 range (yards) amount (for summoning creature) self as middle (0/1) else use xyz This only works with SMART_ACTION_SUMMON_CREATURE, SMART_ACTION_MOVE_TO_POS and SMART_ACTION_JUMP_TO_POS SMART_TARGET_ROLE_SELECTION 203 rangeMax (yards) TargetMask (Tanks (1), Healer (2) Damage (4)) Resize list Target a Tank/Healer/DPS role. Based on the players spec. SMART_TARGET_SUMMONED_CREATURES 204 creature_template.Entry SMART_TARGET_INSTANCE_STORAGE 205 data index Type (creature (1), gameobject (2))

Commenting on SAI uses a template which is the following: (with an example)

“Creature name - Event - Action”

“Minion of Gurok - On spawn - Set Random Movement”

Quick notes:

Always update creature_template,gameobject_template or areatrigger_scripts with: UPDATE `creature_template` SET `AIName` = 'SmartAI' WHERE `entry` = y;

UPDATE `gameobject_template` SET `AIName` = 'SmartGameObjectAI' WHERE `entry` = y;

INSERT INTO `areatrigger_scripts` (`entry`, `ScriptName`) VALUES (y, 'SmartTrigger'); If the creature or GO is inside a dungeon, set event_flags accordingly to the instance difficulty (heroic, 25 man, etc.). In case of doubt about an Event, Action_or _Target,_check source code (_src/server/game/AI/SmartScripts files; mainly *SmartScript.cpp)

Name Flag Hex Comment SMARTCAST_INTERRUPT_PREVIOUS 1 0x001 Interrupt any spell casting SMARTCAST_TRIGGERED 2 0x002 Triggered (this makes spell cost zero mana and have no cast time) SMARTCAST_AURA_NOT_PRESENT 32 0x020 Only casts the spell if the target does not have an aura from the spell SMARTCAST_COMBAT_MOVE 64 0x040 Prevent combat movement on cast, allow on fail range, mana, LOS SMARTCAST_THREATLIST_NOT_SINGLE 128 0x080 Only cast if the source's threatlist is higher than one. This includes pets SMARTCAST_TARGET_POWER_MANA 256 0x100 Only cast if the target has power type mana

Name Flag Hex Comment TRIGGERED_NONE 0 0x00000000 Not triggered TRIGGERED_IGNORE_GCD 1 0x00000001 Will ignore GCD TRIGGERED_IGNORE_SPELL_AND_CATEGORY_CD 2 0x00000002 Will ignore Spell and Category cooldowns TRIGGERED_IGNORE_POWER_AND_REAGENT_COST 4 0x00000004 Will ignore power and reagent cost TRIGGERED_IGNORE_CAST_ITEM 8 0x00000008 Will not take away cast item or update related achievement criteria RIGGERED_IGNORE_AURA_SCALING 16 0x00000010 Will ignore aura scaling TRIGGERED_IGNORE_CAST_IN_PROGRESS 32 0x00000020 Will not check if a current cast is in progress TRIGGERED_IGNORE_COMBO_POINTS 64 0x00000040 Will ignore combo point requirement TRIGGERED_CAST_DIRECTLY 128 0x00000080 In Spell::prepare, will be cast directly without setting containers for executed spell TRIGGERED_IGNORE_AURA_INTERRUPT_FLAGS 256 0x00000100 Will ignore interruptible aura's at cast TRIGGERED_IGNORE_SET_FACING 512 0x00000200 Will not adjust facing to target (if any) TRIGGERED_IGNORE_SHAPESHIFT 1024 0x00000400 Will ignore shapeshift checks TRIGGERED_IGNORE_CASTER_AURASTATE 2048 0x00000800 Will ignore caster aura states including combat requirements and death state TRIGGERED_IGNORE_CASTER_MOUNTED_OR_ON_VEHICLE 8192 0x00002000 Will ignore mounted/on vehicle restrictions TRIGGERED_IGNORE_CASTER_AURAS 65536 0x00010000 Will ignore caster aura restrictions or requirements TRIGGERED_DISALLOW_PROC_EVENTS 131072 0x00020000 Disallows proc events from triggered spell (default) TRIGGERED_DONT_REPORT_CAST_ERROR 262144 0x00040000 Will return SPELL_FAILED_DONT_REPORT in CheckCast functions TRIGGERED_FULL_MASK 524287 0x0007FFFF All triggered flags TRIGGERED_IGNORE_EQUIPPED_ITEM_REQUIREMENT 524288 0x00080000 Will ignore equipped item requirements TRIGGERED_NO_PERIODIC_RESET 1048576 0x00100000 Periodic aura tick wont be reset on override TRIGGERED_FULL_DEBUG_MASK 4294967295 0xFFFFFFFF NOTICE: If triggeredFlags = 0, cast will trigger with TRIGGERED_FULL_MASK = 524287.

Name Value Comment REACT_PASSIVE 0 Does not defend or attack at all. Does nothing. REACT_DEFENSIVE 1 Only attacks back when attacked. REACT_AGGRESSIVE 2 Will attack if on threat list and in threat radius. (default)

Name Value Comment TEMPSUMMON_TIMED_OR_DEAD_DESPAWN 1 Despawns after a specified time OR when the creature disappears. TEMPSUMMON_TIMED_OR_CORPSE_DESPAWN 2 Despawns after a specified time OR when the creature dies. TEMPSUMMON_TIMED_DESPAWN 3 Despawns after a specified time. TEMPSUMMON_TIMED_DESPAWN_OUT_OF_COMBAT 4 Despawns after a specified time after the creature is out of combat. TEMPSUMMON_CORPSE_DESPAWN 5 Despawns instantly after death. TEMPSUMMON_CORPSE_TIMED_DESPAWN 6 Despawns after a specified time after death. TEMPSUMMON_DEAD_DESPAWN 7 Despawns when the creature disappears. TEMPSUMMON_MANUAL_DESPAWN 8 Despawns when UnSummon() (or Force Despawn action) is called.

Name Value Comment FOLLOW_TYPE_CIRCLE 1 360º Degrees around leader. 90º Degrees is the maximum angle. FOLLOW_TYPE_SEMI_CIRCLE_BEHIND 2 180º Degrees behind leader. FOLLOW_TYPE_SEMI_CIRCLE_FRONT 3 180º Degrees in front of leader. FOLLOW_TYPE_LINE 4 Front → Back → Front → Back. FOLLOW_TYPE_COLUMN 5 Left → Right → Left → Right. FOLLOW_TYPE_ANGULAR 6 Geese-like formation 135º and 225º degrees behind leader.

Name Value POWER_MANA 0 POWER_RAGE 1 POWER_FOCUS 2 POWER_ENERGY 3

white list of events that actually have an invoker passed to them

Actions like SMART_ACTION_INVOKER_CAST and targets like SMART_TARGET_ACTION_INVOKER will work only if the event is in this list:

• SMART_EVENT_AGGRO
• SMART_EVENT_DEATH
• SMART_EVENT_KILL
• SMART_EVENT_SUMMONED_UNIT
• SMART_EVENT_SPELLHIT
• SMART_EVENT_SPELLHIT_TARGET
• SMART_EVENT_DAMAGED
• SMART_EVENT_RECEIVE_HEAL
• SMART_EVENT_RECEIVE_EMOTE
• SMART_EVENT_JUST_SUMMONED
• SMART_EVENT_DAMAGED_TARGET
• SMART_EVENT_SUMMON_DESPAWNED
• SMART_EVENT_PASSENGER_BOARDED
• SMART_EVENT_PASSENGER_REMOVED
• SMART_EVENT_GOSSIP_HELLO
• SMART_EVENT_GOSSIP_SELECT
• SMART_EVENT_ACCEPTED_QUEST
• SMART_EVENT_REWARD_QUEST
• SMART_EVENT_FOLLOW_COMPLETED
• SMART_EVENT_ON_SPELLCLICK
• SMART_EVENT_GO_LOOT_STATE_CHANGED
• SMART_EVENT_AREATRIGGER_ONTRIGGER
• SMART_EVENT_IC_LOS
• SMART_EVENT_OOC_LOS
• SMART_EVENT_DISTANCE_CREATURE
• SMART_EVENT_FRIENDLY_HEALTH
• SMART_EVENT_FRIENDLY_HEALTH_PCT
• SMART_EVENT_FRIENDLY_IS_CC
• SMART_EVENT_FRIENDLY_MISSING_BUFF
• SMART_EVENT_ACTION_DONE
• SMART_EVENT_TARGET_HEALTH_PCT
• SMART_EVENT_TARGET_MANA_PCT
• SMART_EVENT_RANGE
• SMART_EVENT_VICTIM_CASTING
• SMART_EVENT_TARGET_BUFFED
• SMART_EVENT_IS_BEHIND_TARGET
• SMART_EVENT_INSTANCE_PLAYER_ENTER
• SMART_EVENT_TRANSPORT_ADDCREATURE
• SMART_EVENT_DATA_SET
• SMART_EVENT_AREA_CASTING
• SMART_EVENT_AREA_RANGE