🉐 Freelancer UTF Editor

Editor and analysis tool for geometry and resources (UTF / CMP / 3DB) for Freelancer.

---

🌐 Language: 🇷🇺 Russian | ✅ 🇺🇸 English (current)

---

• Dependencies
• Build
• Installation
• Major Changes
  • Geometry Pipeline
  • Texture System
  • Model Validation & Safety
  • VMeshData Refactor
  • Rendering & Debug
  • Asset Pipeline
  • Data Processing
  • Engine-Level Improvements
• Authors & Credits
  • Core Contributors
  • Additional Credits

---

Note

This project is part of the Lizerium ecosystem and belongs to the following direction:

• Lizerium.Tools.Structs

If you are looking for related engineering and utility tools, start there.

---

Caution

Also explore Managed .NET wrapper for the Autodesk FBX SDK 2015. It remained unchanged.

---

Dependencies

For proper operation of the model viewer, DirectX installation may be required:

• DirectX End-User Runtime Web Installer (dxwebsetup.exe)
  https://www.microsoft.com/en-us/download/details.aspx?id=35

---

Build

Requirements:

• Visual Studio 2008 C# Express
• DirectX SDK (August 2007)

---

Installation

Required:

• DirectX 9 (End-User Runtime)
• .NET Framework 3.5 (Client Profile)

---

Note

This project is based on the collective work of the Freelancer community and continues to evolve through accumulated experience and reverse engineering of file formats.

Major Changes

Key changes in the current release.
See CHANGELOG.md for the full list.

---

Geometry Pipeline

A full geometry processing pipeline has been implemented:

• normal recalculation
• tangent / binormal generation
• mesh structure normalization

Important

Proper support for normal mapping and smoothing is now ensured at the geometry level.

---

Texture System

The texture system has been reworked:

• import of .dds and .tga
• MIP level support
• updating existing textures without duplication
• export with manifest.json generation

Tip

Centralized management of texture resources is now supported.

---

Model Validation & Safety

Model structure validation added:

• vertex range checks
• triangle index validation
• VMesh / WireData consistency

Critical issues fixed:

• out-of-bounds access
• handling of null nodes
• corrupted data processing

Important

Invalid data no longer causes application crashes.

---

VMeshData Refactor

Format handling has been reworked:

• FVF logic migrated to bitmask
• TVertex structure simplified
• GetRawData() calculation redesigned

Warning

Changes may be incompatible with older binary data.

---

Rendering & Debug

Geometry analysis tools added:

• normals visualization (DrawNormals)
• UI toggle
• render pipeline control

Tip

A visual debug mode for geometry and lighting analysis is now available.

---

Asset Pipeline

Texture search mechanism reworked:

• depth limitation removed
• search now continues up to filesystem root

Important

Fixes cases where textures could not be found due to directory structure.

---

Data Processing

Data processing operations added:

• model scaling
• hardpoints import / export (THN)
• bulk replace
• wireframe rebuild

---

Engine-Level Improvements

Core system improvements:

• NodeChanged synchronization
• automatic CRC updates
• improved stability when working with binary structures and invalid data

---

Authors & Credits

Core Contributors

• Adoxa — fixes and improvements (2.1, 3.0)
• Cannon — development of version 2.0, model viewer
• FriendlyFire — hardpoint support and fixes
• w0dk4 — fixes and support for normal mapping

---

Additional Credits

Tip

This project continues the work started by Colin Sanby and Mario "HCl" Brito. Original versions and updates can be found at: http://the-starport.net

• Mario "HCl" Brito — UTF (CMP) structures, original utf_edit source code
• Colin Sanby — CMP Exporter, SUR Importer, SurDump.exe
• Anton — FLModelTool
• LancerSolurus — SUR structure information
• Martin Baker — matrix and Euler angle conversions
  http://www.euclideanspace.com/

---