How and where can I get help if I need it ?

First make sure you have read the documentation.
In most cases it is only a config error.

Then you can request help in the hlstats-community.org forum. But please use the search function first befor you start a new topic. Also explain as much as possible otherwise no one can help.

For more and quick information we a blog and twitter.

How are players tracked? Or, why is my name listed more than once ?

Players are tracked by Unique ID.

A player may have more than one name. On the Player Rankings pages, players are shown with the most recent name they used in the game. If you click on a player's name, the Player Details page will show you a list of all other names that this player uses, if any, under the Aliases section (if the player has not used any other names, the Aliases section will not be displayed).

Your name may be listed more than once if somebody else (with a different Unique ID) uses the same name.

You can use the Search function to find a player by name or Unique ID.

How is the "points" rating calculated ?

A new player has 1000 points. Every time you make a kill, you gain a certain amount of points depending on a) the victim's points rating, and b) the weapon you used. If you kill someone with a higher points rating than you, then you gain more points than if you kill someone with a lower points rating than you. Therefore, killing newbies will not get you as far as killing the #1 player. And if you kill someone with your knife, you gain more points than if you kill them with a rifle, for example.

When you are killed, you lose a certain amount of points, which again depends on the points rating of your killer and the weapon they used (you don't lose as many points for being killed by the #1 player with a rifle than you do for being killed by a low ranked player with a knife). This makes moving up the rankings easier, but makes staying in the top spots harder.

Specifically, the equations are:

Killer Points = Killer Points + (Victim Points / Killer Points)
                 × Weapon Modifier × 5
Victim Points = Victim Points - (Victim Points / Killer Points)
                 × Weapon Modifier × 5

Plus, the following point bonuses are available for completing objectives in some games:
Game Player Action PlyrPlyr Action Team Action World Action Action Player Reward Team Reward
Team Fortress 2YesNoNoNoBuilt Object - Attachment Sapper+1
Team Fortress 2YesNoNoNoBuilt Object - Dispenser+5
Team Fortress 2YesNoNoNoBuilt Object - Sentrygun+5
Team Fortress 2YesNoNoNoBuilt Object - Teleporter Entrance+2
Team Fortress 2YesNoNoNoBuilt Object - Teleporter Exit+2
Team Fortress 2YesNoYesNoCapture Blocked+5
Team Fortress 2YesNoNoNoConsole-killed sapper-2
Team Fortress 2YesNoNoNoCritical Kill+1
Team Fortress 2YesNoNoNoDisassembled a dispenser-5
Team Fortress 2YesNoNoNoDisassembled a sentry gun-5
Team Fortress 2YesNoNoNoDisassembled a teleporter entrance-2
Team Fortress 2YesNoNoNoDisassembled a teleporter exit-2
Team Fortress 2NoYesNoNoDomination+5
Team Fortress 2YesNoNoNoDrowned0
Team Fortress 2YesNoNoNoExtinguished Teammate (Pyro)+1
Team Fortress 2YesNoNoNoExtinguished Teammate (Sniper)+1
Team Fortress 2YesNoNoNoFirstblod+5
Team Fortress 2YesNoNoNoFlagevent - Captured+2
Team Fortress 2YesNoNoNoFlagevent - Defended+2
Team Fortress 2YesNoNoNoFlagevent - Dropped-2
Team Fortress 2YesNoNoNoFlagevent - Picked Up+2
Team Fortress 2YesNoNoNoHeadshot Kill+2
Team Fortress 2YesNoNoNoHit by Train0
Team Fortress 2NoYesNoNoKill Assist+2
Team Fortress 2YesNoNoNoKill Assist - Medic+4
Team Fortress 2YesNoNoNoKilled Object - Attachment Sapper+2
Team Fortress 2YesNoNoNoKilled Object - Dispenser+5
Team Fortress 2YesNoNoNoKilled Object - Sentrygun+5
Team Fortress 2YesNoNoNoKilled Object - Spy+2
Team Fortress 2YesNoNoNoKilled Object - Teleporter Entrance+2
Team Fortress 2YesNoNoNoKilled Object - Teleporter Exit+2
Team Fortress 2NoNoNoYesMini-Round Win - Team Blue0Blue +2
Team Fortress 2NoNoNoYesMini-Round Win - Team Red0Red +2
Team Fortress 2YesNoYesNoPoint Captured+5
Team Fortress 2NoYesNoNoRevenge+5
Team Fortress 2NoNoYesYesRound Win - Team Blue0Blue +10
Team Fortress 2NoNoYesYesRound Win - Team Red0Red +10
Team Fortress 2YesNoNoNoSandvich0
Team Fortress 2YesNoNoNoSteal Sandvich+2
Team Fortress 2YesNoNoNoStun0
Team Fortress 2YesNoNoNoUbercharge+5
Note The player who triggers an action may receive both the player reward and the team reward.

What are all the weapon points modifiers ?

Weapon points modifiers are used to determine how many points you should gain or lose when you make a kill or are killed by another player. Higher modifiers indicate that more points will be gained when killing with that weapon (and similarly, more points will be lost when being killed by that weapon). Modifiers generally range from 0.00 to 2.00.

Game Weapon Name Points Modifier
Team Fortress 2robot_arm_blender_killEngineer Taunt (Gunslinger)5.00
Team Fortress 2taunt_scoutScout Taunt Kill5.00
Team Fortress 2taunt_demomanDemoman Taunt5.00
Team Fortress 2taunt_spySpy Taunt Kill5.00
Team Fortress 2taunt_sniperSniper Taunt Kill5.00
Team Fortress 2taunt_heavyHeavy taunt5.00
Team Fortress 2taunt_pyroTaunt Pyro4.00
Team Fortress 2deflect_flareDeflect Flare4.00
Team Fortress 2deflect_promodeDeflect Promode4.00
Team Fortress 2deflect_rocketDeflect Rocket4.00
Team Fortress 2deflect_stickyDeflect Sticky4.00
Team Fortress 2shovelShovel3.00
Team Fortress 2wrenchWrench3.00
Team Fortress 2clubClub3.00
Team Fortress 2fireaxeFire Axe3.00
Team Fortress 2fistsFists3.00
Team Fortress 2bottleWhiskey Bottle3.00
Team Fortress 2bonesawMedical Saw3.00
Team Fortress 2axtinguisherAxtinguisher2.50
Team Fortress 2ballBaseball2.50
Team Fortress 2pistol9MM Pistol2.50
Team Fortress 2pistol_scoutPistol Scout2.50
Team Fortress 2ubersawUbersaw2.50
Team Fortress 2batBaseball Bat2.00
Team Fortress 2sandmanThe Sandman2.00
Team Fortress 2bat_woodThe Sandman2.00
Team Fortress 2flaregunFlare Gun2.00
Team Fortress 2wrench_goldenGolden Wrench2.00
Team Fortress 2unique_pickaxeEqualizer2.00
Team Fortress 2tribalkukriTribalman's Shiv2.00
Team Fortress 2revolverRevolver2.00
Team Fortress 2battleaxeSkullcutter2.00
Team Fortress 2bushwackaThe Bushwacka2.00
Team Fortress 2fryingpanFrying Pan2.00
Team Fortress 2glovesurgentGloves of Running Urgently2.00
Team Fortress 2paintrainThe Pain Train2.00
Team Fortress 2robot_armGunslinger2.00
Team Fortress 2robot_arm_combo_killGunslinger Combo2.00
Team Fortress 2taunt_guitar_killEngineer Taunt (Guitar)2.00
Team Fortress 2sledgehammerThe Homewrecker2.00
Team Fortress 2southern_hospitalitySouthern Hospitality2.00
Team Fortress 2swordEyelander2.00
Team Fortress 2tf_pumpkin_bombPumpkin Bomb2.00
Team Fortress 2syringegun_medicSyringe Gun1.80
Team Fortress 2smgSMG1.80
Team Fortress 2flamethrowerFlamethrower1.80
Team Fortress 2maxgunLugermorph1.50
Team Fortress 2tf_projectile_arrowHuntsman1.50
Team Fortress 2shotgun_pyrShotgun Pyro1.50
Team Fortress 2scattergunScattergun1.50
Team Fortress 2shotgun_hwgHeavy Shotgun1.50
Team Fortress 2shotgun_primaryShotgun Primary1.50
Team Fortress 2shotgun_soldierShotgun Soldier1.50
Team Fortress 2knifeKnife1.50
Team Fortress 2glovesGloves1.50
Team Fortress 2blutsaugerBlutsauger1.50
Team Fortress 2nataschaNatascha1.50
Team Fortress 2backburnerBackburner1.50
Team Fortress 2tf_projectile_pipe_remoteRemote Grenade Launcher1.40
Team Fortress 2tf_projectile_pipeImpact Grenade Launcher1.30
Team Fortress 2tf_projectile_rocketRocket Launcher1.20
Team Fortress 2wrangler_killWrangler1.00
Team Fortress 2degreaserThe Degreaser1.00
Team Fortress 2sydneysleeperThe Sydney Sleeper1.00
Team Fortress 2samrevolverBig Kill1.00
Team Fortress 2powerjackThe Powerjack1.00
Team Fortress 2letrangerL'Etranger1.00
Team Fortress 2holy_mackerelThe Holy Mackerel1.00
Team Fortress 2frontier_justiceFrontier Justice1.00
Team Fortress 2minigunMinigun1.00
Team Fortress 2playerPlayer1.00
Team Fortress 2force_a_natureForce-A-Nature1.00
Team Fortress 2sniperrifleSniper Rifle1.00
Team Fortress 2worldWorld1.00
Team Fortress 2obj_sentrygunSentry Gun1.00
Team Fortress 2ambassadorAmbassador1.00
Team Fortress 2rocketlauncher_directhitDirect Hit1.00
Team Fortress 2obj_sentrygun2Sentry Gun Level 20.90
Team Fortress 2obj_sentrygun3Sentry Gun Level 30.80

How can I set my profile data ?

Player profile options can be configured by saying the appropriate SET command while you are playing on a participating game server. To say commands, push your chat key and type the command text.

Syntax: say /set option value.

Acceptable "options" are:

  • realname
    Sets your Real Name as shown in your profile.
    Example:    /hls_set realname Joe Bloggs
  • email
    Sets your E-mail Address as shown in your profile.
    Example:    /hls_set email joe@hotmail.com
  • homepage
    Sets your Home Page as shown in your profile.
    Example:    /hls_set homepage http://www.geocities.com/joe/
  • icq
    Sets your ICQ Number as shown in your profile.
    Example:    /hls_set icq 123456789
  • myspace
    Sets your myspace page as shown in your profile.
    Example:    /hls_set myspace http://myspace.com/name
  • facebook
    Sets your facebook page as shown in your profile.
    Example:    /hls_set facebook http://facebook/name
  • jabber
    Sets your jabber ID as shown in your profile.
    Example:    /hls_set jabber ID
  • steamprofile
    Sets your steamprofile URL as shown in your profile.
    Example:    /hls_set steamprofile URL
The server will respond with "SET command successful." If you get no response, it probably means you typed the command incorrectly.

Note These are not standard Half-Life console commands. If you type them in the console, Half-Life will give you an error.

My rank is embarrassing. How can I opt out?

Say /hls_hideranking while playing on a participating game server. This will toggle you between being visible on the Player Rankings and being invisible.

Note You will still be tracked and you can still view your Player Details page. Use the Search page to find yourself.

What are active players etc. ?

At the players overview you have multiple options to select which players are show and which not.
The default is to show only active and non BOT players. Which means a player is active if you use the player-activity.pl script and define the timeFrame in which a player is still active.
Everytime a player does something a flag is set to 1 and a timestamp is set. Then the player-activity.pl checks if the player has a activity within the given timeFrame. If not the player is set to in-active.
BOTs are recored if the IGNOREBOTS option is set to 0. This enables a additional option which displays those too. Otherwise no BOT is recorded or even shown.