User Chat Statstrings
These strings appear in the TEXT field of
S > C [0x0F] SID_CHATEVENT for user events.
They are always in the format:
- ProductID + ' ' + Statstring
- ProductID: Reversed four-letter product ID, appears 'like' the DWORD as sent during logon.
- Statstring: Depends on product. Specified below:
Diablo
Diablo statstrings contain 9 fields, delimited with spaces.
Note that this product allows the client to specify whatever statstring it calculates, so bots may not follow this format!
- 1 Character Level
- 2 Character Class
- '0': Warrior
- '1': Rogue
- '2': Sorcerer
- 3 Number of dots
- '0': Has yet to kill Diablo
- '1': Killed Diablo on Normal difficulty
- '2': Killed Diablo on Nightmare
- '3': Killed Diablo on Hell
- 4 Character's Strength
- 5 Character's Magic
- 6 Character's Dexterity
- 7 Character's Vitality
- 8 Character's Gold
- 9 Spawned
- '1' if the client is spawned, '0' otherwise.
StarCraft, StarCraft Japanese, Brood War, and WarCraft II
These products all have 9 fields separated by space, like Diablo.
- 1 Ladder Rating
- The player's current ladder rating.
- 2 Ladder Rank
- The player's rank on the ladder.
- 3 Wins
- The amount of wins the player has in normal games.
- 4 Spawned
- '1' if the client is spawned [STAR/JSTR/W2BN], '0' otherwise.
- 5 League ID
- 6 High Ladder Rating
- The player's 'highest ever' ladder rating.
- 7 IronMan Ladder Rating
- 8 IronMan Ladder Rank
- 9 Icon
- This value should be matched against the product values of each icon in each Battle.net Icon file that is loaded. If a match is found, the client should use this icon when displaying the user.
WarCraft III, WarCraft III: TFT
These products have 2 or 3 fields separated by space.
There is a possibility that there can be 0 fields, meaning that the user was not assigned their stats before joining the channel (often appears with bots who join channel automatically and not waiting until the user clicks 'Enter Chat').
- 1 Icon
- Normal Format: Level + Tier + '3W' (special icons may not follow this format)
- Level: The 'win level' of the icon '1' through '5' ('6' on TFT). '1' is always peon.
- Tier: The race 'tier' of the icon.
- 'R' Random
- 'H' Human
- 'U' Undead
- 'N' Night Elf
- 'O' Orc
- 'D' Tournament (TFT)
- This value should be matched against the product values of each icon in each Battle.net Icon file that is loaded. If a match is found, the client should use this icon when displaying the user.
- 2 Level
- Level of the player. (Highest out of all possible game types that the user has played.) '0' means no ladder games on record.
- 3 Clan tag [OPTIONAL]
- Reversed clan tag, appears only if the player is in a clan.
Diablo II, Diablo II: LoD
These products do not have the same format.
- If the player is on Open, the format is just:
- ProductID
- otherwise it follows the format:
- ProductID + RealmName + ',' + CharacterName + ',' + Bytes
- ProductID: 'PX2D' or 'VD2D'.
- RealmName: The realm the character is on.
- CharacterName: The name of the character.
- Bytes: 33 bytes of non-textual data about the character. Each byte is between 0x01 and 0xFF and is explained below. 0xFF generally means the field is empty or not available.
- [1] Unknown (0x84 [Larger values also observed])
- [2] Unknown (0x80)
- [3] Equipment: Head
- [4] Equipment: Torso
- [5] Equipment: Legs
- [6] Equipment: Right Arm
- [7] Equipment: Left Arm
- [8] Equipment: Right Weapon
- [9] Equipment: Left Weapon (Typically Bows)
- [10] Equipment: Left Shield
- [11] Equipment: Right Shoulder Pad
- [12] Equipment: Left Shoulder Pad
- [13] Left Item (Heads)
- [14] Character Type:
- 0x01: Amazon
- 0x02: Sorceress
- 0x03: Necromancer
- 0x04: Paladin
- 0x05: Barbarian
- 0x06: Druid
- 0x07: Assassin
- [15] Color: Head
- [16] Color: Torso
- [17] Color: Legs
- [18] Color: Right Arm
- [19] Color: Left Arm
- [20] Color: Right Weapon
- [21] Color: Left Weapon
- [22] Color: Shield
- [23] Color: Right Shoulder Pad
- [24] Color: Left Shoulder Pad
- [25] Color: Left Item (Heads)
- [26] Level (0x01 to 0x63, 1 to 99)
- [27] Flags
- 0x04: Hardcore
- 0x08: Dead
- 0x20: Expansion
- [28] Current act (Currently no way to tell IV from V!)
- Original:
- 0x80: Normal Act I
- 0x82: Act II
- 0x84: Act III
- 0x86: Act IV
- 0x88: Nightmare Act I
- 0x8A: Act II
- 0x8C: Act III
- 0x8E: Act IV
- 0x90: Hell Act I
- 0x92: Act II
- 0x94: Act III
- 0x96: Act IV
- 0x98: All Acts (completed)
- Expansion:
- 0x80: Normal Act I
- 0x82: Act II
- 0x84: Act III
- 0x86: Act IV/V
- 0x8A: Nightmare Act I
- 0x8C: Act II
- 0x8E: Act III
- 0x90: Act IV/V
- 0x94: Hell Act I
- 0x96: Act II
- 0x98: Act III
- 0x9A: Act IV/V
- 0x9E: All Acts (completed)
- [29] Unknown (0x80 or 0xFF)
- [30] Unknown (0x80 or 0xFF)
- [31] Ladder
- 0xFF: Non-ladder
- Other: Ladder
- Seems to be the season number, currently 0x07.
- [32] Unknown (0xFF)
- [33] Unknown (0xFF)
= Online 
= Offline
BNETDocs News
User Comments
For detailed questions and discussion, visit the Battle.net Research Forum
Mar 17, 2011
10:21 AM
Some Diablo II statstring research comments:
Field 1 - Usually 0x84. Larger values observed as well. No idea as to the meaning yet.
Field 25 - Determined to be offhand item (necromancer heads) color.
Field 27 - Flags seem to start off at 0x80. A 0x01 seems to indicate the character has not yet entered a game, although a non-expansion character will not have this flag set unless it re-enters chat before joining a game. More research to come here too.
Fields 29 and 30 are 0x80 when the character has not yet entered a game, and 0xFF once he has. No other values have yet been observed.
Mar 10, 2011
02:38 AM
Diablo II Armor Types:
Torso, Legs, Arms, and Shoulders all have values from 1 to 3 (and 255 for nothing). Combined, they tell you what type of armor the character is wearing:
The order being used is Torso + Legs + Right Arm + Left Arm + Right Shoulder + Left Shoulder
111111 / 255255255255255255 = Nothing
111122 = Quilted Armor
211122 = Leather Armor
212222 = Hard Leather Armor
122122 = Studded Leather Armor
221122 = Ring Mail
222222 = Scale Mail
311133 = Breast Plate
222233 = Chain Mail
322222 = Splint Mail
223133 = Light Plate
332233 = Field Plate
333322 = Plate Mail
233333 = Gothic Plate
333333 = Full Plate Mail
332331 = Ancient Armor
Mar 10, 2011
03:00 AM
Diablo II Equipment (hex):
0 / 1 / 2 / 3 / FF = None
4 / 39 = Cap
5 / 3A = Skullcap
6 / 3B = Helm
7 / 3C = Full Helm
8 / 3D = Great Helm
9 / 3E = Crown
A / 3F = Mask
40 / 53 = Bone Helm
56 = Wolf Head
57 = Hawk Helm
58 = Antlers
59 = Jawbone Cap
5A = Horned Helm
5B = Assault Helmet
Mar 10, 2011
03:13 AM
Diablo II Items (Hex):
0 / FF = None
4 = Hand Axe
5 = Axe
6 = Double Headed Axe
7 = War Axe
8 = Giant Axe
9 = Wand
A = Yew Wand
B = Grim Wand
C = Club
D = Mace
E = Warhammer
F = Flail
10 = Maul
11 = Short Sword
12 = Scimitar
13 = Falchion
14 = Crystal Sword
15 = Broadsword
16 = Longsword
17 = Claymore
18 = Bastard Sword
19 = Dagger
1A = Blade
1B = Short Spear
1C = Glaive
1D = Pilum
1E = Spear
1F = Trident
20 = Spetum
21 = Pike
22 = Bardiche
23 = Scythe
24 = Halberd
25 = Short Staff
26 = Long Staff
27 = Battle Staff
28 = War Staff
29 = Short Bow
2A = Long Bow
2B / F3 / F4 / FB = Claws
2C / F5 / F6 / FC = Scissors Katar
2D / F7 / F8 / FD = Katar
2E / F9 / FA / FE = Hatchet Hands
2F = Hunter's Bow
30 = Composite Bow
31 / 7A / F0 = Crossbow
32 / 7C / F2 = Heavy Crossbow
33 = Eagle Orb
34 = Sacred Globe
35 = Clasped Orb
36 = Stag Bow
37 = Reflex Bow
4F = Small Shield
50 = Large Shield
51 = Kite Shield
52 = Tower Shield
54 = Bone Shield
55 = Spiked Shield
5C = Targe
5D = Heraldic Shield
5E = Crown Shield
5F = Demon Head
60 = Gargoyle Head
61 = Zombie Head
75 / EB = Short Battle Bow
76 / EC = Long Battle Bow
77 / ED = Short War Bow
78 / EE = Long War Bow
EF = Light Crossbow
F1 = Repeating Crossbow
Mar 10, 2011
03:17 AM
Diablo II Colors:
Color should be MOD A0'd as all values repeat.
0 / 1F / FF = Normal
1 = Gray
2 = Shiny Black
3 = Dull Black
4 = Black
5 = Shiny Blue
6 = Dull Blue
7 = Blue
8 = Shiny Red
9 = Dull Red
A = Red
B = Shiny Green
C = Dull Green
D = Green
E = Shiny Yellow
F = Dull Yellow
10 = Yellow
11 = Duller Yellow
12 = Shiny Purple
13 = Purple
14 = Gold
15 = White
Flags:
20 = Tinted
40 = Lightly Tinted
May 21, 2012
06:45 AM
Also, I just got a W3XP statstring that contained a level and clan tag but no icon data, so be aware of that possibility.
Jun 04, 2012
04:03 AM
RealityRipple; you have editor access; I'm surprised to see you didn't put that directly into the document.