AzerothCore
Pages :

creature_text

Table: creature_text

Short Description:

This table holds all the speech text (whisper, say, yell, emote text in speech bubbles and in the chat window) used within SMART_SCRIPTS table and core scripts.

Detailed Description:

Have you ever wondered how a boss like Sindragosa (→ wowhead) is scripted? There is no need to wonder, you can see it for yourself! (→ Sindragosa Script File)

I know, I know - this looks incredibly complex, over 1600 lines of code! However there is no need to understand everything at one time. Let's focus on something simple, but still very important, shall we? 

If you look at the beginning of the code you can find enum named Texts which is composed of 12 elements (numbers from 0 to 11), let's look closer at the first element of this enum:

boss_sindragosa.cpp  Expand source

 enum Texts
 {
     SAY_AGGRO = 0, // You are fools to have come to this place! The icy winds of Northrend will consume your souls!
     ...
 };

You can verify in game for yourself that Sindragosa will yell this when you start a fight versus her. Did you notice something interesting? Actual text is placed after a // which means that this information is comment and our compiler will ignore it. On the other hand we clearly see that she is yelling that text, how is it possible?

Where is this information stored? How can I find it?

You may say - well this is over 1600 lines long, for sure there must be something, we just didn't find it yet. I can assure you, you won't find anything, if you don't believe, use CTRL+F shortcut and have some fun with searching!

There is nothing? That's a shame, but maybe, maybe you had a chance to discover something?

boss_sindragosa.cpp  Expand source

 void EnterCombat(Unit* victim) override
 {
     ...
     Talk(SAY_AGGRO); // interesting!
 }

Do you see the last line of this function? They are using something which shouldn't work! We can conclude that this function will be called when Sindragosa is entering combat (look at function name!), so now we see why she is yelling at start.

There is still one fundamental question - where is information about this text stored? Answer is simpler than you might thought. It is stored in CREATURE_TEXT table!

to be continued...

Structure

Field Type Attributes Key Null Default Extra Comment
CreatureID MEDIUMINT UNSIGNED PRI NO creature_template entry
GroupID TINYINT UNSIGNED PRI NO
ID TINYINT UNSIGNED PRI NO
Text longtext utf8_general_ci YES NULL
Type TINYINT UNSIGNED NO
Language TINYINT UNSIGNED NO
Probability FLOAT SIGNED NO
Emote MEDIUMINT UNSIGNED NO
Duration MEDIUMINT UNSIGNED NO
Sound MEDIUMINT UNSIGNED NO
BroadcastTextId MEDIUMINT SIGNED NO
TextRange TINYINT UNSIGNED NO
comment VARCHAR(255) utf8_general_ci YES NULL

Description of the fields

CreatureID

This is the creature_template.entry to which the script is linked to.

GroupID

If there is more than one of the same entry (more than one text the creature says), this column is used to choose if it is a random say or an ordered list. If a creature has got more than one say text to be shown in a given order, it must be incremented for each new matching entry (ex. 0, 1, 2, 3...). If there is only one entry or only one group, this value should be 0. If there are multiple groups of texts, this value stays the same within the group while the id increments within the same group.

Example from Stormwind City Guard, creature 68:

CreatureID GroupID ID Text
68 0 0 Taste blade, mongrel!
68 0 1 Please tell me that you didn't just do what I think you just did. Please tell me that I'm not going to have to hurt you...
68 0 2 As if we don't have enough problems, you go and create more!
68 2 0 %s throws a rotten apple at $n.
68 3 0 %s throws rotten banana on $n.
68 4 0 %s spits on $n.
68 5 0 Monster!
68 5 1 Murderer!
68 5 2 GET A ROPE!
68 5 3 How dare you set foot in our city!
68 5 4 You disgust me.
68 5 5 Looks like we're going to have ourselves an execution.
68 5 6 Traitorous dog.
68 5 7 My family was wiped out by the Scourge! MONSTER!

ID

Entry for each group of texts. This is the unique identifier when entry (creature) is the same and groupid is unchanged, it must be incremented (ex. 0, 1, 2, 3...). A creature say will be randomly selected from this list based on the groupid it belongs to.

Text

The text the creature will say.

Type

Value Old value Localization Picture Example
12 0 Say Say
14 1 Yell Yell
16 2 Emote Emote
41 3 Boss Emote BossEmote
15 4 Whisper Whisper
42 5 Boss Whisper BossWhisper

Language

Value from Languages.dbc (+ the wiki table from the dbc file). When set to 0, the current default language will be used.

Probability

A value from 1-100 that represents the percentage chance that this text will be executed.

Value must be >=0. If the value does not meet the condition the SQL will fail on creature_text_chk_1.

Emote

The emote that the creature plays when the text is executed. Value to use in this field can be obtained from the emote.dbc

Duration

Time in ms to see text. 0 is default and calculated by core.

Sound

The sound entry this creature will play at the same time the text is executed. Sounds are found in SoundEntries.dbc.

BroadcastTextId

Id of the equivalent text found in broadcast_text

TextRange

Value Range
0 Normal/Default
1 Area
2 Zone
3 Map
4 World

comment

This field allows you to label a text entry.