tex-tools README
================

tex-tools is a small utility for working with textures in Hover!
It allows you to extract the game’s texture files into editable PNGs and repack them afterwards.

Installation
------------

Copy all .exe and .bat files into the Hover game directory (the same folder where hover.exe is located).

Usage
-----

Extracting:
    tex2png <input_file> <output_directory>

Or simply run extract-all-textures.bat to extract all textures at once.
This will create a 'textures' folder and split the four game texture files into separate subdirectories.

Bundling (Repacking):
    png2tex <input_directory> <output_file> [-p]

- With -p: applies the palette.act file from the given input directory.
- Without -p: a palette is generated automatically. This feature is still experimental and will be improved in future versions.

File naming
-----------

Filenames are based on the texture name and end with either _T or _D:
- _T default for regular textures
- _D used for transparent/masked textures (decals, decorations, etc.)

Example:
The texture WBASE_00 maps to WBASE_00_T.png, while DECAL_07 maps to DECAL_07_D.png.

Restrictions
------------

- Textures must use power-of-two dimensions (e.g. 64x64, 128x256). Arbitrary sizes like 40x67 are not supported.
- All textures are reduced to 256 colors.

Known issues
------------

- If too many textures are loaded, Hover! may crash.

Notes
-----

- Always keep a backup of the original texture files before replacing them.
- Take some time to look at the extracted original textures - it helps to understand how Hover! uses them (walls, floors, decals, decorations, etc.).
