BZCC Sprite Viewer

Inspect, adjust, export, and edit Battlezone-style sprite.txt texture entries from one compact desktop tool.

What it does

BZCC Sprite Viewer reads sprite-table entries from sprite.txt, resolves their referenced texture files, and gives you a visual workspace for inspecting and editing the resulting crops.

It is useful when a sprite definition is technically valid but painful to reason about from coordinates alone.

Quick start

Requirements: Windows, Python 3, and Pillow.

pip install Pillow
python BZCC_SpriteViewer.py

The bundled texconv.exe is used when DDS conversion is required; its licence is recorded in THIRD-PARTY-NOTICES.md.

Highlights

• compact sprite tree plus two-column property editor;
• recursive texture resolution from sprite-table entries;
• live adjustment preview;
• raw-crop save and adjusted export as separate actions;
• batch export for visible sprites or the current file group;
• save a modified sprite-table copy instead of silently rewriting the source;
• modified-entry highlighting;
• image-size and zoom information in the UI;
• Windows clipboard integration with a safe temp-file fallback;
• persistent configuration in sprite_viewer_config.json.

Repository

Path	Purpose
BZCC_SpriteViewer.py	current viewer/editor
BZCC_SpriteViewer_01.py	retained alternate/older implementation
sprite_viewer_config.json	persisted viewer configuration
build_exe.py	executable build helper
texconv.exe	DDS conversion backend

Screenshots

Open interface gallery

Project network

Part of the broader SAIPEN / vacterro project ecosystem.

Author hub · SAIPEN HQ · SAIPEN Core · ZAICODE · FastPrompter · SAIPEN Community

For reproducible bugs and durable feature requests, use GitHub Issues.

---

_{If BZCC Sprite Viewer is useful to you, optional support: Buy Me a Coffee · Boosty · PayPal · other ways}