From PsychoStats

Introduction

PsychoStats comes with a couple of "server addons" that enhance the functionality of your game server in relation to your player stats. These addons are supported on Half-Life and Half-Life 2 game servers.

The plugins are available with PsychoStats version 3.1 and newer (in the addons folder of the software download). And are also available directly from SVN:

svn co http://www.psychostats.com/svn/psychostats/trunk/addons/

Spatial Statistics (heatmaps)

Available For: Sourcemod, Eventscripts 2, AMX Mod X

TF2 ctf_well heatmap

Logs spatial player statistics. This allows us to create statistics that show where exactly players are killing and dying on a game map. PsychoStats uses this information to create Heatmaps for view in the map statistics. Note: Team Fortress 2 game servers natively support spatial statistics and do not require this addon.

Note: Heatmaps use spatial statistics from your game logs which require a lot of storage space. For example, A month of logs could easily generate over 300,000 spatial events and take approximately 14MB of disk space on the MySQL server. Or think of it like this: every kill tracked on your server requires approximately ~50 bytes of data in the MySQL server. That might not seem like much, but it adds up to many megabytes very quickly.

Second Note: Rendering the heatmap images is very CPU intensive and can easily hog all available CPU on a system.

Third Note: Over time, basic "Death" heatmaps on one server will generally look the same on any other server with roughly the same number of kills. The real value of PsychoStats heatmaps is that they can be generated using multiple customizations. For example, only show where players kill using a certain weapon. Or show only a heatmap for a single player or team. It's even possible to show a heatmap that has both WARM and COLD colors representing where players kill and die at. Another unique feature to PsychoStats Heatmaps are the Kill Trajectories that will show exactly where a single player kills people from.

For more information on creating an overlay image for your custom maps please see the following article: Heatmap Setup.

For SourceMod (HL2 based mods)

The Sourcemod version of this plugin overrides the actual "kill" events in the game logs and adds the appropriate spatial information to the message. This means your logs are not bloated with a ton of extra lines of information, instead the spatial stats are added to existing events. The format of the messages conform to the Half-Life logging standard and should not cause any problems with other software that also supports the standard.

For Mattie EventScripts (HL2 based mods)

The Eventscripts version, unfortunately, can not override the game events to add the spatial information directly to the normal events (due to current limitations of the ES core). Instead it adds a 2nd log event for every kill that occurs on the server. This can increase the size of your log files but shouldn't really be a problem. PsychoStats will read these extra events and other software that doesn't recognize them will just ignore the events.

For AMX Mod X (HL based mods)

The AMX Mod X version works just like the SourceMod version. The kill events are rewritten rather than duplicated.

Installation

Copy the appropriate sub-directory from the PsychoStats addons directory into the plugins directory on your game server where the rest of your plugins are located. This location depends on which server extension you're using.

For more detailed information please see SourceMod, EventScripts or AMX mod X websites for how to install a plugin.

Loading Map 'FIX'

Note: This feature is only available in the sourcemod version of the addon.

The Half-Life game server has had a "bug" in it for as long as I can remember that causes it to never log the name of the very first map that loads when the server first starts. This can cause 'unknown' maps to appear in your player stats and can be annoying for the purists.

This feature fixes that bug by forcing the proper "Loading map xxx" event to be written to your game logs. The message that is logged will look exactly like the real event, so any stats software that reads the logs will benefit. This feature has virtually no overhead and automatically disables itself after the first map is logged.

Installation

Copy the ps_mapfix.smx file to your server's addons directory.

In-game Psychostats (for MetaMod: Source)

Contributed by Olly

PsychoReader - In-game Psychostats

Requirements: MetaMod source

Features:

• rank - Shows your rank, skill, previous rank and previous skill
• place - Shows your rank and skill as a public chat message
• top10 - Shows the top10 players in your stats
• next - Shows the next 9 players above you in the stats
• statsme - Shows a box on the left filled with your stats (3 pages)
• lastupdate - Shows how long its been since the stats were updated
• stats [Player Name | Partial Name] - Shows the statsme window for that player (only players currently on the server)

In-game Psychostats (for SourceMod)

Contributed by urus

Psychostats Interface Plugin (sourcemod version)

Requirements: SourceMod

Features:

• /rank - Display menu with individual player information
• /top10 - Display menu with top10 players

Real-time skill tracking

Note: To be released.