Reading, analysis, and serialization of Freelancer game data

This repository contains extracted and enhanced libraries for working with Freelancer game data, originally taken from the LibreLancer project and reworked into a standalone toolkit.

The project no longer depends on LibreLancer and is maintained independently.

• This project is not intended for commercial use
• Core components were originally sourced from the open-source LibreLancer project
• Commercial use is at your own risk

With these libraries you can:

• 📂 Read the entire structure of a Freelancer game installation
• 🧠 Load all game data into memory
• 🔍 Analyze configurations (freelancer.ini, etc.)
• 🔁 Serialize game state into JSON
• 🧩 Work with mods (extended support included)
• ⚙️ Build your own tools:
  • Mod Manager
  • Data analyzers
  • Config generators
  • Testing environments

Build the project and reference:

• Lizerium.Librelancer.DataBridge.dll
• LibreLancer.Base.dll

(Prebuilt binaries are available in the Releases section)

using LibreLancer.Data;

var freelancerPath = "C:\\Program Files (x86)\\Freelancer";

var vfs = LibreLancer.Data.IO.FileSystem.FromPath(freelancerPath);

var ini = new FreelancerIni(vfs);
var data = new FreelancerData(ini, vfs);

data.LoadData((msg) =>
{
    Console.WriteLine(msg);
});

Console.ReadLine();

• ini → game configuration (freelancer.ini)
• data → entire game loaded into memory (structures, parameters, resources)

var settings = new JsonSerializerSettings
{
    TypeNameHandling = TypeNameHandling.Auto
};

var json = JsonConvert.SerializeObject(data, settings);
File.WriteAllText("freelancer_dump.json", json);

var settings = new JsonSerializerSettings
{
    TypeNameHandling = TypeNameHandling.Auto
};

var json = File.ReadAllText("freelancer_dump.json");
var data = JsonConvert.DeserializeObject<FreelancerData>(json, settings);

The toolkit operates as:

Freelancer Folder → VFS → INI → Data Model → JSON / Runtime

• Virtual File System (VFS)
• Configuration parsing
• Full game model construction
• Further processing

• Support for modded game versions
• Extended data loading
• Ability to create full game state snapshots
• Minimal entry point — literally 3 lines of code

This project is especially useful if you:

• develop Freelancer mods
• build analysis tools
• write server-side logic (FLHook / custom servers)
• want to automate working with game resources

The project is actively used as an internal tool, but may continue evolving.

This project is based in part on code originally derived from the LibreLancer project, which is distributed under the MIT License

This repository contains extracted, adapted, and modified components used for reading, parsing, and serializing Freelancer game data in a standalone form.

Original copyright belongs to:

• Callum McGing, Librelancer Contributors (2013–2026)
• Malte Rupprecht (2011–2012)
• Mono.Xna Team (2006)

All modifications and standalone toolkit integration in this repository are maintained separately.

CREDITS