i52 [Group logs] [Knockout logs] [Finals]

About

Logs.tf is a Team Fortress 2 log parser and stats generator. It was publicly released in November 2012.

Contact

Please consider using our feedback system on top right corner before contacting by other methods.

Logs.tf API key

To retrieve your API key, visit Upload logs page when logged in. This key is used for uploading logs from TF2 server plugins and other uploaders.

TF2 Server plugins

How to install
  1. Download the plugin and extract it into temporary location.
  2. Most servers have FTP access into TF2 directory. Check your server control panel for info. Open Windows Explorer and point it to provided IP address, e.g. ftp://180.0.0.0
  3. Upload the files to /tf/addons/ on the server.
  4. Generate Logs.tf API key on upload page. Add 'tftrue_logs_apikey APIKEYHERE' to /tf/cfg/server.cfg on the server and restart.
  5. Add 'tftrue_logs_roundend 1' to enable updating of logs after every round.
  6. Type !log in chat to view the last log ingame.

Download Documentation

How to install
  1. These plugins require SourceMod. If your server provider does not provide installation from control panel, you can install it manually.
  2. LogsTF auto-uploads the logs, SupStats2 and MedicStats provide more detailed stats and Updater automatically keeps plugins up-to-date. Also cURL extension is needed. Download all of them from here.
  3. Extract plugin files into temporary location.
  4. Most servers have FTP access into TF2 directory. Check your server control panel for info. Open Windows Explorer and point it to provided IP address, e.g. ftp://180.0.0.0
  5. Upload .smx files to /tf/addons/sourcemod/plugins/. Upload cURL extension files to /tf/addons/sourcemod/ with its directory structure intact.
  6. Generate Logs.tf API key on upload page. Add 'logstf_apikey APIKEYHERE' to /tf/cfg/server.cfg on the server and restart. You can also add 'logstf_midgameupload 1' for updating logs after every round.
  7. Type !log in chat to view the last log ingame.

Download

These plugins automatically upload logs after matches and allow viewing them ingame.

Help

1. Access logs directory of your TF2 server
  • Most servers have FTP access to TF2 directory. Check your server control panel for info.
  • Open Windows Explorer and point it to provided IP address, e.g. ftp://180.0.0.0
  • Navigate to /orangebox/tf/logs. Directory structure may vary by server provider.
  • (Make a shortcut to access logs quickly!)
2. Copy relevant log files into your hard drive
  • Sort by date modified to easily find newest logs.
  • Proper logs are usually way over 100 KB.
  • Copy files you want to upload on your hard disk drive.
3. Upload to logs.tf
You can drag and drop log files anywhere on upload page to add logs.

To make the accuracy work, make sure you have SourceMod 1.5.2 or later. To check version, type 'sm plugins' on console.

If it still does not work after upgrading, try downloading the latest SourceMod and manually extract /tf/addons/sourcemod/gamedata/sm-tf2.games.txt to your server.

To upload logs, make a multipart/form-data POST request to http://logs.tf/upload. Use these fields:

titleTitle of your log. Max length 40 chars.
mapTF2 map. Optional. Max length 24 chars.
keyYour unique key, see "Logs.tf API key" on upload page.
logfileLog file. Max 5 MB.
uploaderOptional Name of the uploading plugin or software (including version). Max length 40 chars.
updatelogOptional Update existing log ID instead of uploading a new log.

Response is json with these fields (not all are always included):

successTrue / False
errorDescription of error.
log_idID of the log on successful upload.
urlRelative path to the log. e.g. /5100

For more information, add zooob on Steam.

Log data

Access raw JSON data of logs: http://logs.tf/json/<log_id>.

Log search

Access JSON list of logs: http://logs.tf/json_search?title=X&uploader=Y&player=Z&limit=N

Any of these fields can be combined together or omitted.

Title should be longer than 2 characters.

titleTitle text search
uploaderUploader SteamID as string or 64-bit integer
playerPlayer SteamID as string or 64-bit integer

Describes a set of additional stats that TF2 server plugin may implement. Spec on GitHub.

History
  • 1.0 Original supstats.smx features + healing with buffs
  • 2.0 Damage targets, charge with medigun type, medic stats, medkit pickup with real healing amount
  • 2.1 Weapon accuracies

Statistics

  • Logs: 429238
  • Uploaders: 2580
  • Unique players: 76587
Players & matches played