Skip to content
 
 

Repository files navigation

CAFFeinated

CAFFeinated (initially started as MumboGarage) is a C++ tool made to read the various file formats used by Rare during the Xbox/Xbox 360 era via R1.

Features

Currently supports the parsing and exporting from the following games:

Game Extent
Grabbed by the Ghoulies Supports the *.bnl files contained in bundles/ and the on-demand files in demand/, font/ & loctext/
Conker: Live & Reloaded Supports the aid/text/ and aid/texture/ *.bin files
Kameo: Elements of Power Supports the kameoStringsstripped.str file and *.mdl files, along with the bundle files used in the .lvl files
Perfect Dark Zero Supports the various *.pkg files in PackageData/ and the various *.str files in the aid/strings/ subfolders
Viva Pinata Supports the *.bnl files contained in bundles/ as well as some support for the debug package in debug/
Viva Pinata: Trouble in Paradise Supports the *.bnl files contained in bundles/
Banjo-Kazooie: Nuts & Bolts Supports the uncompressed bundle files in Bundle/4f/, streamed bundles in Bundle/50/ and loctext files in Debug/11/ & loctext/

Usage

This tool does somewhat expect that you have a basic understanding of the files you are looking at beforehand.
To open a file with the executable, go File -> Open, there will be a list of available options to pick from.

File Option Description
R1 Bundle File This is the most common format found, defined by its magic of "CAFF".
The currently supported versions are V0026, V0031 and V0036.
Ghoulies Files These are exclusively for Grabbed by the Ghoulies.
Two options are present, the bundle format and on-demand format.
Viva Pinata DB Files These are found in the files for Viva Pinata.
It relates to the three files found in \Beta\debug\ for VP and \Beta\packed\ for TiP.
Rare Package File These are used in Rare Replay with the extension .rpk / .rpk.gz

A few tool windows are present in this, for different purposes.

Tools Option Description
Loctext Editor A viewer for the localisation text banks (often abbreviated to just loctext) used in various R1 titles.
Currently limited to LSBL/LBSL
Script Editor A viewer for the script format, which handles the setup of a scene in the games based on the Ghoulies codebase.
Marker Editor A viewer for the marker format, which handles more specific object placement of a scene in the games based on the Ghoulies codebase.
Save Editor (Nuts & Bolts only) An editor for the save files created by Banjo-Kazooie: Nuts & Bolts.
Vehicle Editor (Nuts & Bolts only) A (fairly extensive) editor for the vehicle files used by Banjo-Kazooie: Nuts & Bolts.

Known Issues

  • Some crashes may appear when using the tool, as the tool is still a big Work in Progress.
    • Please feel free to report any issues (whether it's just any jank or outright crashes) with the tool on the issues page.
  • The tool does not currently support decompressing files compressed via xbcompress, nor does it currently support the DB files from TiP.

Contact

If you need to contact me regarding anything, you can contact me via Discord (@oliegamertv, I'm most active there) or the Issues tab.

Disclaimer

This tool is intended for educational and research purposes only. Use at your own discretion.
Distribution or usage of ripped/modified game files may violate Microsoft's Terms of Service.

Libraries Used

  • GLAD & GLFW
  • Dear ImGui
  • Native File Dialog Extended
  • Squish
  • stb_image & stb_image_write
  • zlib

About

A C++ tool built to read the various file formats used by Rare during the Xbox/Xbox 360 era.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages