And for you who dont want to read the code...
Description:
------------
This AMX-plugin will display game stats as HUD and chat messages.
Example of stats are: killing stats, most damage, best score,
accuracy, efficiency, attackers list, victims list, team scores.
All effeciency stats are calculated per game, not per round.
The accuracy stats are calculated per round, except for "/score"
which is per game.
Plugin support players switching teams and awarded players
disconnecting from server before round end. It also supports
game restart, ie all stats are resetted.
Plugin also support players switching of the stats announcements
on the HUD. The setting is a client parameter and therefore
saved between playing sessions.
Known bugs (reported):
-----------------------
Fixed bugs:
-----------------------
============================================= ==
Requirements/Limitations:
-------------------------
Code:
- AMX Mod X v0.16: Tested.
- Replaces "stats.amx" by OLO.
- Requires the AMX Mod X module "csstats_amx".
- You are recommended to not run any other death or
end-round plugins.
- If HUD-statistics are activated it is recommended that
other HUD-messages are deactivated as these otherwise
will disrupt HUD-statistics, such as PTB's. This is a
HalfLife-engine limitation.
- It is not recommended to use "mp_freezetime" less than
1.0 sec.
Installation:
-------------
Code:
- Copy the StatsX file "statsx.amx" to the AMX plugins
folder.
- In the AMX Mod X plugin configuration file ("plugins.ini"),
replace the line "stats.amx" with "statsx.amx".
- Add StatsX cvar to the server or AMX Mod X configuration file.
If menu configuration will not be used then also add
the "amx_statscfg" commands to one of the configuration
files.
- Restart server. Normally changing map is sufficient but
restarting the server is the "safe" procedure.
- If menu configuration is used then reconfigure the
stats settings using the "amx_statscfgmenu" command.
============================================= ==
Server Config:
--------------
Code:
Duration of HUD-statistics. (Default 12 sec.)
amx_statsx_duration < time in seconds >
HUD-statistics display limit relative round freeze end.
Negative time will clear the HUD-statstics before the
round freeze time has ended. (Default -2 sec.)
amx_statsx_freeze < time in seconds >
When activating this plugin the Stats Settings Plugin,
"statscfg", should also be activated.
Activating the Stats Settings Plugin allows configuration
to be done either with client GUI menus or in server
configuration files.
amx_statscfg < "on" or "off" > < option >
StatsX options:
"KillerChat" - show killer stats in the chat section
"ShowAttackers" - show attackers on HUD (deactivated)
"ShowVictims" - show victims on HUD (deactivated)
"ShowKiller" - show killer on HUD
"ShowTeamScore" - shows team score at round end (deactivated)
"ShowTotalStats" - shows round total stats (deactivated)
"ShowBestScore" - shows rounds best scored player
"ShowMostDisruptive"
- shows rounds most disruptive player
"EndPlayer" - display player stats MOTD at map end
"EndTop15" - display top15 MOTD at the end of map
"SayHP" - allow for say /hp
"SayStatsMe" - allow for say /statsme
"SayRankStats" - allow for say /rankstats
"SayMe" - allow for say /me
"SayRank" - allow for say /rank
"SayReport" - allow for say /report
"SayScore" - allow for say /score
"SayTop15" - allow for say /top15
"SayStatsAll" - allow for say /stats
"SayMiscFunc" - allow for say /timeleft, /thetime,
/currentmap, /ff
"ShowStats" - client HUD-stats switched on by default
"ShowDistHS" - show distance and HS in attackers and
victims HUD lists
"SpecRankInfo" - displays rank info when spectating
Stats plugin options (flags) to define what to display to
the clients.
NOTE! To deactivate all options set flags to " "
(one quoted space).
amx_statsx_mode < flags >
"a" - delay (0.01s) HUD stats on HUD reset
Client Commands:
----------------
Code:
Display info about your killer in the chat section.
say /hp
Display info about your stats, on the current map,
in a MOTD window.
say /statsme
Display your rank stats, in a MOTD window.
say /rankstats
Display your current round hit-stats in the chat section.
say /me
Display your rank in the chat section.
say /rank
Display the game score and stats in the chat section.
say /score
Display players current weapon status, as a say team command.
say /report
Display the 15 highest ranked players in a MOTD window.
say /top15
Display all players stats and rank in a MOTD window. The
displayed player is selection from a menu.
say /stats
Display time left on the map, as a say command.
say /timeleft
Display the current time, as a say command.
say /thetime
Display the current map, as a say command.
say /currentmap
Display the current status on friendly fire flag,
as a say command.
say /ff
Switch on or off all HUD-stats announcements ("_amxstatsx").
say /switch
============================================= ==
Tips:
-----
Code:
NOTE! All statistics collection is done by the module
"csstats_amx" and questions or issues should be directed
to the module author.
- To reset the player statistics in AMX Mod X 0.16, enter
"csstats_reset 1" in the server consol. At the next
mapchange the stats will be reset and the cvar
"csstats_reset" will be set back to "0". If you put
this command in the server.cfg the stats will be reset
at every mapchange.
- In AMX Mod X 0.16 statistics are by default only saved if the
difference between kills and deaths are greater than 0.
Comments:
---------
Code:
This code is based on/parts taken from OLO's stats v0.8.
- Added "endround" and some other functionality from
StatsMe 2.7 source code and config files.
- This plugin has been updated with new functionality
added to "stats" (by OLO), v0.8 to v0.9.6.
- New functions and configuration flags have been added.
- Original "/rank" is changed to "/rankstats".
- Attackers/victims is displayed before next round end.
- Last shot and kill included in all stats.
- Changed HUD number on killer stats to "2" to make
round end stats work with PTB.
- All statistics collection is done by the module
"csstats_mm" and questions or issues should be directed
to the module author.
Money is not supported in "say /report" (requires fun-module).
/X