POX Tool – New POX Builder & Extractor for Siege of Avalon

    • New

    POX Builder

    ===========


    POX Builder is a new, modern tool for working with POX files from

    Siege of Avalon.


    It completely replaces the original legacy POX tools, which relied on

    outdated Windows APIs and 16/24-bit display modes that no longer function

    reliably on modern operating systems.


    This tool works entirely offline, is scriptable, batch-friendly, and

    fully compatible with Windows 10 and Windows 11.


    ------------------------------------------------------------

    WHAT IT DOES

    ------------------------------------------------------------


    POX Builder supports the full round-trip workflow:


    Export:

    Extracts any .pox file into:

    - a readable .ini file

    - a sequence of PNG images (with proper transparency)


    Generate:

    Rebuilds valid .pox files from an .ini file and PNG images


    The generated POX files are game-compatible and can be loaded by

    Siege of Avalon without using any original tools.


    ------------------------------------------------------------

    FEATURES

    ------------------------------------------------------------


    • Replaces all legacy POX tools
    • No 16/24-bit display mode required
    • Works on modern Windows versions
    • Correctly handles:
      • RGB565 encoding
      • RLE compression
    • TransparentColor key-color transparency
    • Character, item, and building/tile POX files
    • Supports recursive batch processing
    • Single-file Python script
    • Fully reversible (POX → PNG/INI → POX)


    ------------------------------------------------------------

    REQUIREMENTS

    ------------------------------------------------------------


    • Windows 10 / 11
    • Python 3.9 or newer (tested with Python 3.14.x)
    • Pillow library


    Install dependency once:


    python -m pip install pillow


    ------------------------------------------------------------

    USAGE

    ------------------------------------------------------------


    Export all POX files under a directory (recursive):


    python pox_tool.py -export "C:\Path\To\Assets"


    This creates a folder, next to each POX file:


    <POX_NAME>\

    <POX_NAME>.ini

    <POX_NAME>_001.png

    <POX_NAME>_002.png

    ...


    Generate POX files from extracted folders (recursive):


    python pox_tool.py -generate "C:\Path\To\Assets"


    This will:

    • Rebuild the POX file one directory level above the extracted folder
    • Overwrite the original POX file
    • Delete the extracted PNG/INI folder after success


    ------------------------------------------------------------

    NOTES

    ------------------------------------------------------------


    • Frame order is determined by filename (natural sorting)
    • Maximum supported frames per POX: 999
    • TransparentColor is read from the INI and handled correctly
      • Hint: Just use transparency instead of relying on a color (PNG)!
    • POX resource type is preserved automatically


    ------------------------------------------------------------

    INTENDED USE

    ------------------------------------------------------------


    POX Builder is intended for:

    • Modding
    • Asset restoration
    • Long-term preservation of Siege of Avalon assets


    ------------------------------------------------------------

    ATTACHMENTS

    ------------------------------------------------------------


    Due to platform restrictions, the Python script is provided as a .txt file.

    After downloading, simply rename the file from:


    pox_tool.txt


    to:


    pox_tool.py


    No changes to the file contents are required.

    • New

    GIF <> POX (for working with MaskEdit, especially useful when creating completely new props).


    Requirements are the same as above. (Python, Pillow, etc.)


    Rename the file from "pox_gif_converter.txt" to "pox_gif_converter.py".


    # python pox_gif.py --pox2gif "C:\Program Files (x86)\Steam\steamapps\common\Siege of Avalon Anthology\ArtLib\Resources\StaticObject\Furniture\Tables"

    # python pox_gif.py --gif2pox "C:\Program Files (x86)\Steam\steamapps\common\Siege of Avalon Anthology\ArtLib\Resources\StaticObject\Furniture\Tables"