Home

Use the sidebar to navigate to specific instructions >>>>>>>

Before you go any further:

If you're on Windows

KBNHud is now included in CriticalFlaw's and Revan's HUD Editor, an installer and customization tool that provides a visual system for enabling the customizations you use, as well as set up your crosshairs, colors, and more.

How to edit HUD files

While these files can be modified using any text editor, like Notepad, it is highly recommended that you use Notepad++ since it understands code batching and indentation, or any other editor that does the same. VSCode is an alternative for Windows, and Linux has a great multitude of such apps. The list of programs I use are linked in the sidebar under the MISC category.

How the ^customizations folder works:

Any folder inside of ^customizations that starts with a # (pound sign, or hashtag for you kids) is a folder the game will be actively loading data from. Things you change in them will directly affect the appearance and function of the HUD. They are as follows:

#colors: The file in this folder, ccolors_clientscheme.res, defines various colors that the HUD uses that users have requested the ability to customize. Detailed instructions are here.

#crosshairs: The file in this folder, crosshairs_hudlayout.res, allows you to choose one of a wide variety of HUD crosshairs. Detailed instructions are here.

#enabled: This is the folder where the simple customizations go to be switched on. To shut them off, simply remove the corresponding file from this folder.

#hitmarkers: The file in this folder, hitmarkers_hudlayout.res, allows you to choose one of a variety of flashing hitmarkers. Detailed instructions are here.

#resolutions: There are two folders in here that act as bulk replacements, described directly below this. By default, the HUD will have 16:9 mode enabled. For those of you on 4:3 or 4:3 stretched, see this page.

Any folder that starts with an _ (underscore) is a folder with bulk overrides. To enable the bulk overrides, remove the underscore from the name of the folder. Add the underscore back to disable the bulk overrides.

The exception to the rules above this is the ^basefiles folder. This is the folder where the default versions of pretty much every one of these customizations live. Modify the contents of this folder at your own risk.

Final note: Some files will have lines that have [$LINUX] or [$OSX] flags. These flag a certain line as only to be used when the game is run on a certain operating system. Change the line that is appended by the OS you are using.

Help and support:

This HUD may not work with certain localizations of TF2, because of the custom fonts used in the HUD.

The following can help resolve issues:

• use the command "hud_reloadscheme" in the console
• restart TF2 / Steam
• verify TF2's game cache on steam
• re-download & re-install the hud
• uninstall and reinstall TF2, then reinstall the HUD

You can submit bug reports & questions via the GitHub issue tracker. You may also fork this repository with your own modifications, Submit a pull request, and that is great for me since you can make your own fixes and I can simply merge them into the master branch, and copy them into the versions stored on my computer. This or simply sending me a ping over on steam or Discord are the best ways to let me know something is borked. Links to the steam group, my Discord, and the HUDS.TF Discord are at the top of the readme.

CONTACT INFO

If you need further assistance, you can get it via the following methods:

My Discord Server

HUDS.TF Discord server