Skip to content

Getting Started

Boden edited this page May 28, 2026 · 1 revision

Getting Started

This page is the fastest orientation pass for someone opening ChangeEdit for the first time.

What ChangeEdit Does

ChangeEdit edits the changes.ini control file used by TSLPatcher. Instead of typing every section and key by hand, you use dedicated panels and dialogs for the major patch surfaces:

  • installer settings
  • TLK token setup
  • 2DA table modifiers
  • GFF-family file modifiers
  • file installs
  • script compilation
  • SSF token mapping
  • namespace setup lists

Open An Existing Config Or Start A New One

  • Opening a file expects a valid [Settings] section and then loads the tree from TLKList, 2DAList, GFFList, SSFList, InstallList, and CompileList.
  • Creating a new file pre-creates the fixed top-level sections and writes Settings.FileExists=1 so the file starts from a valid baseline.

Main Window Tour

Tree section What you do there
Settings Control installer text, backup behavior, log style, required-file checks, game lookup, and processed-script output
TLK Load append.tlk, browse string references, and turn them into StrRefN tokens
2DA Register a target 2DA and add row, change row, copy row, or add column modifiers
GFF Register a target GFF-family file, edit field paths, and add nested field definitions
Install Define destination folders and list files to copy or replace
Script Register .nss sources for compile/install and optional destinations
SSF Map SSF sound slots to TLK or memory tokens

Typical First Workflow

  1. Open or create changes.ini.
  2. Fill out the Settings panel so the installer has the right caption and behavior.
  3. Add TLK tokens if other surfaces need dialog or sound text references.
  4. Register each target 2DA, GFF, SSF, script, or install folder in its top-level list.
  5. Create modifier sections from the dedicated dialogs.
  6. Save the file and review the generated INI sections.

When To Use namespaces.ini

Namespace setup lists are not part of the main changes.ini structure. Use the separate namespace editor when you need a namespaces.ini file that maps setup entries to alternate INI and RTF files for TSLPatcher packages.

Next Pages

Clone this wiki locally