GSC Tool

A utility to compile & decompile IW engine game scripts.

Supported Games

IW5 (Call of Duty: Modern Warfare 3) PC PS3 Xbox 360
IW6 (Call of Duty: Ghosts) PC PS4 Xbox One
IW7 (Call of Duty: Infinite Warfare) PC PS4 Xbox One
IW8 (Call of Duty: Modern Warfare (2019) / Warzone) PC PS4 PS5 Xbox One Xbox Series X|S
S1 (Call of Duty: Advanced Warfare) PC PS4 Xbox One
S2 (Call of Duty: WWII) PC PS4 Xbox One
S4 (Call of Duty: Vanguard) PC PS4 PS5 Xbox One Xbox Series X|S
H1 (Call of Duty: Modern Warfare Remastered) PC PS4 Xbox One
H2 (Call of Duty: Modern Warfare 2 Campaign Remastered) PC PS4 PS5 Xbox One Xbox Series X|S
T6 (Call of Duty: Black Ops II) PC
T7 (Call of Duty: Black Ops III) *WIP*
T8 (Call of Duty: Black Ops 4) *WIP*
T9 (Call of Duty: Black Ops Cold War) *WIP*

Usage

./gsc-tool.exe <mode> <game> <path>

modes: asm, disasm, comp, decomp

games: iw5c, iw5, iw6, iw7, iw8, s1, s2, s4, h1, h2, t6

paths: file, directory (recursive process all files inside dir)

for zonetool files (.cgsc, .cgsc.stack) use: zasm, zdisasm, zcomp, zdecomp modes

Example: ./gsc-tool.exe comp iw5 ./data/iw5/my_fancy_script.gsc

Mode	Description	Output
`asm`	assemble a `file.gscasm`	`file.gscbin`
`disasm`	dissasemble a `file.gscbin`	`file.gscasm`
`comp`	compile a `file.gsc`	`file.gscbin`
`decomp`	decompile a `file.gscbin`	`file.gsc`

File Format

If you need to extract scripts from fastfiles or game memory, use Zonetool or Jekyll.

gsc-tool .gscbin format is a serialized ScriptFile struct:
name: null-terminated string
compressedLen: 4 byte uint
len: 4 byte uint
bytecodeLen: 4 byte uint
buffer: byte array[compressedLen]
bytecode: byte array[bytecodeLen]
zonetool (IW5) format made of bytecode file .cgsc and decompressed stack buffer .cgsc.stack.
treyarch (T6) format is a single buffer with gscobj data .gsc or .csc.

Credits

This project is based on RektInator's gsc-asm. Special thanks to RektInator, JTAG & Dasfonia.

Disclaimer

This software has been created purely for the purposes of academic research. Project maintainers are not responsible or liable for misuse of the software. Use responsibly.

3.1 KiB Raw Blame History