cstrike/csx/csstats: Added documentation, consistency updates, typo fixes
This commit is contained in:
Valentin Grünbacher
@@ -12,58 +12,263 @@
|
||||
#endif
|
||||
#define _csstats_included
|
||||
|
||||
/* Gets stats from given weapon index. If wpnindex is 0
|
||||
* then the stats are from all weapons. If weapon has not been used function
|
||||
* returns 0 in other case 1. Fields in stats are:
|
||||
* 0 - kills
|
||||
* 1 - deaths
|
||||
* 2 - headshots
|
||||
* 3 - teamkilling
|
||||
* 4 - shots
|
||||
* 5 - hits
|
||||
* 6 - damage
|
||||
/**
|
||||
* Retrieves the client's current weapon statistics.
|
||||
*
|
||||
* @note For a list of default CS weapon ids see the CSW_* constants in
|
||||
* amxconst.inc, this function also works on custom weapons.
|
||||
* @note For a list of possible body hitplaces see the HIT_* constants in
|
||||
* amxconst.inc
|
||||
* @note The fields in the statistics are:
|
||||
* 0 - Kills
|
||||
* 1 - Deaths
|
||||
* 2 - Headshots
|
||||
* 3 - Teamkills
|
||||
* 4 - Shots
|
||||
* 5 - Hits
|
||||
* 6 - Damage
|
||||
*
|
||||
* @param index Client index
|
||||
* @param wpnindex Weapon id, or 0 to retrieve total statistics across all
|
||||
* weapons
|
||||
* @param stats Buffer to copy statistics to
|
||||
* @param bodyhits Buffer to copy body hits to
|
||||
*
|
||||
* @return 1 on success, 0 if no statistics are available for the weapon
|
||||
* id
|
||||
* @error If an invalid client index or weapon id is provided, an
|
||||
* error will be thrown.
|
||||
*/
|
||||
native get_user_wstats(index, wpnindex, stats[8], bodyhits[8]);
|
||||
|
||||
* For body hits fields see amxconst.inc. */
|
||||
native get_user_wstats(index,wpnindex,stats[8],bodyhits[8]);
|
||||
/**
|
||||
* Retrieves the client's weapon statistics from the current round.
|
||||
*
|
||||
* @note For a list of default CS weapon ids see the CSW_* constants in
|
||||
* amxconst.inc, this function also works on custom weapons.
|
||||
* @note For a list of possible body hitplaces see the HIT_* constants in
|
||||
* amxconst.inc
|
||||
* @note The fields in the statistics are:
|
||||
* 0 - Kills
|
||||
* 1 - Deaths
|
||||
* 2 - Headshots
|
||||
* 3 - Teamkills
|
||||
* 4 - Shots
|
||||
* 5 - Hits
|
||||
* 6 - Damage
|
||||
*
|
||||
* @param index Client index
|
||||
* @param wpnindex Weapon id, or 0 to retrieve total statistics across all
|
||||
* weapons
|
||||
* @param stats Buffer to copy statistics to
|
||||
* @param bodyhits Buffer to copy body hits to
|
||||
*
|
||||
* @return 1 on success, 0 if no statistics are available for the
|
||||
* weapon id
|
||||
* @error If an invalid client index or weapon id is provided, an
|
||||
* error will be thrown.
|
||||
*/
|
||||
native get_user_wrstats(index, wpnindex, stats[8], bodyhits[8]);
|
||||
|
||||
/* Gets round stats from given weapon index.*/
|
||||
native get_user_wrstats(index,wpnindex,stats[8],bodyhits[8]);
|
||||
/**
|
||||
* Retrieves the client's weapon statistics from the permanent storage on the
|
||||
* server.
|
||||
*
|
||||
* @note The permanent storage is updated on every respawn or client disconnect.
|
||||
* @note Player rank is determined by the difference of kills to deaths.
|
||||
* @note For a list of possible body hitplaces see the HIT_* constants in
|
||||
* amxconst.inc
|
||||
* @note The fields in the statistics are:
|
||||
* 0 - Kills
|
||||
* 1 - Deaths
|
||||
* 2 - Headshots
|
||||
* 3 - Teamkills
|
||||
* 4 - Shots
|
||||
* 5 - Hits
|
||||
* 6 - Damage
|
||||
* 7 - Rank
|
||||
*
|
||||
* @param index Client index
|
||||
* @param stats Buffer to copy statistics to
|
||||
* @param bodyhits Buffer to copy body hits to
|
||||
*
|
||||
* @return Players rank > 0 on success, or 0 if player is not ranked
|
||||
* and no statistics are available
|
||||
* @error If an invalid client index is provided, an error will be
|
||||
* thrown.
|
||||
*/
|
||||
native get_user_stats(index, stats[8], bodyhits[8]);
|
||||
|
||||
/* Gets overall stats which are stored in file on server
|
||||
* and updated on every respawn or user disconnect.
|
||||
* Function returns the position in stats by diff. kills to deaths. */
|
||||
native get_user_stats(index,stats[8],bodyhits[8]);
|
||||
/**
|
||||
* Retrieves the client's statistics from the current round.
|
||||
*
|
||||
* @note For a list of possible body hitplaces see the HIT_* constants in
|
||||
* amxconst.inc
|
||||
* @note The fields in the statistics are:
|
||||
* 0 - Kills
|
||||
* 1 - Deaths
|
||||
* 2 - Headshots
|
||||
* 3 - Teamkills
|
||||
* 4 - Shots
|
||||
* 5 - Hits
|
||||
* 6 - Damage
|
||||
*
|
||||
* @param index Client index
|
||||
* @param stats Buffer to copy statistics to
|
||||
* @param bodyhits Buffer to copy body hits to
|
||||
*
|
||||
* @return 1 on success, 0 if no statistics are available
|
||||
* @error If an invalid client index is provided, an error will be
|
||||
* thrown.
|
||||
*/
|
||||
native get_user_rstats(index, stats[8], bodyhits[8]);
|
||||
|
||||
/* Gets round stats of player. */
|
||||
native get_user_rstats(index,stats[8],bodyhits[8]);
|
||||
/**
|
||||
* Retrieves the client's statistics inflicted upon another client from the
|
||||
* current round.
|
||||
*
|
||||
* @note For a list of possible body hitplaces see the HIT_* constants in
|
||||
* amxconst.inc
|
||||
* @note The fields in the statistics are:
|
||||
* 0 - Kills
|
||||
* 1 - Deaths
|
||||
* 2 - Headshots
|
||||
* 3 - Teamkills
|
||||
* 4 - Shots
|
||||
* 5 - Hits
|
||||
* 6 - Damage
|
||||
*
|
||||
* @param index Client index
|
||||
* @param victim Victim client index, or 0 to retrieve the statistics against
|
||||
* all victims
|
||||
* @param stats Buffer to copy statistics to
|
||||
* @param bodyhits Buffer to copy body hits to
|
||||
* @param wpnname Optional buffer to copy last used weapon name to
|
||||
* @param len Maximum buffer size
|
||||
*
|
||||
* @return 1 on success, 0 if no statistics are available against the
|
||||
* specified victim
|
||||
* @error If an invalid client index is provided, an error will be
|
||||
* thrown.
|
||||
*/
|
||||
native get_user_vstats(index, victim, stats[8], bodyhits[8], wpnname[] = "", len = 0);
|
||||
|
||||
/* Gets stats with which user have killed/hurt his victim. If victim is 0
|
||||
* then stats are from all victims. If victim has not been hurt, function
|
||||
* returns 0 in other case 1. User stats are reset on his respawn. */
|
||||
native get_user_vstats(index,victim,stats[8],bodyhits[8],wpnname[]="",len=0);
|
||||
/**
|
||||
* Retrieves the client's statistics received from another client from the
|
||||
* current round.
|
||||
*
|
||||
* @note For a list of possible body hitplaces see the HIT_* constants in
|
||||
* amxconst.inc
|
||||
* @note The fields in the statistics are:
|
||||
* 0 - Kills
|
||||
* 1 - Deaths
|
||||
* 2 - Headshots
|
||||
* 3 - Teamkills
|
||||
* 4 - Shots
|
||||
* 5 - Hits
|
||||
* 6 - Damage
|
||||
*
|
||||
* @param index Client index
|
||||
* @param wpnindex Attacker client index, or 0 to retrieve the statistics from
|
||||
* all attackers
|
||||
* @param stats Buffer to copy statistics to
|
||||
* @param bodyhits Buffer to copy body hits to
|
||||
* @param wpnname Optional buffer to copy last used weapon name to
|
||||
* @param len Maximum buffer size
|
||||
*
|
||||
* @return 1 on success, 0 if no statistics are available against the
|
||||
* specified attacker
|
||||
* @error If an invalid client index is provided, an error will be
|
||||
* thrown.
|
||||
*/
|
||||
native get_user_astats(index, wpnindex, stats[8], bodyhits[8], wpnname[] = "", len = 0);
|
||||
|
||||
/* Gets stats with which user have been killed/hurt. If killer is 0
|
||||
* then stats are from all attacks. If killer has not hurt user, function
|
||||
* returns 0 in other case 1. User stats are reset on his respawn. */
|
||||
native get_user_astats(index,wpnindex,stats[8],bodyhits[8],wpnname[]="",len=0);
|
||||
|
||||
/* Resets life, weapon, victims and attackers user stats. */
|
||||
/**
|
||||
* Resets the current round weapon, attacker and victim statistics.
|
||||
*
|
||||
* @param index Client index
|
||||
*
|
||||
* @noreturn
|
||||
* @error If an invalid client index is provided, an error will be
|
||||
* thrown.
|
||||
*/
|
||||
native reset_user_wstats(index);
|
||||
|
||||
/* Gets overall stats which stored in stats.dat file in amx folder
|
||||
* and updated on every mapchange or user disconnect.
|
||||
* Function returns next index of stats entry or 0 if no more exists. */
|
||||
native get_stats(index,stats[8],bodyhits[8],name[],len,authid[] = "",authidlen = 0);
|
||||
/**
|
||||
* Retrieves statistics from the permanent storage on the server via iterative,
|
||||
* incremental access.
|
||||
*
|
||||
* @note The permanent storage is updated on every respawn or client disconnect.
|
||||
* @note Player rank is determined by the difference of kills to deaths.
|
||||
* @note For a list of possible body hitplaces see the HIT_* constants in
|
||||
* amxconst.inc
|
||||
* @note The fields in the statistics are:
|
||||
* 0 - Kills
|
||||
* 1 - Deaths
|
||||
* 2 - Headshots
|
||||
* 3 - Teamkills
|
||||
* 4 - Shots
|
||||
* 5 - Hits
|
||||
* 6 - Damage
|
||||
* 7 - Rank
|
||||
*
|
||||
* @param index Rank index
|
||||
* @param stats Buffer to copy statistics to
|
||||
* @param bodyhits Buffer to copy body hits to
|
||||
* @param name Buffer to copy client name to
|
||||
* @param len Maximum name buffer size
|
||||
* @param authid Buffer to copy client auth id to
|
||||
* @param authidlen Maximum authid buffer size
|
||||
*
|
||||
* @return Next rank index (> 0 and > index), or 0 if no more
|
||||
* statistics exist
|
||||
*/
|
||||
native get_stats(index, stats[8], bodyhits[8], name[], len, authid[] = "", authidlen = 0);
|
||||
|
||||
/* Returns number of all entries in stats. */
|
||||
/**
|
||||
* Returns the number of all entries in the permanent statistics storage.
|
||||
*
|
||||
* @return Number of entries in statistics storage
|
||||
*/
|
||||
native get_statsnum();
|
||||
|
||||
/*
|
||||
* new stats:
|
||||
* 0 - total defusions
|
||||
* 1 - bomb defused
|
||||
* 2 - bomb plants
|
||||
* 3 - bomb explosions
|
||||
*/
|
||||
native get_user_stats2(index,stats[4]);
|
||||
native get_stats2(index,stats[4],authid[] = "",authidlen = 0);
|
||||
/**
|
||||
* Retrieves the client's objective statistics from the permanent storage.
|
||||
*
|
||||
* @note The permanent storage is updated on every respawn or client disconnect.
|
||||
* @note The fields in the statistics are:
|
||||
* 0 - total defusions
|
||||
* 1 - bomb defused
|
||||
* 2 - bomb plants
|
||||
* 3 - bomb explosions
|
||||
*
|
||||
* @param index Client index
|
||||
* @param stats Buffer to copy statistics to
|
||||
*
|
||||
* @return Players rank > 0 on success, or 0 if player is not ranked
|
||||
* and no statistics are available
|
||||
* @error If an invalid client index is provided, an error will be
|
||||
* thrown.
|
||||
*/
|
||||
native get_user_stats2(index, stats[4]);
|
||||
|
||||
/**
|
||||
* Retrieves objective statistics from the permanent storage on the server via
|
||||
* iterative, incremental access.
|
||||
*
|
||||
* @note The permanent storage is updated on every respawn or client disconnect.
|
||||
* @note The fields in the statistics are:
|
||||
* 0 - total defusions
|
||||
* 1 - bomb defused
|
||||
* 2 - bomb plants
|
||||
* 3 - bomb explosions
|
||||
*
|
||||
* @param index Client index
|
||||
* @param stats Buffer to copy statistics to
|
||||
* @param authid Buffer to copy client auth id to
|
||||
* @param authidlen Maximum authid buffer size
|
||||
*
|
||||
* @return Next rank index (> 0 and > index), or 0 if no more
|
||||
* statistics exist
|
||||
*/
|
||||
native get_stats2(index, stats[4], authid[] = "", authidlen = 0);
|
||||
|
||||
Reference in New Issue
Block a user