A fork of https://github.com/xensik/gsc-tool - A utility to compile & decompile IW engine game scripts.

Go to file

dependabot[bot] de2c7fd529 Bump deps/zlib from `21767c6` to `04f42ce` (#35 ) Bumps [deps/zlib](https://github.com/madler/zlib) from `21767c6` to `04f42ce`. - [Release notes](https://github.com/madler/zlib/releases) - [Commits](`21767c654d...04f42ceca4`) --- updated-dependencies: - dependency-name: deps/zlib dependency-type: direct:production ... Signed-off-by: dependabot[bot] <support@github.com> Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>		2022-11-01 21:45:31 +01:00
.github	Create dependabot.yml	2022-05-24 16:40:24 +02:00
data	move data	2021-09-17 16:46:55 +02:00
deps	Bump deps/zlib from `21767c6` to `04f42ce` (#35 )	2022-11-01 21:45:31 +01:00
docs	iw8 build	2021-09-13 20:00:43 +02:00
gen	add missing flags & keywords	2022-10-21 20:49:27 +02:00
src	add s1 built-ins and tokens (#37 )	2022-11-01 21:37:18 +01:00
tools	refactor	2021-12-26 13:21:19 +01:00
.gitignore	fix bugs for PS3 & Xbox 360 games	2022-09-30 19:40:20 +02:00
.gitmodules	init	2021-05-08 18:15:25 +02:00
appveyor.yml	update build	2022-03-21 16:39:04 +01:00
LICENSE	init	2021-05-08 18:15:25 +02:00
prebuild-macos.sh	init	2021-05-08 18:15:25 +02:00
prebuild-windows.bat	update build	2022-03-21 16:39:04 +01:00
premake5.lua	console support for iw6 & s1 (need fixes)	2022-09-22 12:57:11 +02:00
README.md	update readme	2022-09-20 17:05:59 +02:00

README.md

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 PS3 PS4 Xbox 360 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 PS3 PS4 Xbox 360 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

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

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

note: PS3 & Xbox 360 use iw5c, iw6c, s1c games

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

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]

note: for PS3 & Xbox 360 .gscbin files (compressedLen, len, bytecodeLen) are saved as little-endian!!

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.

Contribute

If you like my work, feel free to contribute! Would allow me to spend more time adding new features & fixing bugs.

BTC: bc1qky7x9kpjlt6nsvt7pckc3wwzk8rk9pgtnmw98u
ETH: 0x6261BBE1a33F6Fec4b722DbCe2c28B4CC02c9C7B

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.