Bully Modloader

🎮 Bully Modloader

A non-destructive Virtual File System (VFS) modloader for Bully: Scholarship Edition. Inspired by thelink2012's GTA Modloader.

Replace, resize, and add files inside

.imgarchives and the game's root directory — without ever modifying the original game files. Simply drop your mods into organized folders, set priorities, and launch the game. Removing a mod is as easy as deleting its folder.

✨ Features

• []100% Non-Destructive: Original

  .dir, and loose files are never modified. Remove a mod folder and the game reverts to vanilla instantly.[/]

  []Archive Virtualization: Replace or add files inside any

  .imgarchive (e.g.,

  Stream/world.img) by simply mirroring the folder structure.[/]

  []Larger Files & New Additions: Automatically generates a custom

  .dirfile when your replacement is larger than the original or is a brand-new file. No manual IMG editing required.[/]

  []Root Directory Emulation: Each mod folder acts as a virtual game root. Drop any loose file (

  .ipl, etc.) and it transparently replaces the original.[/]

  []Priority System: Control load order via

  priority.ini. Higher number = higher priority. Equal priorities fall back to the earliest "Date Modified".[/]

  []Toggleable Debug Logging: Enable or disable the log file via

  modloader.inito keep your game directory clean.[/]

  []Thread-Safe: All hooks use a critical section to prevent race conditions during Bully's asynchronous streaming.[/]

📥 Installation

Prerequisites

• []Bully: Scholarship Edition (PC, version 1. 200 — Steam/GOG default)[/]

  []Ultimate ASI Loader (

  dinput8.dll)[/]

• []Place

  dinput8.dllin your Bully game directory (where

  Bully.exeis located).[/]

  []Place

  modloader_bully.asiin the exact same directory.[/]

  []Create a new folder named

  modloaderinside the game directory.[/]

  []Launch the game. The modloader will auto-generate its config files on the first run.[/]

📂 Usage & Folder Structure

├── Bully.exe

├── dinput8.dll

├── modloader_bully.asi      <-- The modloader

└── modloader/

├── modloader.ini        <-- Global settings (Debug toggle)

│   └── mods.ini         <-- Mod load order and status of each mod

│   └── Stream/

│       └── world.dir    <-- Auto-generated custom .dir (do not edit)

├── MyMod/               <-- A mod folder (acts as virtual game root)

│   └── Stream/

│       └── world.img/

│           ├── X.nif

│           └── X.nft

├── MyOtherMod/          <-- Another mod folder

│   └── Stream/

│       └── world.img/

│           ├── Y.nif

│           └── Y.nft

├── ...Replacing a File Inside an

.img

• []Find the file you want to replace (e.g.,

  foreign.nifinside

  Stream/world.img).[/]

  []Create a mod folder:

  modloader/MyMod/Stream/world.img/.[/]

  []Place your replacement

  foreign.nifinside that folder.[/]

  []Launch the game. You're done![/]

.imgFollow the same steps as above. If the filename doesn't exist in the original

.dir, the modloader automatically appends it to a generated custom

⚙️ Configuration

Mod Priority

modloader/.data/priority.ini:

MyTextureMod=50

MyConfigMod=60

• []Higher number = wins conflicts.[/]

  []Equal numbers = earliest "Date Modified" wins.[/]

  []Note: New mod folders are automatically added with a default priority of

  50.[/]

modloader/modloader.ini:

Debug=0Set to