atian-cod-tools
Health Pass
- License — License: NOASSERTION
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 153 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Random things
Atian Tools
My set of tools. The code is more important than the features, so feel free to reuse it. 🙂

Dependencies
This tool is using and providing different dependencies, see LICENSE.md for a full list.
Downloads
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
Fast Files (ff) are compressed archives containing the different assets of the Call of Duty games.
Fast Files Dumpers
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, using, scriptbundle, bgcache, ddl, localizeentry, keyvaluepairs, weapon_frontend, zbarrier |
| 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.
Fast Files Linkers
The linkers create custom fast files.
Supported games and assets
| Game | Linker | Pools |
|---|---|---|
| Black Ops 3 | bo3 |
scriptparsetree |
| 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, scriptparsetree, scriptparsetreedbg, using, bgcache, localize, keyvaluepairs |
See the wiki page Fast Files Linker.
Game Script Code (GSC)
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 |
| Black Ops 7 (SAT) | 1a | Dc | ✅ | bo7+mw4 | ate47/bo7-source |
- * : Some source repositories might not be public yet.
- ** : Some GSC vms aren't using the same opcodes
- 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.
Hash Utilities
Various games use hashes, the lookup is done using the loaded hashes.
It is suggested to run acts download_hash_index after installation to get all the default hashes.
To add more hashes, it can be done manually:
- Using a file named
strings.txtwith one hash per line - Using
.wni/.cdbfiles inbin/package_index - By downloading a .zip file containing wni or cdb files with the
acts download_hash_index [url]command.
Or they can be downloaded from multiple sources
- Using the ate47/HashIndex with the command
acts download_hash_index acts - Using the echo000/cod-name-db with the command
acts download_hash_index echo000-cndb
Multiple utilities for brute forcing hashes, replace hashes in files, scan for them or compress are available. A list can be obtained using acts list hash.
MCP Server
The Model Context Protocol (MCP) is a protocol to give access to resources to AI. A MCP server is available within the CLI or inside the UI.
It can be started within the cli using the acts http_server tool or via the Utilities/MCP Server UI tool.
Existing MCP tools
- common: process dump, hash utilities.
- gsc: decompile gsc scripts, control opcodes or search.
Game DLLs
Different dlls were created to add features to existing games
Black Ops 3
File: acts-bo3.dll
Features:
- Allow loading of script debug information in the zone directory, can be generated by the decompiler or downloaded here.
Project Black Ops 4 Plugin
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
Black Ops Cold War
File: acts-bocw.dll
Features:
- Allow loading GSC lazy links
Developers
This project is open for more features, see CONTRIBUTING.md for more information.
Setup
External tools
cmakeis required to setup the project.clang-formatis required to format the project, a formatted code is mandatory for pull requests.antlr4is required to recompile the grammar files used by the different compilers. It can be downloaded usingscripts/antlr.ps1.
Packaging
Building the solution automatically creates build/package/acts.zip andbuild/package/acts-dev.zip. Build the Release configuration for release archives. To include
Qt deployment files, configure with -DACTS_PACKAGE_DEPLOY_QT=ON.
Path structure
/cmake: cmake scripts/config: config files, used by tools/config/data: config files packages with acts/deps: external projects/examples: acts API examples/grammar: grammar files used by antlr4/include: includes for the acts API/licenses: used licenses/scripts: scripts used by the ci or developers/src: source directory/tools: source directory for the tools used to compile the files into the source directory
Plugins and API
Atian Tools supports plugins, see ate47/atian-cod-tools-plugin-example for an example, the api can be obtained in the release zip or in the include/.
API examples are available in examples/.
GitHub Actions
To use the acts command in a GitHub workflow, the ate47/setup-acts action can be used.
- name: Install Atian Tools
uses: ate47/setup-acts@v1
with:
# Atian Tools version to install, latest for the latest version, latest_build
# for the latest prerelease build.
# Default: latest
version: latest
# Download the hash index with Atian Tools
# Default: false
hashindex: false
Wiki
See the Wiki to know how to use the other features
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found