GitHub - Nenkai/GBFRDataTools: Tools/Libraries for dealing with Granblue Fantasy: Relink. (original) (raw)

Warning

No research will be made, or PRs to be accepted in regards to the Endless Ragnarok Closed Beta.

Work will resume some time after the release of the DLC.

Data Tool for Granblue Fantasy: Relink archives (data.i)

Features:

• Extraction
  • Extracting singular files (if you know their paths and their hash matches)
  • All known files
  • Unmapped files are put folders that have been guessed manually
• Modding
  • Adding files marked as external files (which means they can be outside data.X like files in the data folder)
• Conversion of viewb, listb, texb, prfb etc to or from yaml
  • Note that not all prfb files are supported. More details in research notes.
• Conversion of table files .tbl <-> .sqlite
  • Batch scripts included - drop tbl, sqlite, or folders onto the batch as long as the batch is in the same folder as GBFRDataTools.exe
• Texture conversion support
  • Conversion of wtb/tex into dds (drag-drop)
  • Conversion of png/dds into wtb
  • Conversion of a folder containing images to a generated texture atlas (.tex.texb + .wtb)
  • Conversion of .tex.yaml + folder to a rebuilt texture atlas (.tex.texb + .wtb)
• Conversion of bxm/xml (drag-drop)
• String Hasher
• Libraries
  • FSM & General Game Entity Reader (See: FSM and Entities)
  • FlatBuffer Schemas for various file formats (See: GBFRDataTools.FlatBuffers)
  • Save File handling (See: GBFRDataTools.SaveFile)

Release build here.

Research Notes

• Currently, 98.3% of all game paths are known (v1.3.2)
• It is possible to run the game fully unpacked by removing data.i, however all game files need to be extracted in a data folder - requires the majority of game paths mapped out which is not the case yet.
• data.i among other file formats such as models uses FlatBuffers (Cy's internal handler is named FlatArk). It is fully understood and documented in IndexFile.fbs.
• Data/Archive file #2 is hardcoded not to be read from. It is only used on console versions.
• All .xxxb files are UI declarations with names hashed. Many can be recovered from the internal reflection system (specifically <type>::createAttr::ObjectTypeBuilder::vftable uses), but not all properties are present. Basically every .prfb file will use an unique UI component that needs to be supported. Refer to these files.

Credits

• WistfulHopes - Research & File Paths
• AlphaSatanOmega, SheItoon - Path Finding
• Hazelberry - Batch scripts

Discord (EN)

Join the Relink Modding Discord For help, guidance & more!

You can also refer to the Relink Modding Site.