SOUP Custom HUD

Everyone's got an opinion on the default HUD: it either looks good, bad, or it can be improved upon. Most people generally fall within the second camp and replace the thing outright with a custom HUD. SOUP falls into the last camp of improving upon the default HUD. But what if -- and a novel idea here -- you combined both the best of a custom HUD and an improved upon default HUD? You get SOUP + whatever HUD you'd like. Check that out, UN. Unity is something we can accomplish.

The general guideline to this process is as follows, and this should apply to most HUDs.

Getting Started

SOUP + Custom HUD

Starting with SOUP v1.8.1, you can install a custom HUD and SOUP together without merging at all.

1. Download the latest version of SOUP.
2. Install and setup your custom HUD. You should read whatever instructions are provided to you by the HUD developer.

Common Issues

Removing SOUP backgrounds

There's a good chance your HUD uses a custom main menu background. I can't deny it, they do look cool. But with the previously mentioned method, you'll be stuck with using SOUP's lame-ass stock recreations! If you prefer the look of your HUD's backgrounds, remove the files in materials/console/ from SOUP.

‼️ ATTENTION ‼️ In materials/console/, there's another folder named characters/ that contains the character renders for the main menu. While you may not want the backgrounds, you may want the characters. If that's the case, do not delete materials/console/characters/ from SOUP.

Broken Disguise Kit

If you're seeing issues with your disguise kit, then it has to do with the file scripts/mod_textures.txt. SOUP uses textures that are twice as large as default TF2 for the class selection renders. That file tells the game to use the right dimensions. Other HUDs will load their own art this way, too (this might effect budhud). You can fix this by removing the mod_textures.txt dependency from SOUP.

1. Find the Customization/ folder for SOUP (This comes with the .zip file you downloaded. If you can't find it, you can redownload SOUP).
2. Go inside the Mod_textures-less/ folder.
3. Copy the materials/ folder.
4. Go back into where SOUP is installed and paste the materials/ folder so that it overwrites the same files.
5. Go into SOUP's scripts/ folder.
6. Delete mod_textures.txt.

Missing Main Menu Renders (BLU Team and Robot Engineer)

This one is minor, but some HUDs will use scripts/chapterbackgrounds.txt for custom HUD backgrounds and might not recognize SOUP renders because of this (a HUD such as FlawHUD). Unless you know how to merge the two, you're better off removing the script from SOUP entirely.