=====================================================================
  MAGIC SCHOOL LUNAR!  (Mahou Gakuen Lunar!)  -  English Translation
  Sega Saturn  -  Patch v1.1
=====================================================================

Ellie and Lena, two village girls who can fly, are scouted for the
Magic School on Ien, a floating island that sails from place to place.
Game Arts' 1997 Saturn remake of Lunar: Walking School, never released
outside Japan - now fully playable in English.


---------------------------------------------------------------------
 QUICK START (Windows)
---------------------------------------------------------------------
 1. Unzip this archive anywhere.
 2. Double-click  Patch_Windows.bat  and pick your disc image's .cue
    file when asked. (If you put these files in the same folder as the
    .cue, it is found automatically.)
 3. A new folder "Magic School Lunar! (English v1.1)" appears next to
    your original .cue. Play the .cue file inside it.

 Not on Windows? See METHOD B under HOW TO PATCH.


---------------------------------------------------------------------
 WHAT'S TRANSLATED
---------------------------------------------------------------------
 * All story dialogue: prologue + chapters 1-12 (about 10,750 messages)
 * Menus, status screen, settings, save/load screens
 * Items, every spell name and description, battle commands and
   messages, enemy names and enemy attacks
 * Party names in the field and battle displays
 * English subtitles for the anime cutscenes (spoken dialogue; the
   theme song is left unsubtitled)
 * New English font (two-letter tiles drawn in the game's own font
   format, so no game code had to be rewritten to display English)

 NOT YET TRANSLATED
 * Text that is part of pictures: title logo, chapter title cards and a
   few image-based labels
 * Voice acting is in Japanese (as in the original)


---------------------------------------------------------------------
 WHAT YOU NEED
---------------------------------------------------------------------
 The Redump disc image  "Mahou Gakuen Lunar! (Japan) (2M)"
 (a .cue file plus 28 .bin tracks). Only Track 01 is patched.

   Track 01 before patching
     Size   454,643,952 bytes
     CRC32  3CC5331F
     MD5    7235EB0892CE34A4A996FC95AFF9687F
     SHA-1  FCDCC837B7BD233E06ACB687DBB264307234037D

   Track 01 after patching
     CRC32  D08C64B1
     MD5    061E770B5F8690201C5FFA2D769DD483
     SHA-1  E65B165BD0231F9C835D48C14E28971B56A2DF9B

 This patch contains no game data you can play by itself. Please use a
 copy of the game you own.


---------------------------------------------------------------------
 HOW TO PATCH
---------------------------------------------------------------------
 This archive contains two ways to patch; use whichever suits you.
   Patch_Windows.bat, Patch_Windows.ps1, patch_data.msl  -> Method A
   MSL_English_Track01.xdelta                             -> Method B

 METHOD A - Windows, one click (nothing else to install)
   1. Put all the files from this archive in the same folder as your
      disc image's .cue file. (If you keep them somewhere else, the
      patcher asks you to pick the .cue file.)
   2. Double-click  Patch_Windows.bat
   3. A new folder "Magic School Lunar! (English v1.1)" appears with the
      patched disc (.cue + 28 .bin files). Your original files are not
      changed. The patcher checks the image before and after patching,
      and takes about a minute.
   If Windows shows a "Windows protected your PC" notice, choose
   "More info" -> "Run anyway". The patcher only reads your disc image
   and writes the new copy; it does not connect to the internet.

 METHOD B - Any system (xdelta)
   Apply  MSL_English_Track01.xdelta  to
   "Mahou Gakuen Lunar! (Japan) (2M) (Track 01).bin"
   with any xdelta3 tool:
     - Windows: Delta Patcher or xdelta UI
     - macOS / Linux / command line:
         xdelta3 -d -s "Mahou Gakuen Lunar! (Japan) (2M) (Track 01).bin" MSL_English_Track01.xdelta "Track 01 (English).bin"
   Then replace Track 01 with the patched file. Keep the name the .cue
   expects (or edit the .cue), and keep tracks 02-28 next to it.


