The Half-Life 25th Anniversary update introduced support for higher screen resolutions. However, to properly display weapon sprites in the updated HUD, the associated .spr and .txt files must be updated. Without these updates, the sprites may appear distorted or misaligned.
This utility automates the process of generating updated .spr and .txt files, ensuring compatibility with the new resolution support and streamlining the workflow.
12
weapon 320 320hud1 0 80 80 20
weapon_s 320 320hud1 0 100 80 20
ammo 320 320hud2 18 16 18 18
crosshair 320 crosshairs 48 0 24 24
autoaim 320 crosshairs 24 72 24 24
zoom 320 crosshairs 96 0 24 24
weapon 640 640hud1 0 90 170 45
weapon_s 640 640hud4 0 90 170 45
ammo 640 640hud7 24 72 24 24
crosshair 640 crosshairs 48 0 24 24
autoaim 640 crosshairs 24 72 24 24
zoom 640 crosshairs 96 0 24 24
24
weapon 2560 2560/weapon_357_weapon 0 0 510 135
weapon_s 2560 2560/weapon_357_weapon_s 0 0 510 135
ammo 2560 2560/weapon_357_ammo 0 0 72 72
crosshair 2560 2560crosshairs 144 0 72 72
autoaim 2560 2560crosshairs 72 216 72 72
zoom 2560 2560crosshairs 288 0 72 72
weapon 1280 1280/weapon_357_weapon 0 0 340 90
weapon_s 1280 1280/weapon_357_weapon_s 0 0 340 90
ammo 1280 1280/weapon_357_ammo 0 0 48 48
crosshair 1280 1280crosshairs 96 0 48 48
autoaim 1280 1280crosshairs 48 144 48 48
zoom 1280 1280crosshairs 192 0 48 48
weapon 640 640hud1 0 90 170 45
weapon_s 640 640hud4 0 90 170 45
ammo 640 640hud7 24 72 24 24
crosshair 640 crosshairs 48 0 24 24
autoaim 640 crosshairs 24 72 24 24
zoom 640 crosshairs 96 0 24 24
weapon 320 320hud1 0 80 80 20
weapon_s 320 320hud1 0 100 80 20
ammo 320 320hud2 18 16 18 18
crosshair 320 crosshairs 48 0 24 24
autoaim 320 crosshairs 24 72 24 24
zoom 320 crosshairs 96 0 24 24
Follow these steps to configure the environment for the utility:
-
Install Python 3.
-
Clone the repository or download the contents as a compressed archive and extract them.
-
Install the required Python packages by running:
pip3 install -r requirements.txt
-
The utility can automatically use paths to the standard highres sprites for ammo and crosshairs added in the HL25th Anniversary Update (it will be done if your sprite uses their default versions in resolution 640). To avoid issues, make sure to add them to the server's precache.
-
Configuration is complete! You are now ready to use the utility.
-
Place all the required
.sprand.txtfiles in a single directory (see example below):
-
Run the utility using the following command:
python3 hud_upscaler.py --path /path/to/directory/with/your/weapon/sprites --umodel edsr-base
-
--path: The path to the directory containing your.sprand.txtfiles. -
--umodel: The name of the upscaling model to use.
You can find the list of available models here or in the table below:
