Skip to content

deadYokai/dishonored-toolkit

Repository files navigation

Forks Stargazers


Dishonored Mod Toolkit

I wrote tools to facilitate game modding

About The Project

At first I just wanted to replace the fonts, which I couldn't do because of manual work, which caused a lot of errors.

Therefore, to simplify, I made this project. And I replaced the fonts.

But there was another problem - subtitles. And to replace the subtitles, I had to expand this project.

Therefore, I am posting this project here in the hope that it will be useful to someone.

Used Libs

Usage

WARNING: Before working through these tools, you need to decompress a upk files. Unreal Package Decomressor

File Structure:

_DYextracted: ObjectName.ObjectId.ObjectType

_DYpatched: ObjectName.ObjectId.ObjectType_patched

_objects.txt: ObjectName.ObjectId.ObjectType; SizeOffset; ObjectSize; OffetOffset; ObjectOffset

  • ObjectName: name of object

  • ObjectType: type of object

  • ObjectId: id of object after unpacking

  • SizeOffset: offset to size value in header

  • ObjectSize: object size

  • OffetOffset: object offset written in header

  • ObjectOffset: offset to object in file

!IMPORTANT!: files in _objects.txt sorted by ObjectOffset

Unpack

python3 unpack.py -f <filter> upkfile
  • --split: extract upk to _DYextracted/<upkname>
  • -f or --filter: sets filter to filename (*<filter>*)

Example: python3 unpack.py -f Blurb ../L_Tower_Script.upk

Patch

Patches files from _DYpatched with suffix _patched.

Example: _DYpatched/ChaletComprime-CologneEighty_PageA.4.Texture2D_patched

python3 patch.py -p upkfile --split
  • -s or --split: use files from _DYpatched/<upkname>
  • -p or --patch-header: insert header file from _DYextracted

Example: python3 patch.py ../L_Tower_Script.upk

Textures

  • Unpack
    python3 texture2d.py <filename>
  • Pack
    python3 texture2d.py -p <filename> <ddsfile>

Fonts

IMPORTANT: font texture (Texture2D) must be in same directory as a .Font

See a wiki page

  • Extract
    python3 fontEdit -e <path to .Font>
  • Pack
    python3 fontEdit -p <path to .Font> <path to .ttf/.otf> [charset or file]
    charset - optional, if not specified it will use a charset from .Font file

Subtitles

  • Export to yaml (from INT language)

    python3 subedit.py <upkfile> --output out.yaml --langCode <LANG>
    • --langCode - Language to extract (default INT)
  • Import to UPK

    python3 subedit.py <upkfile> --input in.yaml --langCode <LANG> --langReplace <LANG>
    • --langCode - Language to replace (default INT)
    • --langReplace (optional) - Change language code to custom (3 chars) (don't work with INT)
  • Avaiable lang codes (from Dishonored):

    INT
    CHN
    CZE
    DEU
    ESM
    ESN
    FRA
    HUN
    ITA
    JPN
    KOR
    POL
    RUS
    SLO
    

    A new <upkfile>_patched upk will be created at same dir as <upkfile>

Acknowledgements

About

Some tools to work with Dishonored UPK's

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages