My set of tools. The code is more important than the features, so feel free to reuse it. 🙂
This tool is using and providing different dependencies, see LICENSE.md for a full list.
You can download the latest release here:
- Latest Release
- Latest Dev Build (Might be unstable)
The tool checkupdate allows to check for the latest update.
Fast Files (ff) are compressed archives containing the different assets of the Call of Duty games.
The dumpers extract the fast files assets.
Supported games and assets
| Game | Reader | Handler | Pools |
|---|---|---|---|
| Black Ops 3 | ✅ | bo3 |
rawfile, scriptparsetree |
| Black Ops 4 | ✅ | bo4 |
aitype, arenaseasons, bgcache, character, characterbodytype, cpu_occlusion_data, customization, ddl, entitlement, entitlementlist, firstpartyentitlement, firstpartyentitlementlist, gametypetable, hierarchical_task_network, keyvaluepairs, localize_entry, luafile, comworld, entity_list, gfxworld, maptable, maptable_list, maptable_preview_images, trigger_list, objective, player_outfit, player_role_category, player_role_category_table, player_role_template, playlists, playlist_global_settings, playlist_schedule, rank, ranktable, prestige, prestigetable, rawstring, scriptbundle, scriptbundlelist, scriptparsetree, scriptparsetreedbg, sound, sprayorgestureitem, sprayorgesturelist, storagefile, storagefilelist, storeproduct, storecategory, storecategorylist, labelstore, labelstorelist, sku, streamkey, stringtable, structured_table, unlockable_item, unlockable_item_table, weapon, weapon_camo, weapon_tunables, zbarrier |
| 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, soundbanktransient |
| 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, soundbanktransient |
- 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.
See the wiki page Fast Files Dumper.
The linkers create custom fast files.
Supported games and assets
| Game | Linker | Pools |
|---|---|---|
| Black Ops 4 | bo4 |
aitype, character, rawfile, scriptparsetree, scriptparsetreedbg, scriptparsetreeforced, structuredtable, luafile, rawstring, scriptbundle, stringtable, image, keyvaluepairs, objective, rank, ranktable, prestige, prestigetable, localize, ttf, bgcache, zbarrier |
| Black Ops Cold War | cw |
rawfile |
See the wiki page Fast Files Linker.
The GSC file format contains the scripts used by the different games.
Supported games
| Name | Rev | Decompiler | Compiler | Type(s) | Source* |
|---|---|---|---|---|---|
| Black Ops 3 (T7) | 1A | ✅ | ✅ | pc | None |
| Black Ops 3 (T7) | 1B | Partial | ✅ | pc | ate47/oldcod-source |
| Black Ops 3 (T7) | 1C | ✅ | ✅ | pc,ps4 | ate47/bo3-source |
| Black Ops 4 (T8) | 31 | ✅ | ✅ | ps4 | ate47/oldcod-source |
| Black Ops 4 (T8) | 34 | ✅ | ✅ | pc,ps4 | ate47/oldcod-source |
| Black Ops 4 (T8) | 35 | Partial | ❌ | pc | None |
| Black Ops 4 (T8) | 36 | ✅ | ✅ | pc,ps4 | ate47/bo4-source |
| Black Ops Cold War (T9) | 37 | Dc | ✅ | pc,ps4,alpha | ate47/oldcod-source |
| Black Ops Cold War (T9) | 38 | Dc | ✅ | pc,ps4 | ate47/bocw-source |
| Modern Warfare III (JUP) | 8A | ✅ | ✅ | all | ate47/mwiii-source |
| Modern Warfare III (JUP) | 8B | Dc | ✅ | all | ate47/mwiii-source |
| Black Ops 6 (T10) | 06 | Dc | ✅ | all | ate47/bo6-source |
| Black Ops 6 (T10) | 07 | Dc | ✅ | all | ate47/bo6-source |
| Black Ops 6 (T10) | 0B | Dc | ✅ | all | ate47/bo6-source |
| Black Ops 6 (T10) | 0C | Dc | ✅ | all | ate47/bo6-source |
| Black Ops 6 (T10) | 0D | Dc | ✅ | all | ate47/bo6-source |
| Black Ops 6 (T10) | 0E | Dc | ✅ | all | ate47/bo6-source |
| Black Ops 6 (T10) | 10 | Dc | ✅ | all | ate47/bo6-source |
| Black Ops 6 (T10) | 11 | Dc | ✅ | all | ate47/bo6-source |
| Black Ops 6 (T10) | 12 | Dc | ✅ | all | ate47/bo6-source |
| Black Ops 6 (T10) | 14 | Dc | ✅ | bo6+bo6_v1 | ate47/bo6-source |
| Black Ops 7 (SAT) | 14 | Dc | ✅ | bo7 | ate47/bo7-source |
| Black Ops 7 (SAT) | 16 | Dc | ✅ | all | ate47/bo7-source |
| Black Ops 7 (SAT) | 18 | Dc | ✅ | all | ate47/bo7-source |
| Black Ops 7 (SAT) | 19 | Dc | ✅ | all | ate47/bo7-source |
- * : Some source repositories might not be public yet.
- Dc: With pre-decode, see the Using encrypted page.
- Ex: With extensions, The extensions aren't provided publicly, at least not by me.
See the wiki pages GSC Compiler or GSC Decompiler for more information.
Different dlls were created to add features to existing games
File: acts-bo3.dll
Features:
- Allow loading of script debug information in the zone directory, can be generated by the decompiler or downloaded here.
This dll is made as a plugin for project-bo4/shield-development, it doesn't work as an independant addon.
File: acts-shield-plugin.dll
Features:
- Translate error messages
- Add custom GSC functions
- Allow loading GSC detours and lazy links
- Add custom LUA functions
- Allow loading custom fastfiles
File: acts-bocw.dll
Features:
- Allow loading GSC lazy links
See the Wiki to know how to use the other features
