User Tools

Site Tools


joneirik:bs:modguide2

This is an old revision of the document!


Bloodstained v1.3 DataTable modding

Just basic how-to and which tools to use for what. I'm not really capable of writing detailed guides for each tool.

Versions

  • Bloodstained v1.21 UE4 engine version: 4.18
  • Bloodstained v1.30 UE4 engine version: 4.27

Basics

How to edit a single DataTable file:

  1. Unpack the pakchunk0-WindowsNoEditor.pak (QuickBMS)
  2. Extract DataTable uasset files (FModel)
  3. Copy the file you want to edit to a new folder (KEEP SUBFOLDER STRUCTURE!)
  4. View/Edit uasset files (UAssetGUI)
  5. Repack the entire folder/subfolder with the uasset (UnrealPak)

If you want to do larger edits on a file, or multie files, you can export/convert to JSON using UAssetGUI, and convert them back again using the same.

  • Recommended to make batch-files for converting to and from JSON/Uasset.
  • The JSON files are not readable directly, you'll need to use another tool to clean them up.
  • For those used to the old Serializer, the JSON setup is different, includes more data, and you'll have to re-learn them a good bit.

Tools

  • QuickBMS/ut4.bms
  • FModel
  • UAssetGUI
  • UnrealPak

QuickBMS/ut4.bms

This tool is used to unpack the main file containing the data:

BloodstainedRotN\Content\Paks\pakchunk0-WindowsNoEditor.pak
  • You will need the QuickBMS for 4gb or larger files.
  • You will need the file “sf5.bms” to make QuickBMS recognize the file and export.

The installs/versions I've found has included batch files, that lets you drag the pak-file directly on top, and it starts working. I've had to copy the pak file to the same folder to make it work.

It will take a while, as the pakchunk file is 13gb now. Still the fastest option.


FModel

Is a very good tool for browsing and looking through PAK files, including the main pakchunk. It also lets you view DataTables, extract or save as JSON. But won't let you edit anything. Bonus it has a dark mode.

  • Don't use this to extract the entire pakchunk if you can avoid it, it takes a lot of time! (8hours or so for Lakifume).
  • You can use this to extract single files easily, either as uasset or json.
  • At the moment, the only way I've found to extract data tables from pak files.
  • Counter intuitive GUI: You have to go through the different tabs to find the next order of files/folders/actual filed to view.
  • Set to UE4 version 4.27 in settings/general.

UAssetGUI

Used to open uasset files, and edit them directly through the GUI, or export/import to json. Do note that the exported json are very messy and need some other program to clean up to be able to use it. Negative: it does NOT have a dark mode.

  • Only way I've found to edit uasset directly
  • Only way I've found to import JSON back to UAsset
  • You can make batch-files for converting to and from JSON
  • Counter intuitive GUI: basically click all the bottom + signs to find the actual data.
  • Set to UE4 version 4.27 in upper right corner.

UnrealPak

Is the only unchanged tool from last version of the game. It's only used for packing the files back into a PAF-file again.

  • THE MOST IMPORTANT: The game expects to find uasset files in specific sub-folders. So you have to store them in proper sub-folders before pak-ing them up, or the game just doesn't find them!!! (Just check which subfolder they where in originally with FModel/UAssetGui, and replicate it).

Personally never bothered using the compressions, since DataTables are so small anyway.


END

joneirik/bs/modguide2.1651693292.txt.gz · Last modified: 2022/05/04 13:41 by joneirik