Troubleshoot

Quick list of issues and solutions to the most common problems during HUD installation and usage.

INSTALLATION

• The HUD still shows as default after the installation:

  • Make sure you move the HUD folder to the correct path C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\tf\custom\hexhud and inside the hexhud you want to have:

    • cfg
    • materials
    • resource
    • scripts
    • sound
    • info.vdf

  • Make especially sure the resource,scripts and info.vdf are present, if any of these folders is missing consider re-downloading the HUD as the HUD might be corrupted

  • Make sure you are installing the HUD in the same drive as TF2 is installed, to avoid installing the HUD in the wrong drive browse the game files directly from steam by opening Steam > TF2 > Properties > Installed Files > Browse then open tf > custom

• The HUD looks different than whats shown in the screenshots:

  • Make sure you don't have multiple HUDs inside the custom folder.
  • If no other HUD is present then it might be caused by another MOD inside custom using the same files featured inside the HUD.

CUSTOMIZATIONS MENU

If the game fails to apply the chosen settings inside the customization menu, then it's likely that your custom folder features another MOD that makes also use of the valve.rc file

To get around that simply add this line to your autoexec.cfg

exec hex_customization.cfg

OTHER KNOWN HEXHUD PROBLEMS

• Some of the HUD menus are cut off on the sides

  • Right now HExHUD only supports 16:9 and 16:10 resolutions so any other aspect ratio will suffer this problem!

• Hovering a item in the backpack overlaps the loadouts menu https://i.imgur.com/xsJi6Eu.png

  • This is the only flaw with the current menu design, there isn't a known way to avoid that sadly!

• Unable to switch to the competitive rank https://i.imgur.com/fR8DHzX.jpg

  • I decided to integrate the rank panel with the dashboard and therefore a consequence of this is the inability on changing the displayed rank type

• Strange Mumble overlay look

  • This is caused by mat_aaquality, the HUD uses this command in order to reload the main menu after certain settings are selected in the customization menu, when the value is changed, as a side effect, it might change the look of certain overlays like the mumble one. To fix this problem simply run mat_aaquality 0 in console or if it's already present in your config a game reload is all that's needed to fix the problem.