Documentation

All of the Automated HLTV commands that follow are "rcon say" commands. For example, when referring to the hltv.start command, the "rcon say hltv.start" command is implied. The Automated HLTV will listen only to "rcon say" commands.

Stopping HLTV

hltv.shutdown

Shuts down the Automated HLTV program. If you are recording a demo, it stops recording, archives the demo, and then exits.

Recording Demos

hltv.start demoname

Starts recording an HLTV demo to demoname.dem.

The extension .dem is added on to demoname. Legal characters in demoname include letters, dashes "-" and underscores "_". All periods "." are translated into underscores "_". At the first non-legal character occurring in demoname, the rest of the contents of demoname are truncated.

If no demoname is given, the default configured demo name will be used instead. Therefore, hltv.start is guaranteed to start recording whether or not demoname is given.

hltv.lo3 demoname

Starts recording an HLTV demo immediately after "LIVE ON THREE" appears in rcon say text on the server. (Treats demoname parameter the same as hltv.start.)

Many live-on-three server-scripts include the text "LIVE ON THREE", so this starts the demo after the live-on-three script has been activated and teams are ready to begin. This prevents pre-game action from appearing in the demos. However, if the Automated HLTV delay is set to a number greater than 0, say n, then n seconds of pre-game action will appear in the demo.

hltv.stop

Stops the HLTV demo if the Automated HLTV is currently recording. The demo is then added to a ZIP file and archived to a folder containing demos specified in your account.

If the Automated HLTV delay is set to n > 0, then hltv.stop will first wait n seconds before ending the demo, in order to preserve the complete demo.

If the server changes maps while an HLTV demo is recording, the Automated HLTV will recognize this and complete the current demo and start a new one with the same name, but with a different timestamp.

Important Note: If the server changes maps with a delay of n, you MUST allow n seconds to pass before the HLTV can properly start recording a new demo.

hltv.cancel

Stops recording the current demo and deletes it.

Useful in the case where a scrim has started prematurely (or went LO3 before both teams were ready) and needs to be restarted, eliminating unnecessary action in the demo.

hltv.secret demoname

This feature is equivalent to doing hltv.lo3 demoname followed by hltv.mute. When hltv.secret is used, the opposing team will not know they are being recorded because the HLTV will not report when it starts recording. It uses the already existing idea with hltv.lo3 (see documentation above) to start the demo, and then once you are done, just use hltv.stop to stop and save the demo. It will then exit 'secret mode' as if you had done 'hltv.unmute', and will return to an unmuted mode.

Adding Demo Comments

What is a ZIP file comment?

Automated HLTV compresses each HLTV demo file into a ZIP file. ZIP files can have 'comments' for them, which explain the contents of the ZIP file. Common archiving tools such as WinRAR and WinZIP both display ZIP file comments when a ZIP file is opened.

hltv.comment comment text ...

Adds a new line of text (comment text followed by a newline) to the comment of the ZIP file that will hold the demo after it is done recording. Important Note: An HLTV demo must be recording at the time that you use hltv.comment to add comments.

Information Commands

hltv.steamid

Does a SteamID lookup on everyone in the server, comparing their SteamIDs to the CAL CS SteamID.com database. The results are displayed via rcon say text in the server. Essentially, this uses the Rcon Notification Tool at SteamID.com.

hltv.status

Displays the current recording status of the Automated HLTV, the number of spectators, and the current delay.

hltv.mute

Prevents the Automated HLTV from displaying anything via rcon say text. The one exception is the hltv.steamid command.

This is useful for when you do not want other teams to know you are recording them. For example, before the other team comes in the server, use "hltv.lo3 demoname" then "hltv.mute" so that the Automated HLTV does not announce that it is starting to record when it sees "LIVE ON THREE" in rcon say text.

hltv.unmute

Allows the Automated HLTV to use rcon say text.

hltv.ping

Checks the response time of the Automated HLTV.

hltv.delay integer

Changes the Automated HLTV delay setting to integer.