Illusion City
— 幻影都市 —
Complete Japanese to English localization for MSX2, MSX2+ and Turbo-R (ROM 0.5) by MSX.Translations
232 (translation, research, beta testing)
Max Iwamoto (reverse engineering, coding, GFX, fonts, re-design, beta testing)
KROP (proofing, beta testing)
SHADOW (proofing, beta testing, operations manual)
Vampier (proofing, beta testing)
Older Patch Versions (1)
Original v1.0.0 disk translation only: these are the Japanese input-disk SHA-256 checksums for the disk IPS patches inside the included original/IC100ENG.ZIP. ROM 0.5 uses the original English ROM 0.3 or eight already-translated English disks instead; its exact input and output hashes are in README.txt inside IC105ENG.ZIP.
Disk 1 : 5CED541B72AC78067B99193537B4BAD45C41F7D36BF674A6ECDED1C9AFD2F100 Disk 2 : 0B15D64C3FF77CD478A6095E1C4FC6B09806677056A7894A019FBF0B1DC923B4 Disk 3 : CB6FBFD217FAC742591E85B3835A635204C6967191E6F16C985069853A157343 Disk 4 : 706E5EF7CD82A4BED07248F5B30F15DF2D6BD30741D657D71AE38BB173BAD848 Disk 5 : 1D55A9E933FFC3A2B4BADDCD92B5746ECD8F5145267CA51B1A95AB2566AFDD3D Disk 6 : 5575F2BB1D464EDE3FFBEA25CAE28B191024B834040148F8CE3D783489DD6491 Disk 7 : AA93290974EA38E4E8C4CEAE7A116220538DC85DA9DDD3520B1FCF4C468F9DF9 Disk 8 : 00483B61F499FE239ADB441E85E814BCCDEBCC67F554A46701BD809CBFBBDF8B
Support MSX Translations
Enjoying our localization patches? You can support future MSX translation projects via PayPal:
♥ Donate with PayPalVideo Previews
Announcement Trailer
Complete Intro Demo
New Game Gameplay Preview
Play Up to the End
Translation Features
[ Version 1.0.5 | ROM 0.5 - Released November 15, 2026 ]
- The original translation 1.0.0 / ROM 0.3 was released in September 2025. The following improvements are for the new ROM edition.
[ Hardware compatibility | ROM 0.5 ]
- The ROM now runs on MSX2 and MSX2+ with 256 KB of memory-mapper RAM and built-in MSX-MUSIC or an FM-PAC, as well as on Turbo-R.
- Removed the Turbo-R-only startup restriction and adapted the FM driver for Z80 machines without the Turbo-R timer hardware.
- Automatically enables R800 mode on Turbo-R and the supported Panasonic MSX2+ turbo mode.
- Protected the FM driver against overlapping interrupts while preserving music, sound effects and screen interrupts. FM needs 256 KB; MIDI retains its 512 KB RAM and compatible MIDI hardware requirements.
[ Faster maps, battles and windows | ROM 0.5 ]
- Cached unchanged field and battle map buffers instead of expanding the same map data repeatedly.
- Reused unchanged tile and layer composition on both display pages, while retaining repairs for moving characters, targeting and damage animations.
- Reduced repeated work in tile comparison and clean-tile scans, skipped unchanged columns, and reused overlapping map strips during scrolling.
- Cached animation lookups and tracked exactly which visible tiles depend on each animation. Offscreen animation changes no longer force unnecessary full map checks.
- Tracked battle animation dependencies separately for each layer and skipped unchanged battle columns. All scenery layers, animation steps and the original game-area size remain enabled by default.
- Fixed cache invalidation after loading a save, so ordinary resource reads no longer discard reusable map and composition data.
- Restored the interface from an expanded ROM copy instead of repeatedly decompressing it during conversations, elevator transitions and menu changes.
- In matched tests, the MSX2 tile comparison/composition pass fell from 78.2 ms to 11.3 ms, and an MSX2+ apartment redraw after loading fell from 279 ms to 125 ms. These are specific workloads, not a universal or cumulative speed multiplier.
- Added an experimental F1 foreground ON/OFF switch for field maps, including Downtown signs. Ground and other scenery layers remain visible; battles keep all layers. The setting is not saved.
[ Battle and magic fixes | ROM 0.5 ]
- Restored the moving attack animation for the SHIVA Guard Robots using the newer archived engine behaviour, with correct targeting and damage.
- Fixed the target-candidate overwrite that could make Tian Ren less likely to be attacked. The original random selection, distance and status rules are preserved.
- Consuming Nectar of the Gods now clears its revival effect from both the battle and persistent character records, preventing it from becoming armed again when the battle record is rebuilt.
- Made HP/MP effects safely skip empty target-list entries, complementing the translation's existing target-count correction.
- Corrected Headgear paralysis protection: it now blocks paralysis instead of blocking its cure, and recovery works while Headgear is equipped.
- A confused character's failed attack without ammunition now ends the turn, without repeated retries or a free attack. Normal attacks and ammunition handling are preserved.
- Fixed Zhuo Shi Kai's free field magic overwriting Tian Ren's MP by restoring the correct caster pointer. Zhuo's zero MP cost and normal spell costs remain intact.
- Instantaneous Return with no valid destination now displays an English barrier message and returns to the caster menu instead of repeatedly casting and reopening the error. Valid destinations retain their normal behaviour.
[ Menus and mouse controls | ROM 0.5 ]
- Known spells now appear consecutively in the Magic list, without large empty category gaps. The list is rebuilt from the character's progression, preserving spell identities, their order and spells learned later.
- Fixed damaged selection frames and copied cursor fragments in the battle Items and Magic lists by preserving cursor state and alignment during arrow redraw.
- Aligned the right-side scroll arrows with their mouse click areas and kept them visible through window refreshes. Buy pages restore their arrows, and the BGM menu keeps responding after changing songs.
- Repaired screen restoration when closing Debug and when returning from Save Anywhere or its cancelled Save menu.
- Cleared selection-outline residue when returning from refused or empty Sell selections, while retaining normal cancellation.
- Added English explanations for protected-item discard, unusable items, equipment restrictions, a full inventory when removing equipment, and insufficient MP. Empty slots and cancelled actions remain silent.
- Pressing Space in Speed Adjustment no longer disables Left/Right. Keyboard and mouse adjustments continue to work after confirmation.
- Using the last copy of an item now returns to the list without an incorrect error sound. Empty slots return silently, while genuinely unusable items retain their error feedback.
- Fixed the shifted mouse arrow after portrait conversations, including Discuss after Instantaneous Return to Kai. Portrait palette switching now retains the correct 8x8 sprite mode.
[ Startup artwork and release tools | ROM 0.5 ]
- Added the new 512 x 424 interlaced SCREEN 7 MSX Translations logo with palette fade-in/out.
- Added the new 256 x 192 SCREEN 8 title picture after the translation logo, replacing the old SCREEN 12 startup artwork.
- The startup images use CBS Cruncher v5.5 streams with a rolling 16 KB buffer, retaining each image field or picture as one continuous compressed stream.
- Included Windows openMSX launchers for MSX2, MSX2+ and Turbo-R. Place the patched ROM beside the launchers, or drag it onto one to play. Settings and FlashROM saves are kept in the release folder.
- Included an IPS update from the original ROM 0.3 and an RCD conversion from the eight English disks of translation 1.0.0. Both routes produce the same ROM 0.5.
- Included the complete original 1.0.0 release archive, unchanged, with disk translation patches, manuals and extras. Translate Japanese disks with those patches, then convert directly to ROM 0.5 with the new RCD.
- For emulator play, use Max Iwamoto's openMSX build from GitHub for easier FlashROM saves across compatible ROM updates, convenient mouse capture and Makoto / YM2608 support. Makoto PC-98 music for Illusion City is coming soon; ROM 0.5 retains its FM/MIDI soundtrack.
[ General ]
- Full translation of all the texts on all 8 disks (Intro, Main Game, and End Demo/Credits).
- Translated an alternative version of Illusion City where a few scripts and map data are different from the most common version (Disk 2 and Disk 8).
- Translation of the manual for backstory, more details, and better translations of items, weapons, magics, etc.
- Decompiled all 151 Event (EVT) scripts and 4 Scene (SCN) scripts with the ability to compile them back into the game (later one EVT script was removed as a redundant and 4 SCN made into one).
- Discovered and fixed duplicate scripts and unused scripts in the game.
- Recreated in-game compressor to be able to alter GFX and data and compress it back into the game.
- Created new special dual compression for the script files in order to fit them in the same space or less as the original game. All scripts unpack as they print on the screen.
- Translated graphics where it was required.
- Dumped scripts from the PC98, SHARP X68000, and Mega CD version of the game to enrich MSX texts.
- Translation working on 256KB or 512KB Turbo-R like the original game.
- MIDI Music fully working for both Turbo-R 256KB (with MuPack) and 512KB with MSX MIDI.
- Added newer version 1.02 of ARMI.COM from MSX Fan 14 to DISK 1 and translated it. You can play RCP MIDI files with it.
- Added a translated version of ARMI.DOC for ARMI.COM 1.02 to DISK 1.
- Created 4MB (real size 3.6MB using "AI" optimization) ROM version of the game - almost instant loading speeds, no "change disk" messages plus other improvements.
- Added Flash ROM save to the ROM version of the game (now supports ASCII16-X mapper, MegaFlashRom+SD, Carnivore 2). Tested on openMSX and real hardware.
- Disassembled Fray.DOS and the game initialization routine to improve multi-mapper support and ensure full MuPack compatibility. Code was heavily optimized for size, with many new options and improvements added.
- Fixed the issue when MIDI initialization would crash if the data buffer was not empty before loading the data.
- Many improvements to the game to remove some small flaws.
[ Intro ]
- Altered texts and graphics appearance to make it better for English texts.
- Added space to the "ILLUSION CITY" logo and re-synchronized with the lightning animation.
- Added English text to the game logo (similar to the game box art).
- Fixed hotel/ skyscraper name GFX from "Horizn" to "Horizon" on the billboard.
- Added palette pulsing to the title screen.
- Created a variety of fonts for all intro screens.
- Added black contour for the texts that overlap pictures.
- Moved red image(s) to better position it for wrapping the texts in English.
[ Main Game ]
- Completely rewrote in-game print subroutines with support of a new lowercase variable-width font.
- Moved all printing from character-based to pixel-based.
- Added the ability to auto-center texts, shift texts, and more.
- Added automatic color changing to characters names during text conversations.
- Added multi-color texts during battles.
- Expanded the post-battle window to display five lines, allowing users to view all text without the need to scroll.
- Sped up printing by eliminating the VRAM buffer. Text now prints directly from RAM to screen.
- Optimized and improved menu bar code (line drawing) and visual appearance.
- Adjusted in-game windows to accommodate bigger English text.
- Adjusted dimensions of menus to fit English texts nicely.
- Added ability to the game to automatically select window size based on the amount of text to be printed (for menu selection window).
- Added ability to store longer names of items/weapons/magic/etc.
- Fixed Scene (SCN) script on disks 5/6/7. Added events texts that were missing.
- Corrected continuity errors with NPCs on disks 3, 4, and 5. Added new messages to the NPC on disk 2 to address a previously missed event.
- Resolved an issue where the NPC on disk 3 displayed a message prematurely.
- Included the missing Dasa release message for Yama.
- Removed a delayed animation after going back on disk 5.
- Fixed a bug related to the Death Mask, preventing players from dying even when the mask was removed and making it impossible to defeat the boss.
- Created a new way of displaying magics in menus.
- Improved text on menu buttons of the main game screen.
- Extended size of the battle menu to fit bigger texts and menu options.
- Added current level for each character during battle.
- Added a new player status mode where you can see the current player status as "Normal/Confused/etc...".
- Made items like Petrify Needle unusable during boss battles to ensure balanced difficulty.
- Resolved (removed) the ability to scroll through all Protective Gear and Weapons in the [Weapon & Armour Store].
- Re-coded magic menu to have one menu line instead of three. This is done to fit full English magic names.
- Added gender-correct messages when he/she cannot use magic.
- Translated original in-game [debug menu].
- Fixed a major issue where blue "disabled" magics were usable during boss fights.
- Fixed major issue with party almost never able to escape. The whole code for it was wrong. Now it works as intended.
- Fixed a bug where the cursor could move off-line in the "Select Character" window.
- Improved magic usability: the cursor now remains on the same line after casting spells.
- Made adjustments to game INT to improve screen split and palette change for portraits.
- Found and fixed an issue with player animation in the final boss fight.
- Corrected the bullet type for the Thompson submachine gun so it uses the same bullets as in real life.
- Fixed a major issue with pre-generated enemy pointers causing multiple problems, including fleeing from a battle.
- Re-coded subroutine for escape to work as intended.
- Made special code to fit Ensealed Spell Shells in the item list and during battle mode.
- Added items that were missing in the game (some located in stores and some in maps). Some of them were present in the manual.
- Translated "ELEVATOR" GFX to "LIFT".
- Implemented text delay adjustments and other optimizations during battles to enhance readability and playability.
- Restored functionality that shop contents are dependent on level.
- Fixed a skill level issue that caused characters with a high skill level to almost never hit anymore.
- Fixed a bug where a character with a debuf on his agility to become so fast that he can go multiple times before the monster could.
- Fixed some continuity errors for some NPCs.
- Implemented the unused music (ROM version only).
- Improved screen split when in discuss mode or when in an event.
[ End Demo | Credits ]
- Thoroughly overhauled the End Demo and Credits printing subroutines, now supported by three newly introduced fonts.
- Re-synchronized the End Demo's English text to harmonize with the animations and music.
- Incorporated English text into the game logo, mirroring the aesthetic of the game's box art.
- Conducted thorough research on the game's staff to ensure full names are accurately included in the Credits.
Illusion City — Main Characters
Tian Ren
Mei Hong
Hou Mei
Xiao Mei
Lao Shi
Airen
Doc
Isaac
Kash
Nan Tian Lee