FMTK

FUEL Modding Toolkit

Features

Fully compatible with “FUEL: REFUELED”, “FUEL: RESHADED”, and other legacy mods by default
Lua scripting engine
C++ Native Mod interface for advanced mods
Callback hooks to game events
Interface functions to peek and poke game data
Full integration with the in-game command palette
Works with Games for Windows Live if present
Better error messages for shaders and crashes
File aliasing (like a programmatic REFUELED)
Seamless mod compatibility so everyone plays nice
Configurable launcher and mods
Cool “Blue FUEL” launcher logo :)
Easy to install for inexperienced users

Compatibility

FMTK is fully compatible with legally obtained retail and Steam release copies of FUEL. Pirated versions of the game are not explicitly compatible with FMTK although they may work.

Installing (For Users and Mod Developers)

Verify that your FUEL installation is stock and all of the executable files have their original names.
- If you have renamed FUEL.exe, GameSetup.exe, or SecuLauncher.exe, now would be the time to revert them to their original names. If you have a Steam copy, this can be done with the “Verify integrity of game files…” button in the “Local Files” tab of FUEL’s Steam “Properties…” menu.
- This requirement will be removed in future releases once fingerprinting is implemented.
Download the latest release from the releases page. This will be the asset with a name matching the pattern fmtk-*.zip.
Unzip the release into the root FUEL directory (the directory containing FUEL.exe)
Verify that the mods directory and FUEL.exe are in the same directory.
Run fmtk.exe in the mods/fmtk directory.

In the event of a crash or other game state locking event, i.e. “Error: Shaders processing has failed.” or “The Game Disc could not be read.”, please check the fmtk.log file in the mods/fmtk directory. If you cannot resolve the reported error yourself then please open an issue or contact an FMTK developer directly.

FMTK mods are only loaded when the fmtk.exe “Blue FUEL” launcher is used to run the game. To run the game without mods enabled, simply launch it how you normally would without FMTK; uninstalling FMTK is unnecessary. You can uninstall FMTK and all FMTK mods at any time by deleting the mods directory.

Discord

Join the Zouna Underground Discord for general Asobo Studio modding, beyond and including FUEL. If you plan on joining to ask a specific question, please read the FMTK FAQ first to see if it has already been answered.

Documentation

Documentation for users and mod developers is available on Read the Docs. Documentation for FMTK developers is available on the FMTK Wiki. Bad documentation is a bug! If a piece of documentation is incomplete/incorrect open an issue so it can be improved.

Contributing

See the FMTK Contributing Guidelines. For an inexhaustive list of things you can help with check out the How To Help wiki entry.

These are projects that are related to researching FUEL but not directly part of the modding process.

bff - A GUI/CLI utility to work with Zouna BigFiles
dpc - Tar analogous utility to work with the DPC file format
fuel-brute - CRC32 Brute Force Solver For FUEL
fuel-map - It’s just information about the map
fmt_fuel - Noesis scripts for object formats
blender_fuel - Blender scripts for object formats
atk - Frida agent for asobo games
fuel-save-editor - Save editor for Asobo’s FUEL
ImZouna - ImHex patterns for Zouna data structures

Support

You can support the project by contributing.

Getting Started (For FMTK Developers)

Prerequisites

Git
CMake
Bison or WinFlexBison
llvm-project-widberg-extensions
Any Win32 toolchain
A PC copy of FUEL (Optional)

Checkout

git clone https://github.com/widberg/fmtk.git --recurse-submodules --shallow-submodules

Building On Windows

Use the x86 Native Tools Command Prompt for VS 2022 environment while generating and building the
project.

Ninja

cmake -B build -G Ninja -DWIDBERG_CLANG_CL="/path/to/llvm-project-widberg-extensions/clang-cl.exe"
cmake --build build