Kolto Labs — Life support for the Odyssey engine

Kolto Labs

Life support for the Odyssey engine.

We build open-source tools for Star Wars: Knights of the Old Republic and Knights of the Old Republic II — The Sith Lords. Kolto Labs is an independent, non-commercial fan project with a simple mission — keep the games moddable for the next twenty years.

Our work spans game-data libraries, command-line inspection, mod installation, and development tools for the Odyssey engine. Our main project is Kolto Tank, a browser-based way to play both games with mods, a debugger, and tool-assisted speedrunning (TAS) tools. Kolto Tank is in development.

Website · GitHub · Projects · Roadmap · FAQ

Tools you can use today

kq

Query a Knights of the Old Republic installation like it was plain text.

kq treats a game installation as structured, searchable data. It reads archives in place and decodes resources into readable text, field paths, and machine-readable output.

Install from GitHub with Cargo, then point it at your own game installation.

cargo install --git https://github.com/kolto-labs/kq --locked
kq -i /path/to/kotor info
kq -i /path/to/kotor which appearance.2da
kq -i /path/to/kotor cat appearance.2da

The starred result from which identifies the resource the game loads. This helps explain why an installed mod's changes may be hidden by another copy of the same resource.

Source and installation · User guide · Releases

kotor-formats

Shared Rust readers and writers for the games' file formats.

These libraries keep common byte layouts in one place so tools can share the same format implementation. The repository contains four focused crates.

Crate Purpose
kotor-ncs-isa NCS bytecode instruction-set definitions
kotor-ncs NCS reading, writing, and a decompiler built on the DeNCS algorithm
kotor-formats GFF, 2DA, TLK, SSF, and ERF/RIM readers and writers
kotor-diff Structural comparison of decoded resources

The libraries preserve field types, widths, raw labels, and padding. Loading and saving an unchanged file is designed to reproduce its exact bytes. Text is stored through a reversible byte mapping, and parsing is strict by default with explicit options for lenient reading.

The API is early and evolving. Depend on a Git tag, using the same repository ref for all crates you consume together.

Source and integration guide

OdyPatcher

A Rust mod installer and game-data patcher for KotOR and The Sith Lords.

OdyPatcher rewrites the TSLPatcher workflow for Windows, macOS, and Linux, with a graphical interface and command-line operation. It applies a mod's installation instructions to game data, including string tables, 2DA tables, GFF fields, byte patches, script compilation, soundsets, and file copies.

Source and usage · Releases

In development

Kolto Tank

We're building Kolto Tank to bring KotOR I and II into a web browser. The planned experience includes a library of mods and extensions, updates without reinstalling mods, a full debugger, and TAS tools.

Players will supply their own games. Planned options include linking an owned copy from Steam, GOG, or Amazon, or uploading their own game files. Support for phones, tablets, and TVs is also planned. These features remain under development, and Kolto Tank is awaiting public availability.

Project overview · Availability and play information

Hyperstim and Adrenal

Hyperstim is a script extender under development for both games. Adrenal is our scripting project for KotOR and TSL mods. Script bindings and modder-facing scripting are part of the roadmap.

Hyperstim · Adrenal

Planned work

Our published roadmap tracks the released foundations, active work on Kolto Tank and scripting, and the later documentation and long-term projects. Follow it for progress and availability.

Full roadmap

Get involved

We welcome reverse engineers comfortable with 32-bit x86 and tools such as Ghidra or IDA, Rust developers interested in binary formats and exact round trips, and modders who want to help shape scripting and development tools.

There is also room for testers across game editions and storefronts, technical writers, ASCII/ANSI artists, and chiptune musicians. A reproducible bug report is a concrete way to help. Include the project, game edition, tool version, steps to reproduce, and expected and observed results.

Open an issue or pull request in the relevant repository. Our community guidelines follow Contributor Covenant 2.1 and welcome newcomers, constructive discussion, and respectful collaboration.

Repositories and issue trackers · Community guidelines

Built on community knowledge

Two decades of community work made these tools possible. We credit stoffe's TSLPatcher, Fred Tetra's KotOR Tool, Torlack's nwnnsscomp, JdNoa and Dashus's DeNCS, the MDLOps and kotorblender lineage, xoreos, and the K1SE and K2SE script extenders.

Our thanks also go to Deadly Stream, the LucasForums archivists, the KOTOR Community Portal, r/kotor, Nexus Mods, NWNX, and the decompilation community.

Full credits and project links

Licensing and game ownership

kq and kotor-formats are MIT-licensed. OdyPatcher is AGPL-3.0-licensed. Consult each repository's license and notices when using or redistributing its code.

Our tools work with your own legally obtained game files. We distribute our tooling independently of the original games, whose assets and executables remain with their owners.

Kolto Labs is an independent, non-commercial fan project, unaffiliated with Lucasfilm, Disney, BioWare, Electronic Arts, Obsidian, Aspyr, or Saber Interactive. Star Wars and the original games belong to their respective rights holders.


Bring your own game. We bring the kolto.