About
Logs.tf is a Team Fortress 2 log parser and stats generator. It was publicly released in November 2012.
It is currently the most popular competitive stats website for Team Fortress 2, with tens of thousands of players checking the site each month.
Contact
-
zoob
Founder, developer and maintainer of logs.tf.
For support requests, please visit one of our forums above instead.
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.
Automated upload: TF2 Server plugins
How to install
- Download the plugin and extract it into temporary location.
- 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
- Upload the files to /tf/addons/ on the server.
- Generate Logs.tf API key on upload page. Add 'tftrue_logs_apikey APIKEYHERE' to /tf/cfg/server.cfg on the server and restart.
- Add 'tftrue_logs_roundend 1' to enable updating of logs after every round.
- Type !log in chat to view the last log ingame.
How to install
- These plugins require SourceMod. If your server provider does not provide installation from control panel, you can install it manually.
- 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.
- Extract plugin files into temporary location.
- 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
- Upload .smx files to /tf/addons/sourcemod/plugins/. Upload cURL extension files to /tf/addons/sourcemod/ with its directory structure intact.
- 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.
- Type !log in chat to view the last log ingame.
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
To upload logs, make a multipart/form-data POST request to http://logs.tf/upload. Use these fields:
title | Title of your log. Max length 40 chars. |
map | TF2 map. Optional. Max length 24 chars. |
key | Your unique key, see "Logs.tf API key" on upload page. |
logfile | Log file. Max 5 MB. |
uploader | Optional Name of the uploading plugin or software (including version). Max length 40 chars. |
updatelog | Optional Log ID to update instead of uploading a new log. |
Response is JSON with these fields:
success | True / False |
error | Description of possible error. |
log_id | ID of the log on successful upload. |
url | Relative path to the log. e.g. /5100 |
For more information, add zooob on Steam.
Log data API
Access raw JSON data of logs: http://logs.tf/api/v1/log/<log_id> OR http://logs.tf/json/<log_id>.
Log search API
Access JSON list of logs: http://logs.tf/api/v1/log?title=X&uploader=Y&player=Z&limit=N&offset=N
Any of these fields can be combined together or omitted.
Results are always ordered by log id descending.
Example of comma-separated SteamIDs: 76561197987681768,76561197996199110
title | Optional Title text search (min. 2 characters) |
map | Optional Exact name of a map |
uploader | Optional Uploader SteamID64 |
player | Optional One or more player SteamID64 values, comma-separated |
limit | Optional Limit results (default 1000, maximum 10000) |
offset | Optional Offset results (default 0) |
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