Skip to content

BattlezoneScrapField/Battlezone98Redux_TextureManager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BZR Texture Manager (BZRTEX)

A comprehensive utility suite designed for Battlezone 98 Redux modders. This tool streamlines the asset pipeline by providing specialized converters and editors for the game's unique file formats.

Features

ACT Palette Editor

The ACT Editor is purpose-built for the Battlezone .ACT format (256-color indexed palette). Unlike generic editors, this includes a Quick Jump system for critical engine-reserved indices.

  • Reserved Index Awareness: Instant access and labeling for key indices:
    • Index 223: Skybox color and Sniperscope lens tint.
    • Index 209: Global Fog color (horizon transition).
    • Indices 0-95 / 224-255: Primary and Secondary Object ranges. These seem to be ignored by Redux.
    • Indices 96-222: Planet-specific terrain smoothing range. These seem to be ignored by Redux.
  • Visual Feedback: Selected colors are highlighted in a 16x16 grid with real-time RGB and Hex editing.
  • Sync Logic: Changes to the palette automatically update the preview in the MAP Converter tab.
image

Texture Manager (DDS/TGA/PNG)

An advanced processor for standard game textures, optimized for VRAM management and engine compatibility.

  • Format Conversion: Custom "Convert From" and "Convert To" logic supporting PNG, TGA, and DDS with batch capabilities.
  • Smart Compression: Support for DXT1 (Opaque) and DXT5 (Interpolated Alpha), or a setting for no compression.
  • Alpha Auto-Detection: Scans images during batch processing to automatically choose the most efficient compression codec.
  • Power of 2 Rescaling: Conditional downscaling logic (512 to 4096) to ensure textures fit within performance budgets.
  • Mipmap Generation: Optional mipmap creation to prevent distant texture shimmering.
  • Automatic Normal/Specular/Emissive Generation: Optional additional texture generation with flip normals option, and sliders for thresholds.
  • Overwrite Existing Option
  • Multithreading Support: Main window won't freeze during long batch processes.
  • Progress Bar: Shows progress for large batches.
  • Recursive Batch Processing: Optional subfolder scanning, folder preservation, and cancel support for long-running jobs.
image

MAP Texture Serializer

Handles the conversion of .MAP files, which are the specialized textures used by the legacy Battlezone game system.

  • Bidirectional Conversion: Convert .MAP to .PNG for editing and back to .MAP for the game.
  • Palette Serialization: Correctly applies your active .ACT palette to indexed MAP files during export. Has built in palette data so you don't need an ACT file.
  • Redux Support: Automatically packs textures as ARGB8888 when required for high-definition assets.
image

LGT Light Converter

A dedicated tool for converting .LGT lightmap files into editable .PNG images.

  • LGT to PNG: Decodes game lightmaps into editable grayscale images.
  • PNG to LGT: Repacks the PNG to an LGT file
  • Batch Workflow: Process entire mission folders of lightmaps simultaneously.
image

DXTBZ2 Texture Converter

A tool to convert proprietary BZ2 encoded textures to PNG or DDS.

  • DXTBZ2 to DDS
  • DXTBZ2 to PNG
  • Single or Batch Processing
  • Thanks to VEARIE for the DXTBZ2 direct python code!
image

Installation & Requirements

For Users

Download the latest BZR Texture Manager.exe from the Releases section. No Python installation is required.

For Developers

If you wish to run from source or modify the tool:

  1. Clone the repo: git clone <repository-url>

  2. Install dependencies: pip install -r requirements.txt

  3. Download texconv.exe from Microsoft's DirectXTex GitHub and place it in the repo root before running or building if you want full DDS compression support.

  4. Run the application: python src/tex_man.py

  5. Build command: python -m PyInstaller --noconfirm --onefile --windowed --name "BZR Texture Manager" --icon "bzrtex.ico" --add-data "bzrtex.ico;." --add-data "BZONE.ttf;." --collect-all customtkinter --copy-metadata imageio --hidden-import tkinterdnd2 src/tex_man.py

  6. Run the support tests: python -m unittest discover -s tests -v

Runtime Notes

  • Settings now live under your user app-data folder instead of the working directory.
  • If tkinterdnd2 is not installed, the app still runs, but drag-and-drop is disabled and reported in startup diagnostics.
  • If texconv.exe is missing, DDS output falls back to basic imageio DDS writing.

About

Mass texture conversion and creation utility. Handles DDS (mipmaps, compression, resizing, etc), PNG, smart normals, and more.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages