Skip to content

NOTPIES/FractureLoader

Repository files navigation

FractureLoader

FractureLoader Banner

FractureLoader is a mod loader for South Park: The Fractured But Whole.
It injects into the game at runtime and dynamically loads mods from disk.

Menu Screenshot 1 Menu Screenshot 2

FractureLoader also includes extra tools for Snowdrop Engine debugging and modding, such as:

  • A UI Blueprint Loader (muigraph)
  • An Faceman Engine Layouts Loader
  • Platform Changer (enable platform-specific behavior, etc)
  • Skip Startup Intro (skip logos/videos on launch)
  • Demo Type Changer (change demo-related restrictions, enable E3 mode)
  • Camera Controls (FOV override, free camera)
  • World Management (game state, time of day, teleportation, actor inspector)

Note: This project is experimental and under active development.


Supported Versions

  • Game: South Park: The Fractured But Whole – Latest Steam/Ubisoft Connect version (Steam Build ID 11479433)

Features

  • Modular Loading: Loads mods from a Mods/ folder next to the game executable.

  • In-Game Overlay: Displays mod information and modding utilities directly in the game.

  • Asset Overrides: Loads and overrides game files from disk without repacking .sdf archives.

  • No File Size Restrictions: Modified files do not need to match the original file size.

    Important: If you modify binary files like .mmb, ensure you also update any size fields (in hex) inside the file as required by the format.

  • Camera Controls:

    • FOV Override – Adjust the camera field of view with a slider.
    • Free Camera – Detach the camera from the player and move freely using arrow keys. Scroll wheel adjusts FOV. Sensitivity is configurable.
  • World Management:

    • Game Action State – View and change the current game action state.
    • Time of Day – Change the in-game time of day.
    • Teleportation – Teleport the player to specific coordinates.
    • Actor Inspector – Browse all actors in the world, view and edit their position, rotation, and scale. Teleport to/from actors or possess them.

How It Works

FractureLoader replaces or injects as the uplay_r1_loader64.dll to gain entry into the game process.
Once injected, it hooks into Snowdrop Engine functions (e.g., file stream loader) to:

  • Initialize mods
  • Override game assets
  • Provide additional debugging utilities

Mod Layout

Each mod resides in its own subfolder under FractureLoader/Mods/.

Example Directory Structure:


SouthPark_TFBW/
├── FractureLoader.dll         (renamed to uplay_r1_loader64.dll)
├── SouthPark_TFBW.exe
└── FractureLoader/
  └── Mods/
    └── ExampleMod/
      ├── manifest.ini
      └── camel/         (override game files)


manifest.ini Format

name=ExampleMod
author=notpies
version=1.0.0
description=Example description

Field Explanations:

  • name – The display name of the mod (shown in the overlay).
  • author – The creator of the mod.
  • version – The mod’s version number for compatibility tracking.
  • description – A short text describing the mod’s purpose or content.
  • preloadCustomAssets – (Optional) Set this to true to enable support for more custom assets (if the custom assets you use on the mod already work without this option, then don't enable this as it may cause some unexpected crashes)

Setup

  1. Inject FractureLoader.dll into the game:

    • Recommended: Rename FractureLoader.dll to uplay_r1_loader64.dll and rename the original dll that is on the root game folder to uplay_r1_loader64_orig.dll.
    • Place it in the root game folder next to SouthPark_TFBW.exe.
    • Alternative: Use a manual DLL injector to inject FractureLoader.dll at runtime.
  2. Launch the game once to initialize FractureLoader.

  3. Add your mods to FractureLoader/Mods/.

  4. Start the game as normal. If loaded correctly, the in-game overlay will appear.


Requirements

  • Windows OS
  • South Park: The Fractured But Whole (Steam or Ubisoft Connect) Pirated copies are not supported.

Disclaimer

FractureLoader is not affiliated with Ubisoft, Massive Entertainment, or South Park Studios. It is provided for offline and educational use only. Modding the game may violate its EULA — use at your own risk.


Credits

About

A mod loader for South Park: The Fractured But Whole.

Resources

Stars

Watchers

Forks

Packages