Lizerium.BINI.Converter

.NET • Nuget • Browser • npm • CLI

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

---

Note

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

• Lizerium.Tools.Structs

If you're looking for related engineering and support tools, start there.

---

Lizerium.BINI.Converter is a cross-platform toolkit for Freelancer BINI: .NET 8, Browser, npm, CLI - for Freelancer BINI files: unpack binary BINI into editable INI text and pack text INI back into the original game format.

What It Does

---

• Converts Freelancer .ini files both ways: BINI -> text INI and text INI -> BINI.
• Detects BINI automatically by file signature.
• Preserves Freelancer-specific value behavior, quoting rules, numeric values, and corrupted-file checks inspired by skeeto/binitools.
• Ships as a reusable library plus Lizerium.BINI.Converter.App for real file work.
• Includes a local web UI: drag an .ini into a browser page, convert it, download the result, and preview text output.
• Includes a static GitHub Pages portal with a browser JavaScript BINI converter.
• Has a no-framework console tester with binitools fixtures and optional Freelancer folder roundtrip checks.
• Contains an xUnit project with tests. (546+ tests)
  • 
• Example web page - https://lizerium.github.io/Lizerium.BINI.Converter/
• Publish NPM packet for JavaScript / Node.js:
  • https://www.npmjs.com/package/lizerium-bini-converter
• Publish Nuget packet for .NET:
  • https://www.nuget.org/packages/Lizerium.BINI.Converter

Packages

• NuGet (.NET): Lizerium.BINI.Converter
• npm (JavaScript): lizerium-bini-converter
• Browser Portal: GitHub Pages

Projects

• app/Lizerium.BINI.Converter - the reusable net8.0 library.
• app/Lizerium.BINI.Converter.App - CLI and local web UI.
• app/Lizerium.BINI.Converter.Tester - console verification runner.
• app/Lizerium.BINI.Converter.Visual.Tester - xUnit test project for Test Explorer and CI.

Documentation

All usage instructions live in docs:

• NuGet package usage
• App, CLI, and local web UI
• Build and verification
• Roadmap
• Static portal

Quick Taste

using Lizerium.BINI.Converter;

byte[] bini = File.ReadAllBytes("market_commodities.ini");
string text = BiniConverter.ConvertBiniToText(bini);

byte[] packed = BiniConverter.ConvertTextToBini(text);

Credits

Christopher Wellons - skeeto/binitools