AoM File Converter

Contents

1. Requirements
2. Installation
3. Application Information
4. Usage
5. Support
6. Changelog
7. Credits

Requirements

• .NET 6.0 Runtime (x64 or x86 depending on your OS)

Installation

To install, simply EXTRACT everything from the zip file to a desired location, and drag/drop any supported file on the AoM File Converter.exe file.

Application Information

This application converts anim.txt, ddt, bti, cub, prt, mtrl, brg, xmb, scn, and scx files to user friendly formats for the Age of Mythology game.

Usage

Simply drag, and drop (or use Open With) an anim.txt, prt, xmb, or mtrl file on the EXE to convert it to an Xml file, or the other way around to convert it accordingly.

Drag an scn or scx file to either decompress it or compress it depending on its current state.

The output file will be in the same location as the input file, but with an added extension.

Drag a bar file to extract its contents to a new folder next to it. Drag a folder to create a new bar file next to the folder with the same name + ".bar" extension.

Drag a Brg file on the EXE to extract all of its Mtrl files into a materials folder in the same path as the brg file.

Converting bti/cub to ddt

Texture files can be converted by dropping a bti or cub file on the application executable. If a bti file is dropped, the app expects to find a tga/png file with the same name. If a cub file is dropped, the app expects to find bti/tga/png files in the same folder as the cub with the names specified inside of the cub file.

The bti file must specify the number of alpha bits, and the format. For example: alpha=1 fmt=BC3 Avoid using alpha higher than 1 unless you want the game to render partially transparent models which is computationally more expensive. The following formats are supported:

BC1, Alpha 0

RBG 565 with no alpha. Colors use 4 element palette per 4x4 block.

BC1, Alpha 1

RBG 565 with alpha 1. Colors use 3 element palette per 4x4 block when the block has alpha, and 4 when it doesn't. Alpha is either on or off.

BC2, Alpha 4

RGB 565 with alpha 4. Colors use 4 element palette per 4x4 block. Alpha uses 16 element palette per 4x4 block. Alpha value is 4 bits (16 colors).

BC3, Alpha 1

RGB 565 with alpha 1. Colors use 4 element palette per 4x4 block. Use this when you want more accurate colors than BC1, Alpha 1 at the expense of doubling the file size.

BC3, Alpha 8

RGB 565 with alpha 8. Colors use 4 element palette per 4x4 block. Alpha uses 8 element palette per 4x4 block. Alpha value is 8 bits (256 colors). Typically prefer this over BC2.

DeflatedRGB8, Alpha 0

RGB 888 with no alpha. Each pixel's color components are 8 bits (256 colors). Image compressed with Deflate compression algorithm. Serves as a higher quality version of BC1 alpha 0.

DeflatedRGBA8, Alpha 0

RGB 888 with alpha 0. Each pixel's color components (inc. alpha) are 8 bits (256 colors). Image compressed with Deflate compression algorithm. Alpha 0 version effectively throws away alpha version. Prefer DeflatedRGB8 instead.

DeflatedRGBA8, Alpha 1

RGB 888 with alpha 1. Each pixel's color components (inc. alpha) are 8 bits (256 colors). Image compressed with Deflate compression algorithm. Serves as a higher quality version of BC1/BC3 alpha 1.

DeflatedRGBA8, Alpha 8

RGB 888 with alpha 8. Each pixel's color components (inc. alpha) are 8 bits (256 colors). Image compressed with Deflate compression algorithm. Serves as a higher quality version of BC2/BC3 alpha >1.

In addition to alpha and format, the following properties can be specified in the bti file:

nomip

Disables generation of mip levels.

noalphatest

Tells the renderer not to make invisible the parts of the texture where the alpha is 0. This is typically used when the alpha represents where to use player color.

Support

You can get support by asking in the modding channels of the following communities:

• AoM HeavenGames Forum
• Fan Created AoM Discord
• Official AoM Discord

If you think you've found a bug, post an issue here with as much information as possible.

Changelog

• 1.4.0+20220903
  • Added support for bar file creation and extraction.
  • Added support for conversion between xml and xmb.
• 1.3.1+20210502
  • Fixed bug in prt conversion causing colors to be incorrectly converted.
• 1.3.0+20210408
  • Added support for converting ddt to bti/cub/tga.
  • Added support for converting bti/cub/tga/png to ddt.
• 1.2.0+20200629
  • Improved conversion from brg materials to mtrl files.
  • Fixed xml conversion of additional texture names in mtrl files.
• 1.1.0+20190324
  • Added support for version 11 prt files
  • Changed versioning scheme to semantic versioning 2.0.0
• 1.0.2016.0909
  • First Release

Credits

• Petar - For creating the program.
• steves - Providing the program icon. (https://www.deviantart.com/steves/art/10-Age-of-Mythology-XP-Icons-562480)