XTool 2020 (Plugins)

[Masquerade]

Plugin Update

Added STDIN/STDOUT support for Bink Video plugin (thanks to Gehrman for idea).

Thanks to 78372 for cls wrapper.

Usage has not changed, but its significantly faster.

[exorc]

Originally Posted by Masquerade

Bink Video

• XTool plugin adding support for Bink Video compression.
• This plugin uses Bink Pack library by ProFrager.
• Thanks to Razor12911 for the little help.

Advantages of using this plugin versus vanilla Bink Pack

• Multithreading support.
• No CRC check fail since XTool will patch the videos as they are unpacked.
• Incompatible Bink 2 videos (KB2n) are automatically ignored.

Special Notes

• For Bink 2 videos, you may need to make use of the --diff=* parameter as some patches between CRC imperfect videos to the original state can be larger than XTool's default threshold for patches.
• You may need to use a large chunk size to ensure all videos are processed. See example below.

Example Usage

• Extract the attached archive to the XTool folder and use -mbik or -mbk2 depending on your data set.

Test

• Test on the videos from Assassin's Creed 2 (27x Bink 1 videos).
  

  xtool precomp -mbik "AC2Videos\"
  XTool is created by Razor12911
  
  Streams: 13/13
  Time: 00:00:09 (00:00:01)
  Memory: 148 MB (148 MB)
  
  Results: 937 MB >> 928 MB

  xtool precomp -c128mb -mbik "AC2Videos\"
  XTool is created by Razor12911
  
  Streams: 26/26
  Time: 00:02:12 (00:00:04)
  Memory: 391 MB (391 MB)
  
  Results: 937 MB >> 776 MB

  xtool precomp -c256mb -mbik "AC2Videos\"
  XTool is created by Razor12911
  
  Streams: 27/27
  Time: 00:02:25 (00:00:06)
  Memory: 677 MB (677 MB)
  
  Results: 937 MB >> 725 MB

• Test on 05_DAM folder from Shadow Warrior 3 Defintive Edition (6x Bink 2 videos).
  

  xtool precomp -c256mb -mbk2 "SW3\Content\Movies\Cutscenes\05_DAM"
  XTool is created by Razor12911
  
  Streams: 6/6
  Time: 00:01:06 (00:00:03)
  Memory: 406 MB (406 MB)
  
  Results: 214 MB >> 187 MB

How to use with DiskSpan GUI?

[Masquerade]

NPK2 Archives

Archives ending in .NPK and have a magic no. of NPK2.

Encrypted using Cipherfinal AES_256_CBC which isn't natively supported by XTool.

Examples of games using this scheme:

• Tokyo Necro
• Demonbane
• Sonicomi

Usage

Place npk2.dll with XTool and use

-mnpk2:k###Key in Hexadecimal###+png+preflate -d2

Example for Tokyo Necro [Steam Version]

-mnpk2:k0xAAE616FB7DB7EE84ED424C474AADDAD69A8372799AD576629601EF9B8938E20F+png+preflate -d2

A file is generated during precomp stage called npk2.bin. This must be retained for decoding as well as npk2.dll. npk2.bin contains the initialisation vectors for re-encrypting the data.

By Razor12911

[dixen]

oo2core_9_win64.dll v2.9.8 & v2.9.9

[Razor12911]

Star Ocean: The Divine Force

Supported games
Star Ocean: The Divine Force (requires libzstd.dll)

Usage
Place sodf.dll near xtool.exe along with required libraries and use -msodf+zstd (game is encrypted), so use -d1 as well

Notes

The library is required both when encoding and decoding.
zstd version 1.5.0 seems to work best
using two instances of xtool without -d1 is faster because some encrypted blocks are large and can only fit in 1 or 2 threads which cannot fully utilise the cpu leading to slower decoding

[Razor12911]

Plugin update available

Changes

- improved header decoder in unity plugin
- added ue5 method in unreal plugin to handle ucas/utoc file format without the need of using database creator

Results

Ghostwire Tokyo\Snowfall\Content\Paks\pakchunk0-WinGDK.ucas

-mue5:k0xC26CC5659A24AE8635585C8687DCE552A205DBD72D C4AA0CBE187C60D88921E2+kraken -d1

Streams: 39249 / 39250
Time: 00:07:54 (CPU 00:46:14)

Size: 4.84 GB >> 11.1 GB

