A static recompilation of Yu-Gi-Oh! Forbidden Memories (USA, SLUS-01411). The game's MIPS code is translated to C ahead of time and compiled into a native executable, not interpreted by an emulator.
A duel running natively. The menu bar and the duel-rank meter beside the FIELD box are this project's, drawn in the game's own art.
On top sits a set of quality-of-life features: a live duel-rank meter, a fusion assistant, a card-drop multiplier, managers for the drop tables, the cards, the CPU duelists and every fusion in the game, a cheat menu, and MOD packages that export and import all of it as one file to share. All toggleable at runtime.
Built on PSXRecomp.
You bring your own disc. Nothing in this repository, and nothing in the download, contains any of the game's code or data. The screenshot above is just that, a screenshot. The C is generated on your machine, from your copy, the first time you run it.
| Serial | SLUS-01411 (USA / NTSC-U) |
| Players | 2 |
| Publisher | Konami, 1999 |
| BIOS | OpenBIOS, bundled. Nothing to supply |
Everything below lives in the overlay menu on F10, and every setting takes
effect immediately. No restart, no patched save.
The game grades every duel you win but only tells you afterwards. This puts the grade on screen while you play, in the game's own HUD sprites.
| Mode | What you get |
|---|---|
OFF |
stock behaviour |
IN GAME |
the game's POW/TEC badge and rank letter, beside the FIELD box |
IN GAME + SCORE |
the same, plus the raw 0-99 score |
OVERLAY TEXT |
plain text in the corner, never covered by a card view |
Forbidden Memories has thousands of fusions and teaches you none of them. This reads your hand against the game's real tables in memory, not a copied list, so its answers are the game's answers.
| Mode | What you get |
|---|---|
OFF |
stock behaviour |
NUMBERS |
pick order marked on the cards themselves |
NUMBERS + INFO |
pick order plus the name of the card it produces |
HINT ONLY |
just FUSION AVAILABLE: no cards marked, no card named |
VIEW → SUGGEST FUSION BY chooses ATTACK or DEFENSE.
Experimental, expect bugs. Much newer than the rest of this list. It cannot hurt your save: every change is a file beside your saves, and
Restore stockundoes the lot.
The assistant above answers "what can this hand make?" mid-duel. This answers the other question, every fusion in the game, both ways round, and lets you change any of them.
Fuses with is every partner and what the pair makes, equips included with
their +500 / +1000 already in the numbers; Made from is every pair that
makes it. Click a name to follow it, Backspace to go back. Recipes is all
25 146 as one sortable list.
Right-click a row to change, delete or add a fusion, picking the card off a
searchable list: type dragon, take Blue-eyes Ultimate Dragon, never having
to know it is card 380. The orange rows are equip pairings, and they are
editable here too: right-click one to take it away, right-click an equip card
for Add a monster it fits…, or a monster for Add an equip that fits it….
An equip's list is kept as equips = … in its own cards/<id>/card.ini
(the same list the Card Manager edits), so it travels with your cards and a
MOD package, and Equip list back to the disc's own undoes it. The window
shows the pairings the game actually answers, Card Manager edits included. Delete all… empties the table for designing a set from
scratch; Restore stock… (or Ctrl+Z) puts the game's own back, keeping a copy
in fusion_edits_backup.txt. Export… / Import… move a recipe list as plain
text (a card1,card2,result CSV works), and changes save to fusion_edits.txt
as you make them.
MODS → FUSION EDITS replaces the fusion table's disc sectors, so the game's own loader brings your table in and everything reads it, the AI planners included; a duel already running is patched in memory too. The table is read off the disc rather than duel RAM, so the window works from boot with no duel. It also shows the fifteen glitch fusions the packed format produces by accident and the game really performs. The format holds 65 535 bytes and stock uses 65 002, so there is room for about a hundred new recipes; an edit that would not fit is refused.
Stock, a won duel awards exactly one card. This makes it 1-99. It comes with a results screen stock never had: the cards you won across three pages you flip with D-pad Left/Right, with the game's own yellow New! tag on anything you didn't already own.
82 of the game's 722 cards are dropped by nobody, both of Exodia's legs
among them, which is why the set cannot be completed in the stock game. This
gives every one a source by rewriting the weights the duel loads into memory;
your disc is untouched. Placement is yours, in drop_missing_cards.ini:
[Weevil Underwood]
52 = 30, 20, 0 ; Hercules Beetle
278 = 30, 20, 0 ; Petit MothThe three numbers are the S/A POW, B/C/D and S/A TEC rates, out of 2048. 20 is about 1%. Each band totals 2048, so what you add comes off that duelist's normal drops in proportion. Delete the file for the defaults back.
The LIBRARY knows three states per card: never met, seen but not owned (a fusion you watched resolve, drawn dim), and owned. This row makes every card readable while it is on: all 722 show their picture, name, stars, guardian stars, ATK/DEF, text and password, and the figure at the top counts the cards you actually own instead of the ones you have seen.
It gives you nothing. Your trunk is not touched, so a card you looked up here
is still not yours and cannot go in a deck. Nothing is written to your save
either: the marks exist only while the LIBRARY is on screen, which is the one
screen with no SAVE on it, and the row puts your own list back bit for bit
when you leave or turn it off.
Give a duelist a card they are guaranteed to drop when the campaign beats them. Right-click a row in the Drop Table Manager to set or clear one, and pick whether it comes on the first campaign win only or on every one. A stock install has none, so a duelist with no card set is the off switch.
The scripted card replaces that duelist's random drop rather than adding to
it, and only in the campaign - Free Duel is untouched. Pairs are kept in
drop_table_edits.ini alongside your weight edits, so one Save keeps them
and Export shares them.
A separate window you can leave open on another monitor while you play. It knows every card and every duelist's drop table, and you can rewrite any duelist's drops and the game rolls what you wrote.
| View | What you get |
|---|---|
By card |
all 722 cards (id, name, type, ATK, DEF, how many tables drop it), sortable on any column, with every duelist that drops the selected one, the rank band needed, and the chance |
By duelist |
all 39 duelists, with everything they drop, the band, and the weight both raw and as a percentage |
Type to search, click a heading to sort, click a row on the right to cross into the other view. Weights are out of 2048, which is what lets one read as a percentage.
Editing. Click a weight and type a new one; click the rank cell to move a drop between bands; right-click for add, move and remove; or drag a card from the left list onto a duelist. Every band still totals exactly 2048, so what you add comes off that duelist's other drops in proportion, and an edit that cannot balance is refused rather than fudged.
Nothing is written until Save, which persists your table as
drop_table_edits.ini (hand-editable); Defaults clears a duelist back to
stock. Randomize rebuilds every duelist's three bands from stock: each band
keeps its number of drops, every monster slot gets a random monster from the
whole game, the magic, trap, equip and ritual drops keep their card, and every
slot gets a fresh weight that still totals 2048. It asks twice, since it
replaces every duelist's edits at once, and like any edit it is not written
until Save. Export… writes your table to a file to send to someone and Import…
loads one back - an import is kept straight away, so a table someone sends you
is live in the game and still there next launch. With DROP MISSING CARDS on, the manager shows and
edits the table you will actually roll against.
Card names and ATK/DEF come from the running game; the drop tables are baked from your disc when you build. Duelist portraits are Konami art and, like everything here, never shipped. The manager reads them off your own disc.
Experimental, expect bugs. The newest window here; the menu row says so.
Every opponent, and the four things that make them: their portrait, their
WIN/LOSS record, the pool their deck is drawn from, and the nine bytes the
duel AI reads about them.
Decks. A duelist does not have a deck, they have a pool of 722 weights
out of 2048, and forty cards are drawn from it before each duel. Decks lists
that pool heaviest first; click a weight to type a new one and the rest is
rescaled so the total stays 2048, exactly as the Drop Table Manager does it.
Right-click a card to drop it from the pool. The game still deals at most
three copies of any one card, so a big weight buys frequency, not a
solitaire deck.
Turn on All cards to see all 722 beside the pool, with 0 on the ones this
duelist cannot draw: type a weight on one of those, or right-click it, and it
joins the deck. Right-click anything for the rest - remove a card, put the
deck, the AI or both back to stock, clear a record.
AI. gDuel_aOpponentData gives each duelist nine bytes. The AI is a
bytecode VM whose script can be disassembled, and five of the bytes have a
job we can read off it:
Hand size |
how many cards this opponent plays with; 5 early, 20 at the end |
Life point line |
x100 and compared against a life point total, so 10 = 1000 LP |
Fusion deck gate |
compared against the cards left in the AI's deck just before it looks for a fusion |
Combo width |
handed to the best-combo search |
Fusion depth |
minus one, how far the fusion evaluator looks |
The rest are editable but not understood, so the window leaves them unnamed and shows the disc's value beside yours for every byte.
Record. The WIN and LOSS boxes on the title line are the save's own,
the ones FREE DUEL shows. Click either and type.
Name. Click the name on the title line (or right-click the duelist and
Rename…) and type what the FREE DUEL grid should call them, up to 20
characters from the game's own font (letters, digits and a little
punctuation, no accents). Enter keeps it, an empty box puts the disc's name
back, and the grid shows the new name at once. The Drop Table Manager and
this window's list print it too; the ini keeps the disc's name as the
section header so a renamed duelist can still be found.
Portraits. The header above the deck shows the portrait large, with
Change portrait…, Stock portrait and Rename… under it (the portrait and
the name are clickable too): any PNG, JPG or BMP becomes their 48x48 tile,
scaled and quantised to the 64 colours the tile holds, so a small square
picture looks best, and the game draws it on the FREE DUEL grid. Your PNG is kept in
duelists/<id>/portrait.png, so it comes back at the next launch and can be
replaced by hand; Portrait back to stock removes it.
Deck, AI and name edits are kept in cpu_manager.ini (hand-editable) and
applied the moment they change: the AI table and the name are written in
memory (the name is an entry in the same string table the card names use),
and the deck and the portrait go back to the game through sector overrides
of that duelist's disc record and portrait tile, so the game loads them with
its own loader. Nothing on your disc is touched.
A deck pool listed in the ini replaces the duelist's: a card that is not in
the list is not in the pool. Back to stock puts one duelist's deck, AI, name and portrait back. Export… writes the ini, or,
once any portrait is replaced, a .ygoduelists file (a zip, like
.ygocards) with the ini and the portrait PNGs inside, so a set travels
whole; Import… takes either, is kept straight away and replaces what was
there, overrides and portraits included.
Experimental, expect bugs. Much newer than the rest of this list. It cannot hurt your save: edits live in
cards/, andRestore stockputs a card back.
Change any of the 722 cards: name, description, face art, duel thumbnail, ATK, DEF, both Guardian Stars, type, level, attribute, price and password. The change shows up everywhere the card is drawn, because it is applied where the game reads, not where it draws.
Green marks your edit and the x puts it back; the frame row is why an effect
monster comes out orange, and Name color tints the card's name wherever the
game prints it - the library, the chest, the duel. A card with no name color
set draws the way the game draws it.
Dev Card Effects ships one of those colors for 228 of the 722 cards, as
a rarity ladder: blue for a card nobody drops, then red, orange, yellow and
green as the best drop chance any duelist gives it improves. They are yours
from the moment you switch the set on - change one in the manager, or delete
the card's folder to put it back.
An edited card is a folder in your player-data:
cards/<id>/card.ini name = Blue-eyes Ultimate Dragon
color = purple frame (yellow, green, pink, blue, purple, orange)
name_color = red the name's text (white, yellow, blue, green, grey, orange, red)
description = Text with|a line break (| = new line; no | = wrapped at 20)
attack = 4500 defense = 3800
star1 = Sun star2 = Mars
type = Dragon level = 12 attribute = Light
price = 999999 password = 12345678
cards/<id>/art.png any size, becomes the 102x96 / 256-color card face
cards/<id>/thumb.png optional; the 40x32 / 64-color duel card, the middle 80x64 of art.png when absent
cards/<id>/title.png optional 96x14 title strip; rendered from `name` when absent
Every key is optional and a missing one keeps the stock value. Folders are
watched: edit a file or drop a new folder in and the game picks it up within
seconds. Nothing on your disc or in your save is touched. The mod serves
replacement disc sectors and table entries to the running game, and removing the
folder restores stock. Titles are rasterised in the game's own style when a
timesbd.ttf sits in cards/.
The same card.ini carries what a card does:
effect = damage what a Magic card does when played (see the list)
amount = 2000 its number: LP healed or lost, the ATK threshold,
or how much the opponent's monsters lose
target = Dragon for effect = destroy_type
terrain = Yami for effect = field
ritual = 58, 58, 58 -> 26 for effect = ritual: three materials on your field -> result
equip_bonus = 1500 an Equip card's ATK/DEF bonus (stock 500, Megamorph 1000)
equips = Dragon, Warrior, 5, 12 the monsters it fits: types, card ids, all or none
(this REPLACES the stock list; leave it out to keep it)
boost = Dragon +1000, Fairy -500 a field card (Forest..Yami): each type's boost
trap_atk_max = 3000 a trap (House of Adhesive Tape..Widespread Ruin):
attackers at or under this ATK are stopped
Effects a Magic card can take: none, heal, damage, destroy_type,
destroy_atk, raigeki, dark_hole, dragon_jar, stop_defense, flip,
weaken (a negative amount strengthens), swords, cursebreaker, harpie,
field, ritual. Any Magic or Ritual card can take any of them, and the
game's own handler runs with your number. Equip compatibility, ritual recipes,
field boosts and trap ceilings are the game's own tables, served edited. What
stays fixed is what is code rather than data: which cards count as traps (only
681-686), the four scripted traps, and the granularity of heal and damage.
Stock monsters do nothing but fight. The Effects tab shows a monster's rules as sentences. Here is Time Wizard with the one it has in every other game:
Two lines and it is done. + Add effect adds one, the x removes it, every
list filters as you type, and Effect text → description writes the generated
card text onto the card. The same rules in card.ini:
battle = indestructible | mutual | slayer how it fights
on_summon = damage 1000 when it lands face-up on_flip / on_death /
on_attack = heal 500 when it attacks each_turn / opp_turn too
on_summon = 50%: raigeki; else: destroy_own_lp branches, each rolling its odds
bonus = 500, 200 per ally, 500 per Lava Battleguard, 300 per hand
immune = traps, magic
A face-down monster has no effect until it is turned over. The cast effects are
the Magic list above plus gamble (Time Wizard's coin) and destroy_own /
destroy_own_lp; they run through the game's own effect engine, with the popup
and sound the matching spell would show. A monster with any of these draws with
the orange effect frame unless color says otherwise.
MODS → Card set (or Dev Card Effects in the manager, the same switch)
switches to a second card set in mods/card_effects/cards/: the original cards with their
real effects adapted to Forbidden Memories. While it is on, the manager, Export
and Import work on that set and your own cards/ edits sit untouched. Off by
default.
Restore all… puts every edited card back to the disc's own after a yes (the
folders in cards/ go, so Export Config first if you want them back). With
Dev Card Effects on it puts the shipped effects set back instead.
Export Config writes every edited card (card.ini and PNGs) plus your
drop_table_edits.ini to a single .ygocards file, a plain zip. Import Config shows what it holds and what it would replace, first.
Export Descriptions writes all 722 names and descriptions to one text file,
one block per card:
[3] Hitotsu-me Giant
A one-eyed behemoth
with thick, powerful
arms made for
delivering punishing
blows.
Edit it in any editor (a card shows six lines of twenty characters) and Import Descriptions reads it back: only the cards that differ are written. It shows
live.
Experimental, expect bugs. Much newer than the rest of this list. It cannot hurt your save: translations live in
dialogue/, andBack to originalremoves them.
For translations: the campaign's dialogue (150 texts) exports to one plain text file and a translated file imports back at runtime, without touching the disc. The window lists them with a search box, original beside current. The file is just words:
[1923]
Hmmm...
T'would seem I've won.
Many days have passed since
I taught you the game...
But you've still much to learn.
A blank line is a page break, and nobody has to count characters: on import,
long lines are wrapped and long pages split. The game's own codes show as {1},
{2}… and only need to stay in order next to the same words; {name} is the
player's name. An imported file lives on as dialogue/dialogue.txt, and one
that fails to parse changes nothing. That file is never deleted: Back to original, an import of a file with nothing translated in it, and a MOD
package import all turn the previous one into
dialogue/dialogue.backup-<date>-<time>.txt first.
The card shop has never sold a card. This makes it one: the shopkeeper's menu grows a fifth row that buys card packs with your starchips.
Four pack types (monster, magic, equip, trap) across four rarities, priced 20 / 80 / 200 / 800, with all 722 cards in the pool. A pack deals its cards one at a time: X turns over the next slot, TRIANGLE opens the game's own card viewer. Bought cards land in your trunk marked New!, like a duel drop.
Prices, bands and where individual cards sit are yours. The shop writes
card_shop.ini next to your saves and re-reads it each time you leave the
shop and come back:
[prices]
legendary = 800
[packs]
cards = 3 ; 1-3, the results box prints three
[monster]
legendary_atk = 2500 ; a monster lands in the highest band its ATK reaches
[cards]
Exodia the Forbidden One = legendary ; or `rare+legendary` for bothOne file with everything. Export MOD package… writes a .ygomods file (a
zip, like .ygocards) holding every manager's edits and every mod setting:
your own edited cards and their pictures (always the cards/ set, never the
Dev Card Effects set, whichever is live), the drop tables and scripted story
drops, the CPU duelists' decks, AI, names and portraits, the fusion edits,
the dialogue translation, the drop-missing-cards placements, the card shop's
configuration, and a mod_settings.ini with the value of every MODS,
CHEATS and VIEW mod row. Whatever you have not touched is left out.
Revert to Stock, the last row: every manager's edits and every mod setting
go back to the disc's own, saved or not. It asks twice: the first choice is
the warning, a second within ten seconds does it. Export MOD package… first
if you want any of it back.
Import MOD package… hands each part to the manager that owns it, through
that manager's own import, so each part replaces yours the way that
manager's Import does and is kept straight away; the settings rows are set
as if you had clicked them. A part the file does not carry leaves that
manager alone. The default folder is mod_packages beside your saves.
Packages keep working across versions. Every part is a plain-text file
read only by its own manager; a part the file lacks, a file the game does not
know, or a key it does not know is skipped, keys never change meaning, and the
format number only moves when an older game would misread a file (then the
older game refuses it and says to update). Before a release,
tools/package_roundtrip.py exports, reverts, imports and exports again and
compares every part, then imports the packages earlier versions wrote
(tools/fixtures/).
python3 tools/randomizer.py --seed 2026 builds a whole-game randomizer as one
.ygomods file, from this disc's own data (it needs the debug build running
past the boot screen, see tools/LIVE_TESTING.md). Every monster's ATK and
DEF are rolled outright from 0 to 4500 (a card the game can deal into a new
game's first deck stays under 3000), its level, type, attribute and guardian
stars are rolled, every card gets a random frame
color, name color, price and password; 60 % of monsters get a cast effect (a
third of those two, on different triggers), a fifth a battle rule and maybe an
immunity, 15 % a field bonus that can be negative, and about a third of the
casts hurt their owner; every Magic and Ritual card gets a new effect (Ritual
cards a real recipe half the time), every trap a new ATK ceiling, every equip
a new bonus and a random set of monsters it fits, every field card new type
boosts; and every card whose effect changed has its description replaced by a
short text saying what it now does; every duelist's drop tables, deck pool, hand size,
fusion deck gate, combo width and fusion depth are rolled; the monster +
monster fusion results are shuffled; and the package switches on CARD DROPS
at 15, DROP MISSING CARDS and LIBRARY PLACEHOLDERS. The drop tables come
in two shapes: the default pins up to 128 random monsters over each duelist's
stock table, taking most of every band, which every release since 0.5.5
loads; --drops full rewrites the bands outright, like the Randomize
button, and needs the runtime that ships with it. The CPUs still ramp:
the later a duelist sits in the campaign, the stronger the monsters their
pool draws from, the heavier their strongest cards weigh, and the bigger their
hand, combo width and fusion depth. --difficulty 2 makes that ramp steep
from the first duelist, --difficulty 0 flattens it. Same seed, same
package, so a seed is enough to share a run. Import it with MODS → IMPORT MOD PACKAGE…, after
exporting your own package if you want your edits back.
16:9, contributed by yamyi. The duel field renders genuinely wider; flat 2D screens stay 4:3 and are pillarboxed rather than stretched. Experimental: culling pop-in at the wide edges has not been fully checked for this title.
| Row | Range | Notes |
|---|---|---|
LIFE POINTS |
1-9999 | 8000 is stock. Applies to both duellists |
SHOW OPPONENT HAND |
on / off | their hand is drawn face-up, like yours |
FORCE FACE UP |
on / off | their set cards play face-up, and stay face-up |
STARCHIPS |
0-999999 | written straight to your save |
FREE SPENDING |
on / off | purchases succeed, the deduction is undone |
ALL CARDS |
1, 2 or 3 of each | fills the trunk. Apply with the chest closed |
Neither reveal is an overlay: they clear the actual flags, so a monster revealed face-up genuinely is face-up and will not flip when attacked. The first three rows are preferences restored on every launch; the other three write live save data, so they are not re-applied at startup and decline until a save is loaded.
Stock, a heal card stops at the LP the duel began with, so Mooyan Curry at 8000 LP does nothing. Here a heal carries LP up to 9999, the most the counter shows. Both duelists.
Also in the F10 menu, courtesy of PSXRecomp: save states, rewind (F8), an
emulation-speed multiplier, and GAME → FAST LOADING, which cuts disc loads
to near-instant. That one ships off.
Xbox controllers work out of the box, no setup. So do PS4 and PS5 pads (rumble on DualSense) and Steam Input. The game is a PS1 title, so it starts in digital pad mode and the sticks map to the d-pad.
Very old DirectInput-only pads are the exception. DirectInput is off by default because enumerating it stalled startup by up to 40 seconds on some machines. Set
SDL_JOYSTICK_DIRECTINPUT=1to bring it back.
| PlayStation | Key | PlayStation | Key | |
|---|---|---|---|---|
| D-pad | Arrow keys | L1 | Q |
|
| ✕ Cross | X |
R1 | W |
|
| ○ Circle | S |
L2 | E |
|
| □ Square | Z |
R2 | R |
|
| △ Triangle | A |
L3 / R3 | T / Y |
|
| Start | Enter |
Select | Right Shift |
Mostly you need arrows to move, X to confirm, S to cancel.
| Key | Does |
|---|---|
F10 |
Open the overlay menu, where every feature on this page lives |
F7 |
Save / load state |
F8 |
Rewind |
Tab |
Turbo (hold) |
Alt+Enter or Ctrl+F |
Fullscreen |
F |
Show performance stats |
Numpad + / - |
Volume |
Keys live in keybinds.ini in the player-data folder (Documents\My Games\Yu-Gi-Oh Forbidden Memories Recompiled, or next to the executable on a portable install),
with the accepted names at the top. The launcher's controller page edits the same file. Each input takes a second binding after a comma: cross = X, Mouse1.
The download is a setup host: a small executable plus the recompiler and the framework source. It has no game code in it until you supply a disc.
- Run
Yu_Gi_Oh_Forbidden_Memories_Recompiled.exe. - It asks for your disc image and checks it against the CRC32 this build expects. A mismatch is refused, naming the release it needs.
- It downloads a compiler if you have none, translates the game to C from your copy, and compiles it.
- It builds into
build-release/and starts the game.
Nothing needs installing first. The setup brings its own compiler and Python, and uses yours if you already have them.
A compiler download, a whole game translated to C and a real compile happen before you see anything; the console working away is not hanging. Every run after the first starts immediately.
.cue is preferred, with its .bin beside it; .bin, .img, .iso and
.car also work.
This build is compiled from the USA release, serial SLUS-01411. A PAL,
Japanese or Greatest Hits disc is a different program and cannot run here. The
expected data-track CRC32 is recorded in game.toml as disc_crc. To repoint
it, use FILE → CHANGE GAME DISC.
Scripted and headless runs have no picker and must be told:
Yu_Gi_Oh_Forbidden_Memories_Recompiled.exe --disc "/path/to/game.cue"Also available: --memcard-dir <path>, --no-launcher.
The framework is a submodule at psxrecomp/, so clone recursively:
git clone --recurse-submodules https://github.com/Unchiga/YuGiOhForbiddenMemoriesRecomp.gitgenerate produces both the recompiled BIOS and the game's C. A fresh
clone has no BIOS backend until this runs:
python3 psxrecomp/psxrecomp_cli.py generate \
--config game.toml --project-root . --disc /path/to/your.cue
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build --target psx-runtime(The setup host does exactly this for you, see First run.)
generated/ and the baked sprite and font sources come from your disc; they
are gitignored and must not be published, see NOTICE. CMake must know
where your disc is: running generate first is enough, failing that
-DYGOFM_DISC=<path>.
Builds and runs natively on Apple Silicon with the commands above. Needs the
Xcode Command Line Tools plus brew install cmake ninja pkg-config sdl3. Use
-j4 on an 8 GB machine, as the generated C includes shards of 400k+ lines.
Add -DPSX_DEBUG_TOOLS=ON for a debug build with the TCP inspection server on
127.0.0.1:4370.
cmake -S psxrecomp/recompiler -B build-recompiler -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build-recompiler --target psxrecomp-game psxrecomp-bios
cmake -S . -B build-setup -G Ninja -DCMAKE_BUILD_TYPE=Release -DPSXRECOMP_FORCE_SETUP_HOST=ON
cmake --build build-setup --target psx-runtime
scripts/package_setup_release.sh build-setup <artifact-tag>Writes dist/ygofm-<version>-<tag>.zip. Needs objdump on PATH, and the
build directory must be a setup host build, not the game.
psxrecomp/ is pinned to the
ygofm branch of a fork of
PSXRecomp, for framework work not upstream
yet: the disc-identity gate, registration APIs so a title owns its own debug
commands and overlays, the hooks the manager windows run on, and a
launcher-less setup host. All additive and intended for upstream.
Symbols: symbols.toml → python3 tools/sync_symbols.py → psx_symbols.h
(PSX_FN_*). See psxrecomp/docs/SYMBOLS.md.
PolyForm Noncommercial License 1.0.0, see LICENSE. Noncommercial use only, and it cannot be sublicensed or swapped for a permissive one, because the framework it builds on is offered on the same terms (Copyright © 2026 Matthew Stan). It grants nothing in respect of the game, which is Konami's. Use only a disc image you obtained legally.
Read NOTICE before redistributing anything, particularly before sharing a compiled build, which is not the same as sharing this repository.
Join our newly created Discord, https://discord.gg/SR8qWG9Ve