Van: http://wiki.vbaddict.net/pages/BattleResults

BattleResults




The battle result can be obtained either from a replay file, or from the battle results cache that the game client keeps on disk.

Contents


 

 

 

 

 

 

 

 


Structure (Replays)

The battle result is a Python pickle, and can be deserialized using the standard Python pickle library.

import cPickle

  1. assume that we have loaded the block data into the block variable

struct = cPickle.loads(block)  

The final structure is a dict (also referred to as a hash or associative array) with 4 root keys.

Structure (binary Battle Result)

The binary battle result is a more complicated.  

batteresultversion, battleResults = cPickle.load(cachefile)

arenaUniqueID = battleResults[0]

data = battleResults[1] and battleResults[2]

arenaUniqueID

An unique ID number for the battle. Can be used to find related replays.

common

This key contains some basic information about the battle.

arenaTypeID

This is a packed value containing the match type, and the map on which the battle took place.

duration

This is the duration (in seconds) of the battle.

vehLockMode

Seems to contain the vehicle lock mode, used to keep vehicles locked for certain periods of time after clan war battles.

arenaCreateTime

A UNIX timestamp (seconds since epoch) for when the arena was started up for this battle. The timestamp is the epoch at UTC.

finishReason

The reason the battle finished

winnerTeam

Contains the ID number for the winning team

bonusType

Contains the "bonus type" which can be used to see if it was a random battle, clan war battle, tournament, training, or tank company battle.

guiType

Similar to the bonusType, with less values

personal

This key contains information about the player who recorded the replay, and their performance in the battle.

markOfMastery

Contains the players' current mark of mastery for the vehicle they played

he_hits

The total number of hits scored with HE ammo

eventGold

Gold earned as a result of an ongoing event

tmenXP

The amount of experience given to your crew members; can differ from XP earned for the vehicle if an x3 crew XP event is going on.

pierced

The total number of penetrating hits scored

freeXP

The amount of free XP earned for this match

aogasFactor10

Certain countries (Vietnam, China) have legally mandated that online games should have a reduction in xp or credits gained the longer someone plays; this value apparently modifies this reduction and is otherwise not used. Is commonly set to "10".

eventFreeXP

The amount of free XP earned as a result of obtaining eventXP

isPremium

A boolean set to indicate if the owner of the vehicle is using a premium account or not.

kills

The number of vehicles on which the player got the killing blow

shots

The total number of shots fired

eventTMenXP

The amount of extra xp each crew member received due to an ongoing event (for example double crew xp)

spotted

The total number of vehicles detected

details

This key contains another dict, with information on what this player did to an enemy (or friendly) vehicle. The keys in the dict are the vehicleIDs of the vehicles that the player has done things to. Each entry in the dict will contain the following fields:

killed

Boolean indicating whether the player got the final blow on this vehicle.

Not available in battle results from version 0.8.6. Got replaced by deathReason.

deathReason

Integer, indicating if the player destroyed this vehicle (0) or not (-1)

he_hits

The total number of hits scored on this vehicle using HE rounds

spotted

Boolean indicating whether the player spotted this vehicle

crits

up to Version 0.8.5: The total number of critical hits scored on this vehicle

since Version 0.8.6: Packed value.

pierced

The total number of penetrating hits scored on this vehicle

hits

The total number of hits scored on this vehicle

hits = he_hits + pierced + crits  

damageDealt

The total amount of damage dealt to this vehicle by the player

damageAssisted

The total amount of damage other players have done to this vehicle as a result of this vehicle being spotted by the player

Not available in battle results from version 0.8.6. Got split into damageAssistedRadio and damageAssistedTrack

damageAssistedRadio

The total amount of damage other players have done to this vehicle as a result of this vehicle being spotted by the player

Only available in version 0.8.6

damageAssistedTrack

The total amount of damage other players have done to this vehicle as a result of this vehicle being tracked by the player

Only available in version 0.8.6

fire

