-
Notifications
You must be signed in to change notification settings - Fork 3
HoloPatcher README for mod developers.
This page explains how to create a mod with HoloPatcher. If you are an end user you may be looking for How to Use HoloPatcher
HoloPatcher is a rewrite of TSLPatcher written in Python, utilizing the PyKotor library. Everything is backwards compatible with TSLPatcher. For this reason I suggest you first read TSLPatcher's readme, really.
- This is not recommended under most scenarios. You usually want to append a new entry and update your DLGs to point to it using StrRef in the ini. However for projects like the k1cp and mods that fix grammatical/spelling mistakes, this may be useful.
The basic syntax is:
[TLKList]
ReplaceFile0=tlk_modifications_file.tlk
[tlk_modifications_file.tlk]
StrRef0=2
This will replace StrRef0 in dialog.tlk with StrRef2 from tlk_modifications_file.tlk
.
See our tests for more examples. Don't use the 'ignore' syntax or the 'range' syntax, these won't be documented or supported until further notice.
This is a TSLPatcher feature that was not documented in the TSLPatcher readme.. We can only guess why this is. The only known uses we know about are Stoffe's HLFP mod and some starwarsknights/lucasforums archives on waybackmachine pointing to files that are unavailable.
Due to this feature being highly undocumented and only one known usage, our implementation might not match exactly. If you happen to find an old TSLPatcher mod that produces different HACKList results than HoloPatcher, please report them here
In continuation, HoloPatcher's [HACKList] will use the following syntax:
[HACKList]
File0=script_to_modify.NCS
[script_to_modify.ncs]
20=StrRef5
40=2DAMEMORY10
60=65535
This will:
- Modify offset dec 20 (hex 0x14) of
script_to_modify.ncs
and overwrite that offset with the value of StrRef5. - Modify offset dec 40 (hex 0x28) of
script_to_modify.ncs
and overwrite that offset with the value of 2DAMEMORY10. - Modify offset dec 60 (hex 0x3C) of
script_to_modify.ncs
and overwrite that offset with the value of dec 65535 (hex 0xFFFF) i.e. the maximum possible value. In summary, HACKList writes unsigned WORDs (sized at two bytes) to offsets in the NCS specified by the ini.