Fast Files Dumper

acts contains a fast file dumper, on the supported games, it allows extracting different kind of assets.

Supported games and assets

Game	Reader	Handler	Pools
Black Ops 3	✅	bo3	rawfile, scriptparsetree
Black Ops 4	✅	bo4	rawfile, rawfile, scriptparsetree, scriptparsetreedbg, bgcache, keyvaluepairs, luafile, rawstring, scriptbundle, scriptparsetreeforced, streamkey, stringtable, weapon, weapon_tunables, localize, structuredtable, localizeentry
Modern Warfare 2019	✅	mw19	rawfile, scriptfile (gpl*), luafile, localize
Black Ops Cold War	✅	cw	rawfile, scriptparsetree, scriptbundle, bgcache, ddl, localizeentry
Vanguard	✅	vg	rawfile, scriptfile (gpl*), luafile, localize
Modern Warfare II	✅	mwii	rawfile, scriptfile (gpl*), luafile, stringtable, ddl, scriptbundle, localize
Modern Warfare II SP	✅	mwiisp	rawfile, scriptfile (gpl*), luafile, stringtable, ddl, scriptbundle, localize
Modern Warfare III	✅	mwiii	rawfile, gscobj, luafile, stringtable, ddl, scriptbundle, localize
Modern Warfare III SP	✅	mwiiisp	rawfile, gscobj, luafile, stringtable, ddl, scriptbundle, localize
Black Ops 6	✅	bo6	rawfile, gscobj, gscgdb, luafile, aitype, scriptbundle, stringtable, keyvaluepairs, netconststrings, operator, operatorlist, reactiveoperator, operatorskin, spray, contraildata, parachutedata, ddl, aishootstyleslist, ai_token_types, ai_token_stealing_definitions, ai_token_definitions, localize, soundbank, banktransient
Black Ops 6 SP	✅	bo6sp	rawfile, gscobj, gscgdb, stringtable, ddl, scriptbundle, netconststrings, luafile, aitype, localize
Black Ops 7	✅	bo7	rawfile, gscobj, gscgdb, luafile, aitype, scriptbundle, stringtable, keyvaluepairs, netconststrings, operator, operatorlist, reactiveoperator, operatorskin, spray, contraildata, parachutedata, ddl, aishootstyleslist, ai_token_types, ai_token_stealing_definitions, ai_token_definitions, localize, soundbank, banktransient

• gpl*: Only working within the GPL-3 distribution using xensik/gsc-tool.

The gsc handler can read scriptparsetree, gscobj or scriptfile pools from decompressed fastfiles.

Usage

The tool has the name fastfile. The syntax is

acts fastfile -r <handler> <path/to/file.ff>

• <handler> is the handler to use to read the data
• <path/to/file.ff> is the fastfile location

The option -R prints the handlers list

acts fastfile -R

For example, to dump all the GSC script from the fastfile zm_zod_patch.ff of a Black Ops 3 install, the command is:

acts -d fastfile -r gsc "O:\SteamLibrary\steamapps\common\Call of Duty Black Ops III\zone\zm_zod_patch.ff"

Oodle formats

Some games after bo3 are using the Oodle compression, acts will need you to copy inside your acts the oo2core_X_win64.dll file of your Call of Duty install (X the version) into the bin/deps directory of acts.

Patch files

Patch (.fd or .fp) files might be available with the fast file. To use get the latest version of the fastfile data, the patch should be loaded using the -p option.

Game dumpers

To use game dependant dumpers, you might need a dump of your exe. To create one you can use the game_dump tool with the path of the game. For example with Black Ops 3

acts game_dump bo3 "O:\SteamLibrary\steamapps\common\Call of Duty Black Ops III\"

Then the game dumper can be used. For example, to dump the assets using the Black Ops 3 dump tool, the command is

acts fastfile -r bo3 "O:\SteamLibrary\steamapps\common\Call of Duty Black Ops III\zone\"

(some assets might not be available to dump)