---------------------------------------------------------------------
 HOW TO PLAY
---------------------------------------------------------------------
 * Emulators: tested in Mednafen. Other accurate Saturn emulators
   (Beetle Saturn, SSF, Kronos) should work but are untested.
 * Real hardware: works from a real CD or an optical drive emulator 
   such as Fenrir. This is a Japanese game: a non-Japanese Saturn needs 
   a region-free BIOS/mod or your ODE's region setting.

 Tips
 * Start from a fresh boot. Do NOT load emulator save states made with
   the Japanese version or an older patch - they restore the old font
   and text from memory and the screen turns into nonsense.
 * In-game saves (the game's own save files) are kept in the
   Saturn's internal/backup memory as usual.


---------------------------------------------------------------------
 TRANSLATION NOTES
---------------------------------------------------------------------
 * A few names are shortened where the game's menus have fixed room:
   Hanahime Ranbu = Petal Rush, Ikoi = Repose, and in the field magic
   list Frost Blade appears as "Frost". Some item names are compact
   (Palas Rock, Wake Tonic, Astral Gem). Dialogue uses the same names.
 * Battle commands fit 4-letter windows: Duel / Flee, then
   Hit / Ward / Cast / Combo.
 * Honorifics are dropped; teachers are Mr./Ms. (Ms. Emma, Mr. Iason...).


---------------------------------------------------------------------
 KNOWN ISSUES
---------------------------------------------------------------------
 * Some long names or labels may look tight in a few windows; the game's
   window sizes were designed for Japanese.
 * Please report anything that looks cut off, garbled, or mistranslated,
   ideally with a screenshot (see FEEDBACK below).


---------------------------------------------------------------------
 TECHNICAL NOTES (for hackers)
---------------------------------------------------------------------
 * Dialogue: S00-S12.FLD chapter archives (Shift-JIS, pointer tables).
   The archives are repacked back-to-back into the free space at the end
   of track 1 (the game loads files by name, so this is safe).
 * Font: KANJI.FNT (16x16). 1,501 kanji slots redrawn as English letter
   pairs; the code list is unchanged.
 * Menus/battle: strings in program modules 0, 1 and 2 (loaded at
   0x06018000), written in place or repointed; half-width strings (party
   names, compact spell names) use ASCII.FNT.
 * Cutscenes: MSLM.FLD (Sega FILM / Cinepak). Only the stretches with
   subtitles are re-encoded, keyframe to keyframe; every movie keeps its
   exact size, and audio and video samples stay contiguous and never
   arrive later than in the original stream.
 * Title screen: MISC.FLD entry 5 (8bpp tiles, LZSS like Okumura's:
   4 KB zero-filled window starting at 0xFEE, LSB-first flags).
 * Every changed CD sector has correct EDC/ECC.


---------------------------------------------------------------------
 VERSION HISTORY
---------------------------------------------------------------------
 v1.1  English subtitles for the anime cutscenes; translation credit
       on the title screen and at the end of the opening animation.
 v1.0  First release: dialogue, menus, items, spells, battle text.


---------------------------------------------------------------------
 FEEDBACK
---------------------------------------------------------------------
 Found a bug, a typo, a line that reads oddly, or have a request or
 other feedback? Send it to:

     justin@tooncesoft.com

 Screenshots help a lot. Please mention where in the game it happened
 (chapter, place, or what you were doing) and whether you were playing
 on an emulator (which one) or real hardware.


---------------------------------------------------------------------
 CREDITS
---------------------------------------------------------------------
 English translation, hacking, subtitles and patcher:
                         Justin Grimes / Tooncesoft
 Original game:          (C) 1997 Kadokawa Shoten / ESP / Game Arts /
                         Studio Alex

 This is an unofficial fan translation, not affiliated with or endorsed
 by Game Arts, Kadokawa, GungHo or Sega. Do not sell this patch or
 distribute it bundled with the game.
