https://github.com/widberg/bff
A GUI/CLI utility to work with Zouna file formats.
https://github.com/widberg/bff
Last synced: about 1 year ago
JSON representation
A GUI/CLI utility to work with Zouna file formats.
- Host: GitHub
- URL: https://github.com/widberg/bff
- Owner: widberg
- License: mit
- Created: 2023-04-25T19:55:19.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-08-16T22:23:57.000Z (almost 2 years ago)
- Last Synced: 2024-08-16T23:32:48.111Z (almost 2 years ago)
- Language: Rust
- Homepage: https://bff.widberg.me/
- Size: 3.86 MB
- Stars: 6
- Watchers: 1
- Forks: 2
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-game-file-format-reversing - bff - BigFile Friend. Successor to `dpc`, supports Zouna file formats. (Game & Studio Tools / Asobo Studio)
README
# bff
BigFile Friend
[](https://github.com/widberg/bff/actions)
[](https://nightly.link/widberg/bff/workflows/build/master)
[](https://discord.gg/CQgMNbYeUR)
The Zouna Swiss Army knife. Originally named BigFile Friend for Zouna's resource archives, it now supports far more than just BigFiles.
This repository is a relative of the main [FMTK repository](https://github.com/widberg/fmtk).
## Support
A ✔ indicates that the format has been tested and is working. An ❌ indicates that the format is not yet implemented. A ⚠️ indicates partial/incomplete support.
### BigFile
| Year | Game | Status |
|------|---------------------------------------------------------------------------------------------|--------|
| 2002 | Jimmy Neutron: Boy Genius - BigSky | ✔ |
| | SpongeBob SquarePants: Revenge of the Flying Dutchman - BigSky | ✔ |
| | Spirits & Spells (Castleween) (Mahou no Pumpkin) - Wanadoo | ✔ |
| 2003 | Super Farm - Asobo | ✔ |
| 2004 | Sitting Ducks - Asobo | ✔ |
| | The Mummy: The Animated Series - Asobo | ✔ |
| 2005 | CT Special Forces: Fire for Effect (Nemesis Strike) - Asobo | ✔ |
| | Ratatouille (Prototype) - Asobo | ✔ |
| 2006 | Garfield: A Tail of Two Kitties (Garfield 2) - Asobo | ✔ |
| | Championsheep Rally - Black Sheep | ✔ |
| 2007 | Ratatouille - Asobo | ✔ |
| | The Ugly Duckling and Me - Black Sheep | ✔ |
| | En Taxi avec Oui-Oui - Black Sheep | ✔ |
| 2008 | WALL-E - Asobo | ✔ |
| | The Magic Roundabout - Black Sheep | ✔ |
| | Shaun White Snowboarding/Shaun White Snowboarding: Road Trip (Prototype) - Ubisoft Montreal | ✔ |
| | Shaun White Snowboarding/Shaun White Snowboarding: Road Trip - Ubisoft Montreal | ✔ |
| | Warning: Code De La Route - Black Sheep | ✔ |
| 2009 | FUEL - Asobo | ✔ |
| | Up - Asobo | ✔ |
| | Shaun White Snowboarding: World Stage - Ubisoft Montreal | ✔ |
| 2010 | Toy Story 3 - Asobo | ✔ |
| | Racket Sports/Racquet Sports/Racket Sports Party - Asobo | ✔ |
| | Happy Neuron Academy - Black Sheep | ✔ |
| 2012 | Kinect Rush: A Disney-Pixar Adventure - Asobo | ✔ |
| 2013 | Super Farm (Re-release) - Asobo | ✔ |
| 2014 | Monopoly Plus/Monopoly Deal - Asobo | ✔ |
| 2015 | The Mighty Quest for Epic Loot - Ubisoft Montreal | ✔ |
| 2016 | Young Conker - Asobo | ✔ |
| | Fragments - Asobo | ✔ |
| 2017 | Rush: A Disney-Pixar Adventure (Re-release) - Asobo | ✔ |
| | Monopoly Plus/Monopoly Deal/Monopoly for Nintendo Switch (Re-release) - Asobo | ✔ |
| 2019 | A Plague Tale: Innocence - Asobo | ⚠️ |
| 2020 | Microsoft Flight Simulator - Asobo | ⚠️ |
| 2022 | A Plague Tale: Requiem - Asobo | ⚠️ |
| 2024 | Microsoft Flight Simulator 2024 - Asobo | ❌ |
### TSC
| Format | Status |
|--------|--------|
| csc | ✔ |
| psc | ✔ |
| CPS | ✔ |
These formats from Black Sheep Studios games also use the csc cypher and therefore work with the csc command. They aren't actually TSCs, but they are text based configuration formats, so I'll include them here.
| Format | Status |
|--------|--------|
| cmf | ✔ |
| cgf | ✔ |
| cst | ✔ |
### Audio
These formats are low priority since they can all be played using the instructions on the [FMTK Wiki Asobo Audio Formats page](https://github.com/widberg/fmtk/wiki/Asobo-Audio-Formats). The implementation of these formats is being tracked in [issue #27](https://github.com/widberg/bff/issues/27).
| Format | Status |
|---------|--------|
| SoundBF | ❌ |
| AIF | ❌ |
| JOE | ❌ |
| VAI | ❌ |
### Archive
| Format | Status |
|---------|--------|
| FAT+LIN | ✔ |
## Patterns
The [ImZouna](https://github.com/widberg/ImZouna) and [zouna-templates-docs](https://github.com/SabeMP/zouna-templates-docs) repositories have binary patterns for Zouna data structures.
## Getting Started
### Prerequisites
* [Rust](https://www.rust-lang.org/)
### Checkout
```sh
git clone https://github.com/widberg/bff.git
cd bff
```
### Build
```sh
cargo build --release
```
### Test
```sh
RUST_TEST_THREADS=1 cargo +nightly test --release -j 1
```