This section is for common issues you may encounter and how to resolve them.
- For issues not on this page, please open a ticket on our issue tracker.
- For questions not covered in the documentation, visit our Discord server.
The latest release does not contain the executable.
You most likely downloaded the source code instead of the editor. On the releases page, make sure to download the file named tf2-hud-editor_X.X.zip and extract it into a separate folder.
The editor does not launch after downloading and extracting it.
Make sure to install the version of Microsoft .NET 7.0 Runtime intended for running desktop apps. If you just installed it and the editor still does not launch, then restart your system.
Access to the path ... .dll is denied.
Make sure TF2HUD.Editor is located on your main drive instead of an external drive.
If your TF2 installation is located on an external drive you may need to set your tf/custom directory in the editor.
Customization changes are not being shown in-game.
To see your selected changes in-game, open the console and input
hud_reloadscheme. This will refresh the HUD with your selected customizations.
Certain settings may require the game to be restarted, this mainly applies to color and main menu changes. If the game is running, a message will display notifying you that a game restart is required.
Error when applying or resetting HUD customizations.
Most errors you'll encounter will be caused by an outdated version of the HUD being installed. An outdated HUD may not have the latest changes that the editor would expect and when that happens, an error is returned. Best thing to do is reinstall the HUD through the editor and reapply the customizations.
Access to the path ... temp.zip is denied.
Try running the editor as administrator.
If that didn't work, double-check that your antivirus program isn't denying access to the editor program. For example, Avast has been known to prevent the editor from creating files in certain paths.
Could not find a part of the path "..tf/custom".
This can happen when TF2 is installed on a separate drive from your main Steam installation.
If the app does not find the directory to
tf/custom, it should prompt you to set the path manually. If that does not happen, users will have to click on the wrench icon at near the bottom of screen to open the Options menu then select "Set path to tf/custom". You'll then need to navigate to your TF2 installation folder, select tf/custom and click Select Folder.
For HUD Editor versions 2.5 and lower, please refer to this video: https://www.youtube.com/watch?v=NqSqLyROBwk