HoloPatcher

HoloPatcher

HoloPatcher is the cross-platform replacement for the Windows-only TSLPatcher installer, developed as part of PyKotor. It reads the standard tslpatchdata layout and applies merge-aware patching for GFF, 2DA, TLK, SSF, and NCS on Windows, macOS, and Linux.

Use this page as the entry point for HoloPatcher documentation. Detailed usage, authoring guidance, and implementation notes now live on dedicated pages so they can be maintained without duplication.

Contents

• HoloPatcher
  • Contents
  • For mod users
  • For mod developers
  • Internal architecture
  • Related syntax references
  • Community adoption
    • See also

For mod users

If you are installing a mod, start with Installing Mods with HoloPatcher. That page covers the player workflow: choosing the correct game root, handling namespace options, restoring backups before retries, and using the iOS case-sensitivity utility when mobile installs need it.

Use HoloPatcher against the game root, not the override folder by itself. If a mod offers multiple install options, restore the previous backup before switching variants or reinstalling the same option. For general conflict background, also see Concepts and Mod Creation Best Practices.

For mod developers

If you are packaging a mod, use HoloPatcher README for Mod Developers. That page covers the author workflow for changes.ini, namespaces.ini, test-install discipline, merge-oriented TLK, 2DA, and InstallList usage, plus HoloPatcher-specific notes such as current HACKList behavior and documented TLK replacement support.

Start there if you are building a first mod package, comparing HoloPatcher with classic TSLPatcher behavior, or deciding where KotORModSync fits into a larger mod distribution workflow.

Internal architecture

If you need implementation detail rather than end-user instructions, use Explanations on HoloPatcher Internal Logic. That page breaks the tool into its major layers:

• the UI and CLI entry points in Tools/HoloPatcher/src/holopatcher/ [app.py · cli.py]
• the config reader that parses changes.ini [ConfigReader]
• the patcher that orders, applies, logs, and backs up each modification [ModInstaller]

It also documents the patch routine, patch-list priority, override handling, and backup semantics that matter when you are debugging edge cases or comparing output against legacy TSLPatcher behavior.

Related syntax references

HoloPatcher follows the broader TSLPatcher configuration model. Use these pages for exact list semantics:

• TSLPatcher InstallList Syntax
• TSLPatcher TLKList Syntax
• TSLPatcher 2DAList Syntax
• TSLPatcher GFFList Syntax
• TSLPatcher SSFList Syntax
• TSLPatcher HACKList Syntax
• TSLPatcher's Official Readme

Community adoption

HoloPatcher is used frequently in community releases, with release notes citing additional patching functionality, bug fixes, and cross-platform support as the reasons [KOTOR 1 Community Patch].

See also

• Concepts explains override order, capsules, and resource resolution.
• Home places HoloPatcher in the wider PyKotor toolchain.
• Mod Creation Best Practices covers compatibility and release hygiene.
• KotorDiff Integration is useful when you need to compare install outputs.