Просмотр

{| align="right"
| __TOC__
|}
Back to [[mangosdb_struct|world database]] list of tables.


<big>'''The `*_scripts` table'''</big>

This table format is used for 5 different tables to control possible scripts activated by different actions:
* '''gameobject_scripts:''' Holds possible scripts activated by gameobjects of type GAMEOBJECT_TYPE_BUTTON (1).

* '''spell_scripts:''' Holds scripts that can be activated by spells with effect SPELL_EFFECT_SCRIPT_EFFECT (77).

* '''quest_start_scripts:''' Holds scripts activated when a player accepts a quest.

* '''quest_end_scripts:''' Holds scripts activated when a player finishes a quest.

* '''event_scripts:''' Holds scripts activated whenever an event is activated, be it by an object or as the spell effect SPELL_EFFECT_SEND_EVENT (61).

NOTE: An entry in this table may have more than one row as a script may do more than just one action. Also each action the script may make can have a separate delay attached to it. In that case, the core will activate the appropriate action after the correct delay.

<big>'''Structure'''</big>
{| border="1"
|'''Field'''
|'''Type'''
|'''Null'''
|'''Key'''
|'''Default'''
|'''Extra'''
|-
|[[#id|id]]
|int(11) unsigned
|NO
|
|0
|
|-
|[[#delay|delay]]
|int(11) unsigned
|NO
|
|0
|
|-
|[[#command|command]]
|int(11) unsigned
|NO
|
|0
|
|-
|[[#OtherFields|datalong]]
|int(11) unsigned
|NO
|
|0
|
|-
|[[#OtherFields|datalong2]]
|int(11) unsigned
|NO
|
|0
|
|-
|[[#OtherFields|dataint]]
|int(11)
|NO
|
|0
|
|-
|[[#OtherFields|x]]
|float
|NO
|
|0
|
|-
|[[#OtherFields|y]]
|float
|NO
|
|0
|
|-
|[[#OtherFields|z]]
|float
|NO
|
|0
|
|-
|[[#OtherFields|o]]
|float
|NO
|
|0
|
|}


<big>'''Description of the fields'''</big>
====id====
For '''gameobject_scripts''', it is the guid of the button/lever. See [[gameobject#guid|gameobject.guid]].<br>
For '''spell_scripts''', it is the spell ID. See Spell.dbc<br>
For '''quest_*_scripts''', it is the ID that is used in [[quest_template#StartScript|StartScript]] or [[quest_template#CompleteScript|CompleteScript]] in the quest template definition.<br>
For '''event_scripts''', it is the event ID. There doesn't exist currently a full list of events. In any case, the event IDs are taken directly from gameobject WDB data or spell effect data. If both a gameobject and a spell activate the same event, the IDs will match.

====delay====
Delay in seconds before this current step of the script activates. 0 = instant.

====command====
The type of action performed by the script after [[#delay|delay]] seconds have passed. The value of this field affects what other fields also need to be set.

The following commands can be used:
{| border=1 cellpadding=3 cellspacing=0
! Command !! Name !! Description
|-
| 0 || TALK || Creature say/whisper/yell/textemote.
|-
| 1 || EMOTE || Play emote on creature.
|-
| 2 || FIELD_SET || Change the value at an index for the player.
|-
| 3 || MOVE_TO || Relocate creature to a destination
|-
| 4 || FLAG_SET || Turns on bits on a flag field at an index for the player.
|-
| 5 || FLAG_REMOVE || Turns off bits on a flag field at an index for the player. 
|-
| 6 || TELEPORT_TO || Teleports the player to a location.
|-
| 7 || QUEST_EXPLORED || Satisfies the explore requirement for a quest.
|-
| 8 || KILL_CREDIT || Satisfies the kill credit requirement for a quest.
|-
| 9 || RESPAWN_GAMEOBJECT || Spawns a despawned gameobject.
|-
| 10 || TEMP_SUMMON_CREATURE || Temporarily summon a creature.
|-
| 11 || OPEN_DOOR || Opens a door gameobject (type == 0).
|-
| 12 || CLOSE_DOOR || Closes a door gameobject (type == 0).
|-
| 13 || ACTIVATE_OBJECT || Activates an object.
|-
| 14 || REMOVE_AURA || Removes an aura due to a spell.
|-
| 15 || CAST_SPELL || Casts a spell. 
|}

====OtherFields====
Depending on what command was used, the meaning and use for the following fields varies.

* '''SCRIPT_COMMAND_TALK = 0'''
** datalong: 0=say, 1=whisper, 2=yell, 3=text emote
** dataint: The text ID that the creature will say. See [[db_script_string]]. ID must be between 2000000000 and 2000010000.


* '''SCRIPT_COMMAND_EMOTE = 1'''
** datalong: The emote ID to play.


* '''SCRIPT_COMMAND_FIELD_SET = 2'''
** datalong: Index of the field.
** datalong2: Value to place at the index.


* '''SCRIPT_COMMAND_MOVE_TO = 3'''
** datalong2: Length of the motion.
** x: X position to move to.
** y: Y position to move to.
** z: Z position to move to.
** o: Orientation to face.


* '''SCRIPT_COMMAND_FLAG_SET = 4'''
** datalong:   Field index to be set.
** datalong2:  Flag bit(s) to set.


* '''SCRIPT_COMMAND_FLAG_REMOVE = 5'''
** datalong:   Field index to be unset.
** datalong2:  Flag bit(s) to unset.


* '''SCRIPT_COMMAND_TELEPORT_TO = 6'''
** datalong:   Target Map ID. See [[Maps.dbc]]
** x:          Teleport target x coordinate.
** y:          Teleport target y coordinate.
** z:          Teleport target z coordinate.
** o:          Teleport target orientation.


* '''SCRIPT_COMMAND_QUEST_EXPLORED = 7'''
** datalong:   Quest ID whose external status should be satisfied
** datalong2:  Distance away from the NPC/object that the player can be and have the script still take effect


* '''SCRIPT_COMMAND_KILL_CREDIT = 8'''
** datalong:   Kill credit entry for quest (entry in quest_template.ReqCreatureOrGOId)
** datalong2:  0=personal credit, 1=group credit


* '''SCRIPT_COMMAND_RESPAWN_GAMEOBJECT = 9'''
** datalong:   Guid of the gameobject to respawn. See [[gameobject#guid|gameobject.guid]].
** datalong2:  Despawn time in seconds. If the value is < 5 seconds: 5 is used instead.


* '''SCRIPT_COMMAND_TEMP_SUMMON_CREATURE = 10'''
** datalong:   Entry of the summoned creature from [[creature_template#entry|creature_template.entry]].
** datalong2:  Despawn time in ms.
** x:          Summon target x coordinate.
** y:          Summon target y coordinate.
** z:          Summon target z coordinate.
** o:          Summon target orientation.


* '''SCRIPT_COMMAND_OPEN_DOOR = 11'''
** datalong:   Guid of the activated door. It's a [[gameobject#guid|gameobject.guid]].
** datalong2:  Delay before closing again the door. If the value is < 5 seconds: 5 is used instead.


* '''SCRIPT_COMMAND_CLOSE_DOOR = 12'''
** datalong:   Guid of the activated door. It's a [[gameobject#guid|gameobject.guid]].
** datalong2:  Delay before opening again the door. If the value is < 5 seconds: 5 is used instead.


* '''SCRIPT_COMMAND_ACTIVATE_OBJECT = 13'''
** The source must be a unit and the target a game object.


* '''SCRIPT_COMMAND_REMOVE_AURA = 14'''
** datalong: Spell ID.
** datalong2: If value > 0, then cast on the source; otherwise cast on the target.


* '''SCRIPT_COMMAND_CAST_SPELL = 15'''
** datalong: Spell ID.
** datalong2: If value > 0, then cast on the source; otherwise cast on the target.


* '''SCRIPT_COMMAND_PLAY_SOUND = 16'''
** datalong: sound_id.
** datalong2: bitmask: 0/1=anyone/target, 0/2=with distance dependent, so 1|2 = 3 is target with distance dependent.