A tool for fixing, cleaning up, and updating GTA IV openFormats vehicle data, handling .oft, .skel, .child, and .mesh files.
This tool parses openFormats vehicle exports to apply automated fixes for common structural and mathematical issues, including those introduced by ZModeler 2. It automatically corrects collision group f50 and f8 bounds using a mass-weighted average of CenterOfMass data. The tool also provides functionality to recalculate corrupted mesh tangents, clear unused UV fields, strip redundant data values, and fix badge shaders.
All modified files are safely exported to a dedicated output/ directory, leaving the original source files completely untouched.
- Run the executable directly to enter interactive mode, or launch it by dragging a vehicle
.oftfile onto the executable. - Follow the on-screen prompts to apply or skip specific fixes.
| Option | Description |
|---|---|
| Collision Bounds & CenterOfMass | Computes proper collision bounds for .oft from .child files and offers to sync a stale global CenterOfMass. |
| Value Cleanup | Strips redundant padded fourth values from .oft, .skel, and .child text files. |
| Body Mesh Tangents | Recalculates tangents for body meshes on materials that utilize normal maps. |
| Wheel Tangent Fix | Recomputes wheel mesh tangents to fix ZModeler 2 corruption and clears trailing UV1–UV5 fields back to zero. |
| Badge Shader Fix | Corrects broken gta_vehicle_badges.sps shader parameters inside the .oft file for a proper burnt texture ingame. |
Batch mode can be initiated by selecting a root directory containing multiple vehicle folders. The tool will prompt for your preferred toggle states once, and then apply those configurations to all valid vehicles found in the directory.
- Thundersmacker — original Door/Bonnet/Boot Physics Fix, advising and testing
- Claude — assisted with research, development, and documentation