FUEL Modding Toolkit
- 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
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.
- 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, orSecuLauncher.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
modsdirectory andFUEL.exeare in the same directory. - Run
fmtk.exein themods/fmtkdirectory.
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.
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 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.
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
You can support the project by contributing.
- Git
- CMake
- Bison or WinFlexBison
- llvm-project-widberg-extensions
- Any Win32 toolchain
- A PC copy of FUEL (Optional)
git clone https://github.com/widberg/fmtk.git --recurse-submodules --shallow-submodulesUse the x86 Native Tools Command Prompt for VS 2022 environment while generating and building the
project.
cmake -B build -G Ninja -DWIDBERG_CLANG_CL="/path/to/llvm-project-widberg-extensions/clang-cl.exe"
cmake --build build