Toolkit Changelist
Released 27th October 2021
This update introduces a new way for users to check what a new update includes:
Pressing 'OK' will link you to this page (then start the Toolkit), and pressing 'Cancel' will continue with usual Toolkit functionality. This is only presented once per update. The reason for this introduction is because some changes are easier to present with videos or screenshots, and to showcase new features which previously have gone unnoticed.
The Toolkit has had a problematic time when packing SDS with compression enabled. In 2.22, we now have the ability to calculate the 'compression ratio' during a repack. If the ratio is greater than a given number (between 0.0 and 1.0) it is compressed and stored. If it fails to be greater than the user-set value, it's not compressed. This seems to improve the SDS Packing for all games. Users can change the 'compression ratio' by going into Settings -> SDS -> Compression Ratio. It has replaced the old 'Uncompressed' or 'Compressed' drop down box. The default value is 0.9.
The 'XBin Editor' for Mafia III and Mafia: DE has been optimised for hashing Wwise and FNV64/FNV32 algorithms. As well as cleaning up hashing storage, a number of XBin files have been improved or added for both games:
- car_tuning_pack_availability_game_group.xbin
- car_traffic_tuning_game_group.xbin
- vehicles_game_group.xbin
- subtitles_en_group.xbin
For the Vehicles XBin, it now respects the type of game you have loaded. As you can see, the flags now have the ability to use game-specific values, rather than being hardcoded to Mafia III values. This should make editing Mafia I: DE vehicles much easier. See the 'CommonFlags' property as an example. If you are interested what values are available, submit an issue on GitHub and I will document them.
We now have search functionality for the Map Editor! Finally! It works for all data present in the 'Explorer' tab, and also allows the user to navigate to the item in the 'Explorer' tab from the 'Search' tab. This can be achieved by double clicking on the node in the 'Search' tab, or pressing 'Enter' on the searched node. Furthermore, when inputting what to search for you can use the 'Enter' key to instantly search for the item rather than needing to press the search button. Further changes are being considered, such as filtering what types of items you are looking for.
This new editor allows you to edit all of the Wwise sound files (.PCK & .BNK) found in the Mafia 3 and Mafia: Definitive Edition games, thus allowing you to replace, delete and import sound files, edit their properties and create completely new and custom audio for the games. You can check out the Wwise documentation here.
The Toolkit no longer requires the user to manually move the DLL named 'oo2core_8_win64.dll'. From update 2.22, the Toolkit will automatically try and use the DLL from the games root folder.
Improved FrameResource code, rewritten 'FrameObjectLight' and also fixed a bug when trying to duplicate an object of this type. It should be easier to try and understand the properties of this object.
With Toolkit version 2.20, we lost the exception window on release builds. This caused problems with users not knowing if a bug or crash was hit. I've added a custom Toolkit exception window to catch these, and prompt the user if an error occurs. Please feel free to send crashes into the Toolkit discord. We're always happy to try and fix any exceptions or crashes.
- Fixed a bug where 'boolean' values in the Table Editor will be incorrect stored in a file, resulting in a broken file upon saving.
- Fixed a bug when using the option 'Decompile Lua files automatically.' The Toolkit will now take into account whether the file is already non-bytecode, and no longer crash the Toolkit.
- Fixed a bug where lights stored in the Actor file will no longer crash and output a broken file if 'SceneLinks', 'FrameLinks' and 'FrameIDXLinks' are edited.
- Fixed a critical problem where Mafia III and Mafia: DE SDS files were not being unpacked with the filenames applied. This should have been improved and fixed for this update.