   _                  _          ___ _ ___ ___
  | |   ___  ___ _ _ (_)___ ___ ( _ ) / _ \_  )
  | |__/ _ \/ _ \ ' \| / -_|_-< / _ \ \_, // /
  |____\___/\___/_||_|_\___/__/ \___/_|/_//___|
  https://thp.io/2018/loonies8192/

  A Mini Retro Puzzle for DOS, PSP, 3DS, GBA, PSX, Android, NDS,
                          Win32, N800, N9, PocketCHIP, iOS and Vita
                                                           r66 -- 2021-07-09

  This simple puzzle game at some point fit into 8 KiB, hence the name. Since
  then, the focus has shifted to porting and support for various audio synths.

  How to play: There are 2x2-blocks falling down the top, with two different
  colors. Use LEFT/RIGHT/DOWN to move the block and use UP to rotate it. Use
  SPACE to drop the block (it will fall fast until it lands).

  INSTALLATION
  ------------

  DOS: Start LOON8R66.EXE in the same folder that contains LOONIES8.DAT, or
       if using the 32-bit version, simply start LOONXR66.EXE
  3DS: Copy the file to "3ds/Loonies8192/Loonies8192.3dsx" on the SD card,
       creating folders as necessary (optionally also copy Loonies8192.smdh)
  PSP: Copy "EBOOT.PBP" and "PARAM.SFO" to PSP/GAME/Loonies8192 on your
       memory stick, creating folders as necessary (both files are needed)
  GBA: Load the multiboot ROM using gba-link-cable-rom-sender from a Wii or
       GameCube, or load the cartridge ROM with a flash cartridge
  PSX: Burn the CUE/BIN to a CD-R and use it in a modchipped PSX or PS2 or
       play the image directly in your favorite PSX emulator
  NDS: Load the NDS ROM using a flash cart of your choice
  Android: Install from Google Play Store
  Win32: Start the game by running the EXE file
  N800, N9: Install the .deb, then launch via the icon in the menu
  PocketCHIP: Install the .deb, then run "loonies8192" in the Terminal
  iOS: Install from the App Store (once available)
  Vita: Install the .vpk, then launch via the bubble

  For the 3DS, you need to be running the Homebrew Launcher, for the PSP you
  need to install Custom Firmware (CFW). For DOS, you just need a Retro PC
  or DOSBox, PCem or similar emulators that emulate a DOS VGA machine. For
  the GBA, you need a hacked Wii/GameCube, a Gamecube-to-GBA link cable and
  gba-link-cable-rom-sender or (easier) just a GBA flash cartridge. For the
  PSX, you need a modchip or perform the disc swap trick. For the NDS, you
  need a flash cart. The Android version is available on Google Play. The
  Win32 build should work with all recent Windows versions and in Wine. The
  N800, N9 and PocketCHIP ports all come as DEB package. For the PocketCHIP,
  see the included "README.pocket-home" for how to add a game launcher to
  the home screen. The iOS version is being submitted to the App Store. For
  the Vita, you need to be running Henkaku CFW.

  CONTROLS
  --------
                       DOS/WIN32   PSP/PSX/VITA   GBA/NDS/3DS
                       ---------   ------------   -----------
  Left/Right/Up/Down   ARROWS      D-PAD          D-PAD
  Accept/Drop          SPACE       X (CROSS)      A
  Exit/Abort           ESCAPE      START          START

  On touchscreen devices, touch controls can be used. On the PocketCHIP,
  the backspace key (top right on the keyboard) can be used like space.
  On the N800, the D-Pad, D-Pad center and the back button can be used.

  SOUND PACK
  ----------

  By default, Loonies 8192 has synthesized sound built in, but it's possible
  to also use CD-quality audio files. Download the "Loonies 8192 Sound Pack",
  and put the WAV files on an Audio CD (for DOS) or in the game folders for
  PSP and 3DS to upgrade your sound experience to fully sampled 16-bit audio!
  The PSX CUE/BIN already contains CDDA audio (same as the Sound Pack). The
  sound pack can also be used for the Win32 build, just put the .wav files
  in a folder "music" next to the EXE file. The DEB (N800, N9 and PocketCHIP),
  Android iOS and Vita builds already contain the music pack files and default
  to "CD Audio" (MIDI can be selected in the options screen).

  CONFIGURATION
  -------------

  There's in-game help now on how to play the game. You can configure the
  language, soundtrack and difficulty level in the options menu. For DOS, the
  options menu also allows to choose between PC Speaker, OPL-2, MIDI and CDDA.
  For the GBA, DMG (GameBoy) sounds are used by default (this is currently
  the only sound option). For other ports, you can use PC Speaker (beep!)
  or MIDI (using a software-based simple synthesizer) or CD-Audio (if the
  sound pack is installed). OPL-2 is only available in the DOS port for now.

  LOCALIZATION
  ------------

  In addition to the default English language, Loonies 8192 is now localized
  into German and French (thanks, Angie!) -- configurable in the options.

  LEADERBOARDS
  ------------

  There are now local leaderboards (best 3 highscores) as well as global
  leaderboards (using QR codes). When you achieve a local high score, you
  can submit the score online by scanning the QR code with your mobile phone
  and a QR code reader app (some phones have it built into the camera app).

  The N800, N9, Win32, iOS and Vita ports offer to open the submission link in
  a web browser as an option in addition to the QR code for easier submission.


                                             -- thp <thp.io>, July 2021