A boolean value indicating whether the player has set this vehicle on fire

creditsContributionIn

The total amount of compensation received in the event a team member did damage to you

typeCompDescr

A packed value containing information about which vehicle was being driven by the player

eventCredits

Credits earned as a result of an ongoing event (e.g. earn 5000 credits for obtaining a Sniper badge)

thits

The total number of team hits made this match (v0.8.4>)

tkills

The total number of team kills made this match

team

The team number the player was in

autoEquipCost

The amount of credits or gold spent on re-equipping the vehicle after battle

achievements

Achievements earned during battle (see also dossierPopups)

credits

Credits earned in this battle. Includes premium multiplier factor, and event credits.

mileage

The total number of meters moved in this battle

creditsContributionOut

The total amount of compensation the members of your team you've damaged received

accountDBID

The account ID of the player

hits

The total number of hits scored in this battle

gold

Unknown, perhaps gold earned

autoRepairCost

The total amount of credits spent to auto-repair the vehicle after the battle

xpPenalty

XP penalty amount (for damaging team members)

damaged

Total number of vehicles damaged by the player during the battle

creditsPenalty

Credit penalty amount for damaging team members

premiumXPFactor10

The multiplication factor when using a premium account; the actual factor can be obtained by dividing this value by 10.

premiumCreditsFactor10

The multiplication factor when using a premium account; the actual factor can be obtained by dividing this value by 10.

damageAssisted

The total amount of damage the player did to other vehicles as a result of another team member spotting them

droppedCapturePoints

The amount of capture points you "dropped" as a result of shooting an enemy vehicle that is in the cap circle

capturePoints

The amount of capture points you earned as a result of being in the cap circle

damageReceived

The total amount of damage the player has received

potentialDamageReceived

This considered all the potential damage that a tank could receive from ricocheted or non-penetrated shells (including side skirt armour) (v0.8.4>)

repair

The credit cost for repairing the vehicle after the match, is the same as autoRepairCost.

health

The players' remaining health

killerID

The vehicleID of another player that killed the players' vehicle. When set to 0, the players' vehicle is still alive.

autoLoadCost

The amount of credits or gold spent on re-arming the vehicle after battle. Please see the details page for more information.

dailyXPFactor10

Whether this battle had a multiplier value attached to it. Values known:

10

x1 Experience (regular battle)

20

x2 Experience

30

x3 Experience

50

x5 Experience

shotsReceived

The total number of hits other vehicle scored on the player

xp

The total amount of XP earned for this match; includes freeXP, eventXP, and premium multipliers

lifeTime

The time in seconds the player was alive

tdamageDealt

Total amount of team damage dealt

isTeamKiller

A boolean flag indicating whether this player is a team killer (blue name)

eventXP

Experiene earned as a result of an event going on ===

dossierPopups

Contains all awards, medals, and other bits of information that are part of a battle result display, as well as a dossier update. Please see the detail page for more information.


igrXPFactor10

Introduced in WoT 0.8.8


questsProgress

Contains an array of missions progress


players

The players field contains a dict that lists all the players involved in the match; for clan war battles, enemy team members will only be listed here if they have been spotted (due to fog of war).

Each key in the dict is a players' accountDBID, and each element in the dict describes a player with the following structure:

prebattleID

This is an ID that indicates whether this player was in a "pre battle" room (e.g. company, or platoon chat). An ID of 0 means the player is not in a platoon or company. Players with the same prebattleID are in the same company, or the same platoon.

name

The players' in-game name

clanAbbrev

A string containing the players' clan ticker; when empty or 0 length, the player is not in a clan.

clanDBID

The database ID for the clan the player is a member of. When set to 0, the player is not in a clan.

vehicles

The vehicles field contains a dict that lists all the vehicles involved in the match; for clan war battles, enemy team members will only be listed here if they have been spotted (due to fog of war).

Each key in the dict is a players' vehicleID, and each element in the dict describes a player vehicle with the following structure:

to be done