------------------------------------------------------------------------------- 『The Moon To The East, The Sun To The West ~Operation Sanctuary~』 Trial Edition 2003/7/20 August Soft 2005/5/27 insani ------------------------------------------------------------------------------- ■ Introduction Thank you for downloading and installing the Trial Edition of August Soft's third game, 「The Moon To The East, The Sun To The West~Operation Sanctuary~」 (nickname: Hanihani). We feel that the text enclosed herein is a very good representation of the game, so we hope that you will enjoy it as you read through it. ■ Installation If you are reading this document, then you have probably already set up the Hanihani Trial Edition correctly on your computer. Windows users should not have to use Microsoft AppLocale or set Japanese as the default ANSI codepage. ■ Uninstallation Windows: Control Panel -> Add/Remove Programs -> Hanihani Trial Edition -> Uninstall Mac OS X: Simply delete the folder "Hanihani Trial Edition". Linux: Simply delete the directory "hanihani_trial". ■ Game Contents The Trial Edition represents perhaps the first 6% of the game, with assorted scenes from elsewhere in the game thrown in. Thus, there may be some points where the story does not seem to flow as well as it should between transitions. Please bear with us. ■ Game Controls The game can mainly be controlled through the mouse: - Left-clicking advances text. - Right-clicking cancels, and also hides the text window. - Clicking on the Save or Load button opens up the appropriate dialog. There are also extensive keyboard shortcuts built into Hanihani -- in order to learn about those, please press the F12 or Insert key in the game. ■ Quicksaves There are exactly 3 quicksave slots, and the topmost slot is always the most recent save. You cannot choose a quicksave slot to save on, and if there are already 3 quicksaves, then the least recent one is always erased to make room for the new one. ------------------------------------------------------------------------------- ■ Troubleshooting ○ If you cannot install If running Windows, please make sure that you have no other programs running while the program installs. The installer bundle that you downloaded may also be corrupted -- you might try downloading a fresh copy, making sure that you obtain it from us at http://www.insani.org/ Finally, please make sure that you have no viruses or spyware on your system that might interfere with the installation process (or, for that matter, ANTIvirus software that might interfere with the installation process). ○ Game does not run Make sure that the file "default.ttf" is still intact -- do not delete it even if you already have appropriate SHIFT_JIS capable fonts installed. ONScripter (see Compiling section, below) depends on the existence of a default.ttf in the same directory as it. ○ What's up with that untranslated logo? The graphical work involved in hacking in a translated version of this logo was deemed to be too high to be feasable for the purposes of this release. A translation follows: 東奔西走スクールライフADV Hectic School Life ADV 月は東に日は西に the MOON to the EAST, the SUN to the WEST And yes, just in case you were wondering, this is where this game's nickname (Hanihani) comes from. A translation of said nickname itself might go something along the lines of "to the to the". Another interesting thing is that although in the nickname, the pronunciation of は is, well, "ha", in the context of the title it's pronounced more like "wa" -- "tsuki wa higashi ni hi wa nishi ni". ○ If you are seeing a Moire pattern in-game It is most likely that your computer is running in High-color (16-bit) mode. This game is designed to run in True-color (24-bit or 32-bit) mode, and if you are running in 16-bit color, then you are likely to see the artifacting detailed above. Therefore, for optimal play, please make sure that you are running in True-color mode. ○ If buttons aren't doing what they're supposed to This game utilizes many keys, some of which may be in concurrent use by other programs. If you are finding that the buttons are not doing what they are supposed to, please make sure that you are not running any other programs that simultaneously use the same buttons that this Trial Edition uses. ○ Fullscreen mode does not work You are most likely attempting to use the familiar keyboard shortcut, ALT+ENTER. This does not work. However, the fullscreen toggle inside the Config menu is fully operational. ○ No sound playback If you are running under Linux but getting no sound output, the game may be having difficulty autodetecting your audio driver. Support is compiled in for multiple common drivers, and you can set the environment variable SDL_AUDIODRIVER to select your installed audio driver. Please see http://www.libsdl.org/cgi/docwiki.cgi/SDL_5fenvvars for details of the allowed values. Setting the SDL_DSP_NOSELECT variable to 1 may also cure some audio timeout problems. ------------------------------------------------------------------------------- ■ Compiling ○ Basics Our translation of this Trial Edition -- and our subsequent ports to Mac OS X, x86 FreeBSD, and x86 Linux -- were made possible by the GPL'd NScripter clone, ONScripter (http://ogapee.at.infoseek.co.jp/onscripter.html). More specifically, Hanihani Trial Edition utilizes the 20050523 sources, with something like three very minor enhancements (all of which are enclosed inside #if defined(INSANI) ... #endif blocks), each of which takes up an additional line or two of code. They deal mainly with little niceties such as the necessary line to make the window close when you hit the window close button, et cetera. We have also bundled (as default.ttf) the open-source font Sazanami Gothic (http://cvs.sourceforge.jp/cgi-bin/viewcvs.cgi/sqs-xml/sqs-font/sazanami-gothic.ttf), as modified by Haeleth (http://www.haeleth.net/) to strip out embedded bitmaps. We used this particular font because (a) ONScripter demands a font that supports the SHIFT_JIS charset; (b) ONScripter attempts to antialias every font, no matter how small the size is; (c) most SHIFT_JIS fonts (including Sazanami Gothic!) utilize embedded bitmaps below a certain font size; (d) the way ONScripter antialiases fonts, antialiasing embedded bitmaps gives you a very amusing mess that is not playable; (e) the Haeleth-modified Sazanami Gothic does not use embedded bitmaps at any level. As an aside, another open-source SHIFT_JIS capable font that does not use embedded bitmaps at any levels is Mikachan (http://mikachan.sourceforge.jp/). KonatuTT (http://www.masuseki.com/be/konatu.html) is another option, although it's somewhat less clean than Sazanami Gothic and somewhat less pretty (or fruity, depending on who you ask ...) than Mikachan. ○ Dependencies ONScripter requires at minimum: - C++ (gcc 3.3.5+ on *NIX, VC 6.0+ on Windows) - a SHIFT_JIS capable font (like Sazanami Gothic, which we have bundled) - libjpeg-6b - bzip2 (1.0.2+) - SDL (1.2.5+; 1.2.8+ recommended for OS X) - SDL_image (1.2.3+) - SDL_mixer (1.2.5+) - SDL_ttf (2.0.6+) - SMPEG (0.4.4+) - FreeType (2.1.0+) - libogg (1.0+) - libvorbis (1.0+) ○ Compilation Instructions Through the course of this walkthrough, we're assuming that you're using the insani modified sources (available at http://www.insani.org/). First, you're going to want to edit the Makefile for your target OS (Makefile.Win, Makefile.MacOSX, Makefile.Linux, etc) to make sure that you have ENABLE_1BYTE_CHAR, FORCE_1BYTE_CHAR, and INSANI defined. If you're running Windows, you may find the following libraries: - libjpeg-6b - bzip2 - Freetype at the GnuWin32 project (http://gnuwin32.sourceforge.net/). The PyGame (http://www.pygame.org/) dependencies package (http://www.pygame.org/ftp/win32-dependencies.zip) has precompiled binaries for the rest, although these tend to be somewhat outdated -- for most optimal compilation, you may have to compile the SDL series of dependencies from source (http://www.libsdl.org/). If you're running OS X, you may find all the necessary libraries at http://homepage.mac.com/anmira/onscripter/#install -- however, many of these libraries, particularly the base SDL, are out of date. So for most optimal compilation, you may have to compile the dependencies from source. This is particularly important because ONScripter builds with the traditional configure / make system, *not* using OS X frameworks -- so the official binaries from http://www.libsdl.org/ will not work for your purposes. If you're running a variant of *NIX, the build process is simple -- make sure you have all the dependencies installed from the appropriate places (most likely from your distribution; if you're running something like Gentoo or LFS, we're assuming you know where to get the above already, and in fact that you're only reading this readme here for fun :P), head over to the directory where you put the ONScripter sources, then type in # make -f Makefile.Linux and you should be off to the races. If you run into a problem where the font doesn't seem to align vertically well at all, remember that there exist *two* different versions of SDL_ttf -- one that interfaces with FreeType 1.x, one that interfaces with FreeType 2.x. You want the one that interfaces with FreeType 2.x. ○ Mac OS X Packaging While packaging for the rest of the operating systems is beyond the scope of this document, we haven't found any documents online that deal with packaging a traditional configure-make style build into a first-class OS X application, so we'll address it briefly here. Because we are not using the standard OS X framework-style libraries, you are going to have to (a) fall back on UNIX-style shared libraries (which are a pain to install in OS X, but if you're compiling it just for yourself then, well, you've already installed them), or (b) statically compile all the dependencies into the final binary. If using (a), read no further -- there's no point in packaging the final binary into a .app package, as you'd have to get the end user to install all the dependencies on his or her system ... which you can rest assured he or she will not do. That, and you face the icky problem of inducing dependency hell for your user. If using (b), though, this one's an interesting problem for the following reasons: - some libraries, specifically SDL_ttf, SDL_image, libogg, and libvorbis, seem not to want to compile statically no matter what you do. - the version of libbz2 shipped with Mac OS X is different between 10.2, 10.3, and 10.4 -- and on top of that, OS X *only* ships a dynamic library -- meaning that if you want your final binary to be playable on anything other than the version of OS X you're running, you'll need to statically compile that in. We're sure that there's got to be a better way to do this, but in the end, we ended up having to do the following: - move all dylibs from /usr/local/lib to some other place that was not in the library search path temporarily - compile bzip2 1.0.2 from source, find the resultant libbz2.a, and stick it in your compilation directory - edit Makefile.MacOSX to use the static libbz2, as well as the static libogg* and libvorbis* libraries. Also make sure that sdl-config is being fed the argument --static-libs, *not* --libs. - compile and hope that nothing blows up. Once you've got your statically-compiled binary, you're going to have to generate an .app bundle. Now, .app bundles happen to be nothing more than a specific directory layout. http://gimp-app.sourceforge.net has a good example of a "skeleton" .app structure that you are encouraged to download and see. In any case, in (name of .app)/Contents/MacOS you should plop your statically- linked binary. In (name of .app)/Contents/Resources you should plop your customized icns file (you *did* make one, right? If not, shame on you? Don't know *how*, you say? Go to http://www.iheartny.com/howto_01.html and learn!); also make sure to edit Info.plist to your liking (the entries therein are beyond the scope of this document). If you've done everything right, you should have a new, shiny .app bundle. Stick this .app bundle in a directory, dump the nscripter game files that you want to play with into that same directory, double click the .app bundle, and you'll be off to the races. ------------------------------------------------------------------------------- ■ Opening Theme Song The opening theme song -- and its accompanying animation -- is currently freely downloadable from August Soft's site (http://www.august-soft.com/). A translation of the OP sized version of this song follows. 「divergent flow」 作詞:H/de 作曲:Hiroki 編曲:quad 歌: LOOPCUBE feat. 真優 Lyrics: H/de Compose: Hiroki Arrange: quad Vocals: LOOPCUBE feat. mayu 何気ない 通学路に咲く あの白い花のこと 気づいているかな? nanigenai tsuugakuro ni saku ano shiroi hana no koto kidzuite iru kana? Have you noticed that white flower that blooms Unconcerned of anything on the road to school? 繰り返す日々も 歩いてる道も 少しだけ変えてみる その先で何かが kurikaesu hibi mo aruiteru michi mo sukoshi dake kaete miru sono saki de nanika ga Right before I try to change these repeating days And these well-traveled roads just a little, something ... 開く音を見つけ出して 涙より小さいけど 教室の窓から見える 四角い空から飛び出す hiraku oto wo mitsukedashite namida yori chiisai kedo kyoushitsu no mado kara mieru shikakui sora kara tobidasu ... opens up with a noise far more tiny than the fall of tears And flutters down from the sky framed square by the classroom window. 散りばめた星に微笑んだ あの月にもウサギ居るかな? 長い髪風になびかせて 今始まる私たちのストーリーあなたと作ろう chiribameta hoshi ni hohoenda ano tsuki ni mo USAGI iru kana? nagai kami kaze ni nabikasete ima hajimaru watashi-tachi no SUTOORII anata to tsukurou Do you think there might be a bunny up there On that moon who smiled at the lambent stars? Letting our long hair flutter in the wind We'll create our just-beginning story with you! ------------------------------------------------------------------------------- ■ Credits ○ Localization - Translation: Seung "gp32" Park - Translation Padawan: Chris "GSL" St. Louis - Graphic Edits: Seung "gp32" Park - Fontography: Peter "Haeleth" Jolly ○ ONScripter - Original Programming: ogapee [Studio OGA] - 1-Byte Character Patches: Chendo [Mirror Moon] - Additional Programming: Seung "gp32" Park and Edward Keyes - Win32 Build: Seung "gp32" Park - Mac OS X Build: Seung "gp32" Park - Linux Build: Edward Keyes ○ Peer Review and Quality Control - Translation Peer Review, QC (Win32, Linux): Peter "Haeleth" Jolly - Translation Peer Review, QC (Win32, Linux): Florian "emperor" Pfaff [HGTP] - Translation Peer Review, QC (Win32): Jeff "chiisai_nezumi" Chang [HGTP] - Translation Peer Review, QC (Win32): Lee "Clammerz" Massi [insani Australia] - Translation Peer Review, QC (Win32, OS X): zalas [Takeda Honyakubu] ------------------------------------------------------------------------------- For any other questions, please feel free to contact us: irc: #nnl @ irc.zirc.org e-mail: insani-at-INTHEGRIMFUTUREOFHELLOKITTYTHEREISONLYWAR-insani-dot-org homepage: http://www.insani.org/ If you are having technical problems: - Windows: please attach stderr.txt (found in the install directory) to your correspondence. - OS X: please attach the output of the Console to your correspondence. - Linux: please attach any console output to your correspondence.