I don't know how it compares with Unreal Engine ucas Database maker but this is an alternative for the newer ucas format as the database maker doesn't support it but this plugin does.

[Razor12911]

PlayStation archive

Supported games
PlayStation games?

Usage
Place psarc.dll near xtool.exe along with required libraries and use -mpsarc

Notes

If you plan on capturing the zlib streams in some of the psarc from The Last of Us, it's advisable to use two instances of xtool because the kraken streams are chunked meaning using -d1 will result in the zlib/reflate part of the precompression receiving incomplete streams.

core.psarc

2,11 GB >> 5.16 GB >> 7.53 GB

[Razor12911]

Originally Posted by Razor12911

core.psarc

2,11 GB >> 5.16 GB >> 7.53 GB

Turns out I missed a few streams, R2 uploaded

core.psarc

2.12 GB >> 5.44 GB >> 7.82 GB

Source 2

Supported games
Half-Life: Alyx (requires liblz4.dll)

Usage
Place src2.ini near xtool.exe along with required libraries and use -msrc2

Notes

Sadly I didn't spend too much time on this game and there's really not a lot of lz4 streams and I just totally forgot to upload it after the disappointment.

[Masquerade]

TT Isle Of Man Ride on the Edge 3 [LZ4F]

• Extract the contents of the attached archive and use -mTTIoM3.
• TTIoM3.xtl can be discarded for decoding, but lz4.exe, xtool.ini and xdelta3_dll.dll must be present.

xtool precomp -mTTIoM3 -c128mb -t8 -df20p "WIN32\PKG\CHUNK_0"

XTool is created by Razor12911

Streams: 19100 / 19112
Time: 00:11:36 (CPU 00:03:19)

Size: 8.23 GB >> 13.4 GB

[kuyhaa]

Originally Posted by Masquerade

TT Isle Of Man Ride on the Edge 3 [LZ4F]

• Extract the contents of the attached archive and use -mTTIoM3.
• TTIoM3.xtl can be discarded for decoding, but lz4.exe, xtool.ini and xdelta3_dll.dll must be present.

xtool precomp -mTTIoM3 -c128mb -t8 -df20p "WIN32\PKG\CHUNK_0"

XTool is created by Razor12911

Streams: 19100 / 19112
Time: 00:11:36 (CPU 00:03:19)

Size: 8.23 GB >> 13.4 GB

not work, what's wrong ?

[KaktoR]

Pretty sure you have to use a lz4 library aswell.

[Masquerade]

Originally Posted by KaktoR

Pretty sure you have to use a lz4 library aswell.

LZ4 precompression is handled by lz4.exe in this case, plugged in via xtool.ini.

@kuyhaa
Are you trying an updated version? The database was created for the release version of the game.

[kuyhaa]

Originally Posted by Masquerade

@kuyhaa
Are you trying an updated version? The database was created for the release version of the game.

i'm using TT Isle Of Man Ride on the Edge 3 update v20230511

if use lz4f:l10

Streams: 5575 / 20181
Time: 00:00:32 (CPU 00:13:10)

Size: 8.23 GB >> 9.73 GB

[Masquerade]

In that case, you will need to make a new database.

You will need VGMToolbox, which you can download here.

Copy this text and save it as PPKG.XML inside the "plugins\AdvancedCutter" folder.

Open the tool and go to Misc Tools ---> Extraction Tools ---> Generic ---> Advanced Cutter / Offset Finder.

In the presets drop down box, select PPKG from the list and then click "Load".

Then, drag the three PKG files into the drag'n'drop box to the left of the preset box.

After all the streams have been extracted, rename the extracted folders to remove the _CUT suffix.

To generate the database, just open a command prompt window in the folder containing the pkg files and do:

for %f in (*.PKG) do xtool generate -c128mb -t100p -mlz4f "%~nf" "%f" TTIoM3.xtl

Now you can delete the folders from VGMToolbox.

[Masquerade]

Divinity: Original Sin [Enhanced Edition]

• Extract contents of attached archive and use -mDivinity -df20p.
• Divinity.xtl can be discarded for decoding, but liblz4.dll and xdelta3_dll.dll must be present.

Divinity: Original Sin 2 [Definitive Edition]

• Extract contents of attached archive and use -mDivinity2 -df20p.
• Divinity2.xtl can be discarded for decoding, but liblz4.dll and xdelta3_dll.dll must be present.