feat: spin off Pokémon ROM-hack catalog from homelabstack

Curated knowledge base + pipeline for the valhalla Pokémon ROM-hack
collection, moved out of the homelabstack infra repo on 2026-06-06 so that
repo stays focused on the homelab.

- pokemon-romhack-vault/      Obsidian vault: 75 hack notes + Index/Types/Platform MOCs (generated by build-romhack-vault.py)
- scripts/                    build-romhack-vault, romhack-import/fetch/apply
- pokemon-romhacks-wanted.md  manual-acquisition list (gated hacks)
- drop/                       gitignored ~1.3GB binary staging area

The ROMs live on valhalla (/storage1/Emulation) served by the RomM stack,
which stays in homelabstack (stacks/roms).
This commit is contained in:
ginnoir
2026-06-06 15:32:47 -05:00
commit e59cc361d0
90 changed files with 4241 additions and 0 deletions
+79
View File
@@ -0,0 +1,79 @@
# Pokémon ROM Hacks — Manual Acquisition List
Worthwhile hacks that **could not be auto-patched** because their patches are
gated behind anti-bot hosts (hackdex.app), Discord servers, or Google Drive/MEGA
links that aren't directly fetchable. The auto-patched set (25 hacks) is already
in `roms/<platform>/Hacks/` — see the bottom of this file.
**Scope:** pre-3DS handhelds (gb/gbc/gba/nds) + pre-Wii consoles, per request.
---
## How to hand one off to me
Once you grab a patch (`.bps` / `.ips` / `.ups` / `.xdelta`), drop it anywhere on
valhalla (e.g. `/storage1/igir/romhacks/incoming/`) and tell me. Applying it is seconds:
```bash
# BPS/UPS self-verify the base ROM; xdelta v1 verifies source MD5.
python3 /storage1/igir/romhacks/tools/apply.py <patch> "<base rom>" <out.ext>
# xdelta v1 patches (magic %XDZ): docker run ... node:lts -> apt install xdelta
```
Or I add a line to `scripts/romhack-fetch.py`'s manifest and run `--place`.
A patched ROM is the same end result either way — if you'd rather just download a
**pre-patched ROM**, that works too; I'll validate + rename it to match.
---
## Wanted — handhelds
Base-ROM ownership is noted; ✅ = you already own the base on valhalla.
> **Update (2026-06-06):** the big `pokemon/` drop-folder import added 53 more hacks
> (incl. Emerald Rogue EX, Emerald Seaglass, Sors, Saiph 1 & 2, Flora Sky, Sovereign
> of the Skies, Crystal Kaizo, Lazarus) plus **Following Renegade Platinum** in place
> of Following Platinum. The list below is what's *still* not acquired.
| Hack | Platform | Base ROM | Format | Where to get it | Notes |
|---|---|---|---|---|---|
| **Run & Bun** | GBA | FireRed 1.0 ✅ | BPS | Official Discord · hackdex | Acclaimed hard/competitive hack. Discord-gated. |
| **CrystalDust** | GBA | Ruby ✅ | UPS | itch.io (forever-team) · Discord | Gen-2 Johto remake, complete. |
| **Outlaw** | GBA | FireRed ✅ | IPS | PokeCommunity | Mature, short, complete. |
| **Vega** | GBA | **FireRed (JP) ❌** | IPS | romhacking archives | Needs a **Japanese** FireRed 1.0 base — you don't own one. |
| **Gold/Silver Kaizo** | GBC | Gold/Silver ✅ | IPS | Kaizo Discord | Complete difficulty hacks (Crystal Kaizo now acquired). |
### Optional add-on patches (archived, not applied)
Inside the Sors / Saiph 2 downloads were **optional** extra IPS patches (3DS VC mode, lag-fix, vigilante mode, time-based events) meant to be layered on top of the main ROM. The main ROMs are placed; these extras are kept in `patches/_imported/` if you ever want them applied.
---
## Versions worth refreshing later
These are **already placed**, but newer/better builds live behind gated hosts:
- **Radical Red** — now at v4.10 (from your drop); latest dev builds are on the official Discord.
- **Unbound** — already in your library (pre-existing); update via hackdex.
## Deliberately excluded
- **Clover** — polished but full of offensive/meme content (your "no shitpost" rule).
## Console (pre-Wii)
No well-regarded *finished* N64/GameCube Pokémon ROM hacks exist beyond the GameCube
Colosseum/XD enhancement hacks you **already have** (`Grand Colosseum`, `XD XG`).
Nothing to acquire here.
---
## Already auto-patched (reference) — in `roms/<platform>/Hacks/`
- **gb (1):** Brown
- **gbc (3):** Polished Crystal · Crystal Clear · Prism
- **gba (14):** Gaia · Radical Red · Inclement Emerald · Glazed · Light Platinum · Liquid Crystal · Theta Emerald EX · Snakewood · Mega Power · Resolute · Emerald Kaizo · Dark Rising · Dark Rising 2 · Dark Rising Order Destroyed
- **nds (7):** Renegade Platinum · Sacred Gold · Storm Silver · Blaze Black · Volt White · Blaze Black 2 Redux · Volt White 2 Redux
Source artifacts retained under `/storage1/igir/romhacks/patches/<platform>/`.