How to use the Custom folder

[Renegade]

A "custom" folder will be automatically generated for you the first time you start a game in HLDJ.
In this folder you can place any files you want, and these files will automatically be copied to your game directory when you start the game in HLDJ. You'll notice there's already a file in the custom folder, named "hldj_custom.cfg". This file, in addition to being copied to the game directory, will also be executed automatically when you start the game.

A typical use of this feature could be to create your own custom HLDJ aliases/binds:

Code: Select all

bind p hldjsca
bind "`" "toggleconsole; la"
alias a la
alias halfsec "wait 50"
// etc.

Another example of this feature is a Custom Command Menu (for HL1 only). You can place your customized "commandmenu.txt" file into the custom folder and have it loaded every time you start HLDJ.

The How to bind songs to keys tutorial also makes use of this feature.

[Itachi]

What exactly is the purpose of 'aliases?' Sorry I'm a bit of a n00b at this

[Renegade]

An alias is a shortcut for other commands. Every command in the game and HLDJ is an alias and aliases can be called from console or bound to keys. Many advanced users like to define their own aliases to perform certain actions (see the examples above), and the custom folder/scripts gives them a convenient place to do this.
For example, here's a convenient alias that loads a random song, then displays it's title in public chat:

Code: Select all

alias my_hldj_random "hldj_random; hldj_wait; hldj_saycuraudio"