Blue's Alphabet Book Mod Loader (Characters, Scenarios, Minigames)

COMPLETE PACKAGE: Windows (loader + game) and source code (generated game source + loader).
Native Windows x64 port of Blue's Clues: Blue's Alphabet Book (GBC), recompiled with GBRecomp.
THIS PACKAGE DOES NOT INCLUDE THE ROM. You must provide your own original ROM.

HOW TO USE
1. Extract the entire folder and keep its subfolders.
2. Run BluesAlphabetBookModLoader.exe.
3. If the ROM is not detected automatically in the roms\ folder, click “Browse ROM...” and select your original .gbc file.
   The program checks its SHA-256 hash; only the original USA ROM is accepted.
4. In the “Characters”, “Scenarios” and “Minigames” tabs, select the mods you want.
5. “Play With Mods” builds a modified ROM (cache\modded.gbc) and launches the game.
   “Play Without Mods” launches the untouched original ROM.
   Your original ROM is never modified. Mod selections are saved in loader.ini.
   Save files (SRAM) are shared between the modded and unmodded game.

INSTALLING MODS
Place each mod folder in mods\Characters, mods\Scenarios or mods\Minigames, then click “Refresh List”.
Use mods\Minigames for mods that change minigame scenes (their graphics/tiles, palettes, maps, text).
Each folder must contain a mod.ini file (see mods\...\_template) and one or more .ips or .bps patches.
You can also place an .ips/.bps file directly in a category folder; the filename becomes the mod name.
Patches are applied in this order: Characters first, then Scenarios, then Minigames, each category alphabetically.

MOD CONFIGURATION (mod.ini)
[Mod]
Name=Mod name
Author=Your name
Version=1.0
Description=Describe what the mod changes (shown below the list).
Patch=patch.ips

LIMITATIONS (IMPORTANT)
- The game is a static recompilation: the game CODE is fixed in the .exe. Mods only work when they
  change ROM DATA (graphics/tiles, palettes, maps, text, tables). Changes to the game's code in a
  patch will have no effect.
- A patch must not change the ROM size (1 MB). The loader recalculates the header checksums.
- If two mods edit the same bytes, they overwrite one another; the last applied patch wins.
- This package includes the loader, not ready-made mods. To create mods, edit the ROM with a tile/hex
  editor and create a patch with Flips (BPS) or Lunar IPS (IPS).

BUILDING THE LOADER
source\loader\loader.c (with the bundled gb_sha256.h and bps_patch.h) builds either with MinGW-w64 (see the
command in source\loader\build_clang.sh) or, without MinGW, with clang + lld via source\loader\build_clang.sh.
BluesAlphabetBookModLoader_Classic.exe is the previous loader build with only the Characters and Scenarios tabs
(English-patched); keep it as a fallback.

LANGUAGE NOTE
The supplied target is the USA release of Blue's Clues: Blue's Alphabet Book, whose in-game content
is already in English. The ROM itself is not included in this package. This English edition translates
the loader interface, source comments/messages, folder names, templates, and documentation.

TESTING
The original package reports that the loader and game were tested under Wine (Linux) using a virtual
display. The game launched and rendered its opening scene with the original and a modified ROM.
It was not tested on real Windows hardware. Audio was not tested (no sound device in the test environment).