Skip to content

widberg/FUELDecompilation

Repository files navigation

FUEL Decompilation

GitHub Workflow Status Join the chat at https://discord.gg/CQgMNbYeUR

This is a decompilation of the game FUEL (PC, US Retail), which was released in 2009 by Asobo Studio and published by Codemasters. The game was developed using the Zouna Game Engine, which is a proprietary engine with a long and storied history. Neither the game executable nor its assets are included in this repository. A legally obtained copy of the game is required to build and run the decompiled code. A lot of the theory and techniques used in this project are outlined in the Decompilation page of the FMTK Wiki.

Getting Started

Prerequisites

Required

Optional

Checkout

git clone https://github.com/widberg/FUELDecompilation.git

Ghidra Project

A Ghidra server with the FUEL project is available at cs.widberg.me:13100 with anonymous read-only access enabled. If you would like an account with write access, please ask in the Discord.

Build

All commands should be run from the Visual Studio 2005 Command Prompt, which can be launched by running msvc8.0/bin/vcvars32.bat from cmd.exe. The CMake project can be configured with several key options:

  • FUEL_INSTALL_DIR - The path to the FUEL installation directory. Defaults to the environment variable of the same name.
  • DXSDK_DIR - The path to the Microsoft DirectX SDK (August 2008) installation directory. Defaults to the environment variable of the same name.
  • X64DBG_INSTALL_DIR - The path to the x64dbg installation directory (Optional). Defaults to the environment variable of the same name.
  • FUEL_ARGS - The command line arguments to pass to the game when running it from the run and debug targets. Defaults to -W.

See the CMakeLists.txt file for more options.

An example configuration and build is shown below:

cmake -B build -G Ninja -DFUEL_INSTALL_DIR="C:\Program Files (x86)\Steam\steamapps\common\FUEL" -DDXSDK_DIR="C:\Program Files (x86)\Microsoft DirectX SDK (August 2008)"
cmake --build build

The run target will launch the built recompilation from the game directory with the options in FUEL_ARGS:

cmake --build build --target run

If X64DBG_INSTALL_DIR is defined, the debug target will launch the built recompilation from the game directory with the options in FUEL_ARGS and attach x32dbg:

cmake --build build --target debug

Acknowledgements

  • boricj and his amazing ghidra-delinker-extension without which the black magic surrounding libfuel.obj would not have been possible. He also provided insightful input on the design of coffdrop, speeding the build up immensely.

About

A decompilation project for the video game FUEL (2009) by Asobo Studio

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors