characters

<-Back-to:Characters

The `characters` table

This table holds vital static information for each character. It is used to create the player objects in-game.

Structure

Description of the fields

The character global unique identifier. This number must be unique and is the best way to identify separate characters.

The account ID in which this character resides. See account.id in the auth database.

The name of the character. Max length is 12 characters.

The race of the character. See ChrRaces.dbc.

The class of the character: ChrClasses.dbc.

The gender of the character.

2 is seen in table creature_model_info notably.

The level of the character.

The amount of experience this character has earned towards the next level.

The amount of copper this character has.

Contains data about the skincolor of the character. skinColor = playerbytes  % 256

Contains data about the facestyle of the character. faceStyle = (playerbytes » 8) % 256

Contains data about the hairStyle of the character. hairStyle = (playerbytes » 16) % 256

Contains data about the haircolor of the character. hairColor = (playerbytes » 24) % 256

Contains data about facial hair of the character. facialHair = playerBytes2 % 256

field-no-description|15

field-no-description|16

A bitmask that represents what Player flags the player has. Each bit controls a different flag and to combine flags, you can add each flag that you want, in effect activating the respective bits.

The x position of the character's location.

The y position of the character's location.

The z position of the character's location.

The map ID the character is in.

The instance ID the character is currently in and bound to.

The current dungeon difficulty that the player is in. This field is bitmask. Values are put together, however, only two of four should be used at once. This description may not be 100% correct.

The orientation the character is facing. (North = 0.0, South = 3.14159)

Known taxi nodes separated with space.

Records whether the character is online (1) or offline (0).

Boolean 1 or 0 controlling whether the start cinematic has been shown or not.

The total time that the character has been active in the world, measured in seconds.

The total time the character has spent in the world at the current level, measured in seconds.

The time when the character last logged out, measured in Unix time.

Boolean 1 or 0 controlling if the character is currently in a resting zone or not.

The cumulated bonus of rested rate for gaining experience.

The cost for the character to reset its talents, measured in copper.

field-no-description|34

The x position of the transport this character was on when they were last saved.

The y position of the transport this character was on when they were last saved.

The z position of the transport this character was on when they were last saved.

The orientation of the transport this character was on when they were last saved.

The global unique identifier of the transport this character was on when they were last saved.

These flags control certain player specific attributes, mostly GM features.

The Stable Slots available (bought) at the Stable Master.

This field is a bitmask controlling different actions taken once a player logs in with the character.

For multiple actions, add values together.

The zone ID the character is in.

Time when a character can be resurrected in case of a server crash or client exit while in ghost form, measured in Unix time.

Stores the players current taxi path (TaxiPath.dbc) if logged off while on one.

The amount of arena points this character has stored up, and will receive next time arena points are distributed.

The amount of honor points this character has got.

The amount of honor points this character has gotten today.

The amount of honor points this character got yesterday.

The amount of players this character has killed.

The amount of players this character has killed today.

The amount of players this character killed yesterday.

Current title, using the bit_index field (InGameOrder in CharTitles.dbc).

Known currencies (what to be listed in the Currency tab), bitmask of BitIndexes, see CurrencyTypes.dbc.

Tracked faction at experience bar (using reputation ID, see Faction.dbc).

Character's drunk state, 0-100

• 0 = Sober
• 1-49 = Tipsy
• 50-89 = Drunk
• 90-100 = Smashed

The characters current health.

Current character powers (snapshot from when the character was saved).

This characters latency, or ping, in milliseconds, as of the last update.

The number of specs this character has access to. Default value is 1. Maximum currently supported value is 2. Should never be 0 (this is a sign of a character created before the dual spec system).

The currently activated spec for this character, spec = 0 is the first spec, spec = 1 is the second spec.

Bitmasks of explored zones (1 bit for explored, 0 bit for unexplored).

Character's equipment and bag cache.

Template ID of the ammo item.

Contains data about known Titles stored in 6 x 16bit integers. To calculate where a knownTitle is in one of those 6 integers you do the following: We select one of the titles from CharTitles.dbc, take Archmage title for example:

We use the InGameOrder to calculate in which one of the 6 (16bit) integer is the title stored:

InGameOrder / 32 = X
61 / 32 = **1,90625** (1 - Do **NOT** round the value!)

so the 1st integer stores the title. Because counting starts from 0 to 5, it would be “0 TITLE_BIT 0 0 0 0”.

Now which bit stores the title? We use modulo to calculate this.

InGameOrder Modulo 32 = X
61 Mod 32 = **29**

so the 29bit stores the title. This would be 2 ^ 29 = 536870912. This bit stores the Archmage title. This would mean if you only have the Archmage title, characters.knownTitles would be “0 536870912 0 0 0 0”.

A bitmask that contains visible actionbars for the player.

Recruit A Friend stuff.

A field used to change the order in which the characters appear in the character selection screen. The order field is used first, then the characters.guid, which means that if the order column is NULL for every character of an account, they will be sorted by characters.guid by default.

Character's creation date and time. Format YYY-MM-DD HH:MM:SS according to server's time.

Stores the account id if the character is deleted and CharDelete.Method in worldserver.conf is set to 1.

Stores the name of character if the character is deleted and CharDelete.Method in worldserver.conf is set to 1.

Stores the date when the character was deleted and CharDelete.Method in worldserver.conf.dist is set to 1. Will be checked by worldserver against CharDelete.KeepDays in worldserver.conf.dist. If this value is lower than deleteDate + CharDelete.KeepDays the character will be purged.