Ego File Converter

Contents

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

Requirements

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

Installation

EXTRACT everything from the zip file to a desired location, and run the ego-file-converter.exe file.

Application Information

An app to convert binary XML, Lng, Tpk, and Pkg files to common formats for EGO engine games.

Usage

Drag and drop (or use Open With) any supported file type on the executable to convert it to a common file format and back. Alternatively, you can right-click a file, click "Open With", and choose the exe. Use the app's help menu (e.g. -h or vc-to-gltf -h) to get details on all the commands.

Pass the -h option on the command line to get help text for any command.

Possible conversions:

• Binary XML <-> XML
• Pkg <-> JSON
• Lng <-> XML (DO NOT change the "info" section)
• Tpk <-> DDS (file name ending with .tpk.dds)
• track.jpk <-> glTF

Note: After conversion, the output file will overwrite any existing file. Output file names are the input file + ".xml", ".json", ".lng", ".dds", ".tpk", ".pkg", ".glb", ".gltf", or ".track.jpk"

When converting a tpk, the app will display the internal name and image format. When converting dds back to tpk make sure to set the file name to the internal tpk name.

Track Quad Tree

Track quad tree files are track.jpk, vcqtc, and cqtc. They control ground collision, boundary lines, and reset lines. They can be converted using separate commands from the typical drag-and-drop workflow.

Track.jpk, and vcqtc files can be converted using the following commands in terminal:

• track-qt vc-to-gltf "C:\path\track.jpk"
• track-qt gltf-to-vc "C:\path\track.jpk.glb" -t RaceDriverGrid
• Available Types
  • RaceDriverGrid - Grid, Dirt 2, F1 2010 - 2014
  • Dirt3 - Dirt 3
  • DirtShowdown - Dirt Showdown, Grid 2, Grid Autosport, Dirt Rally

Cqtc files can be converted using the following commands in terminal:

• track-qt cq-to-gltf "C:\path\boundarylines.cqtc"
• track-qt gltf-to-cq "C:\path\boundarylines.cqtc.glb" -t Dirt
• Available Types
  • Dirt - Dirt, Grid, Dirt 2, F1 2010 - 2014, Dirt 3, Dirt Showdown, Grid 2, Grid Autosport, Dirt Rally

Support

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

• Ego Engine Modding Discord
• Dirt 3 Discord
• F1 Game Modding Community Discord
• OverTake Sim Racing Community

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

Changelog

• 4.0.0+20250104
  • Added support for converting track quad tree files
  • Improved CLI experience
  • Changed app exe name to ego-file-converter
  • Changed .NET framework to .NET 8.0
• 3.0.1+20221016
  • Fixed bug converting BXML big-endian files
• 3.0.0+20220215
  • Added support for tpk files
  • Added support for latest pkg files
  • Changed .NET framework to .NET 6.0
• 2.1.2016.1119
  • Fixed crash when converting BXML big files (ex: surface_materials.xml)
• 2.0.2016.0905
  • Added support for converting Lng files to XML
  • Added ability to auto-detect original binary xml type
  • Fixed importing rgba data from JSON file
  • Fixed reading and writing strings longer than 127 bytes in Pkg files
  • Added support for Pkg files with !iar chunk
• 1.0.2016.0902
  • First Release

Credits

• Petar Tasev - For creating the program.
• luh-koala - For creating the icon.