Skip to content

OpenKotOR/ChangeEdit

Repository files navigation

ChangeEdit

ChangeEdit (v1.0.3a) is a GUI editor for changes.ini files used by TSLPatcher, the standard mod installation tool for Knights of the Old Republic (KotOR 1 & 2). It provides a form-based interface so mod authors can configure how TSLPatcher will patch game files without manually hand-editing INI syntax.

Developer's own note (from UMainForm.pas): "Quick GUI CHANGES.INI file Editor for the TSLPatcher. Warning: This is a textbook example of an unplanned, unstructured hack of an application. At least it gets the job done for now..."


What it does

A changes.ini file tells TSLPatcher which game files to modify and how. ChangeEdit exposes every supported operation as a point-and-click form:

Section Operations
Settings Patch caption, confirmation text, log style, mode, backup count, required-file checks
TLK Map StrRef tokens to localised dialog strings, optional sound overrides
2DA Add rows, modify cells, copy rows, add columns — for binary .2da game tables
GFF Modify fields inside BioWare .gff/.uti/.utc/.dlg structured files
Script Register .nss source scripts for compilation and installation
Install Copy arbitrary files into the game folder tree
SSF Edit soundset field assignments (GFF-wrapped .ssf files)
Namespace Map alternate INI/RTF filenames for namespaced mod packages

File formats handled

Format Extension(s) Handler unit
2DA Binary v2.b .2da U2DAEdit
GFF v3.2 .gff, .uti, .utc, .dlg, .ssf, … UGFFFile
Dialog strings .tlk UTLKFile
Patch config .ini UST_IniFile

Quick start

  1. Build the project with Delphi 7 on Windows (see BUILD.md).
  2. Launch ChangEd.exe.
  3. File → Open to load an existing changes.ini, or File → New to start from scratch.
  4. Navigate the left-hand tree to the section you want to edit.
  5. Use the buttons on each panel to add, modify, or delete entries.
  6. File → Save or File → Save As to write the updated changes.ini.

Project structure

ChangEd.dpr           Program entry point (registers all forms)
UMainForm.pas/.dfm    Main window (tree + stacked panels)
U2DAEdit.pas          Binary 2DA v2.b reader/writer
UGFFFile.pas          GFF v3.2 reader/writer (18 field types)
UTLKFile.pas          TLK dialog string reader/writer
UST_IniFile.pas       Extended INI reader/writer (escape sequences)
UST_Common.pas        Shared utility functions
UStrTok.pas           String tokenizer
U*Form.pas/.dfm       Modal dialog forms (one per editing operation)
TODO.txt              Known issues and task list

Full module-by-module breakdown: ARCHITECTURE.md


Requirements

  • Build host: Windows (Delphi 7 compiler — see BUILD.md)
  • Runtime: Windows 9x / NT 4+ (XP visual styles via TXPManifest)
  • Linux: Run the compiled .exe under Wine

Related

About

GUI editor for changes.ini files used by TSLPatcher, the standard mod installation tool for Knights of the Old Republic (KotOR 1 & 2)

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages