Skip to content
eadmaster edited this page Mar 5, 2026 · 27 revisions

Retrosub not loaded/found

Try to copy the .retrosub file next to the associated ROM/cue file, and rename so it matches the filename. e.g.: Momotarou Katsugeki (Japan).pce -> Momotarou Katsugeki (Japan).retrosub

Text looks too small or pixelated on Linux

Well-known issue with Bizhawk, workaround here.

Text stuck onscreen, or not appearing after a savestate load

Solution: reload the lua script (shot)

Unable to find domain XXX Error

Use these emulation cores:

System BizHawk RetroArch
PC Engine PCEHawk Beetle PCE Fast, built after this PR
SNES Snes9x Snes9x
SMD/SMS/GG Genplus-gx Genesis-Plus-GX-Wide, built after this PR
GBx, GBA mGBA mGBA
NDS MelonDS MelonDS
Saturn Saturnus
PS1 Nymashock

To change default cores in BizHawk, use the menu "Config->Preferred Cores". Then restart.

How can I use this to translate game X?

See the mini guide.

Why not statically patch the ROM?

Because it's easier and faster with Lua scripting, since you are avoiding most traditional ROM hacking issues, like space limitations, text compression, font replacement, pointers rewriting, etc.

Long explanation of the differences

Why not using an OCR engine?

Memory hashes are more reliable to match the text/context (see the discussion here). On the flipside, generating hashes is harder to automate.

Why not using a text hooker?

While text hooking is a viable alternative for modern titles, it is often not feasible for retro games. Related project.

Real hardware support?

Tecnically possible, but it requires a lot of work and extra hardware. See this discussion for Retroachievements. On FPGA boards like the Mister it should be much easier without extra parts.