Repository navigation
Installing and Sharing
github-actions[bot] edited this page Oct 21, 2026
·
3 revisions
Click Install (top right), choose a folder name and how to install it, then click Install to TF2:
-
Link (default):
tf/custom/<folder name>points at your HUD folder (a junction on Windows, a symlink elsewhere). Nothing is copied, and every save is what TF2 loads. -
Copy: the HUD is copied into
tf/custom/<folder name>.
Either way:
- if a folder with that name already exists, it's moved to the backups folder first, so nothing is lost;
- your working copy stays where it is, so you can keep editing and installing again;
- if your HUD already lives in
tf/custom, TF2 loads it directly and you only need to save.
In TF2, restart the game, or run these in the console to reload most changes:
hud_reloadscheme
Some changes (new fonts, hudlayout.res, menus) need a full restart.
To keep several HUDs and switch between them, see HUD Library. To start TF2 and reload the HUD from the studio, see Testing in TF2.
Use Export .zip… in the same Install & share dialog to make a zip with one top-level folder. That's the layout people expect when
they drop a HUD into tf/custom.
- Check Problems for errors.
- Add an
info.vdfwith your HUD's name (the New HUD wizard creates one). - Include the licenses of any fonts you ship.
- Don't ship Valve's files you didn't change. Overrides only need the parts you edited.
Download · Report a bug · Source · GPL-2.0 · Not affiliated with Valve