=========================
"PIXEL QUEST" SOURCE CODE
=========================

This package contains the following files:

  pixelquest.bat                - Compilation script
  pixelquest.bas                - Game source code
  pixelquest.asm                - Additional routines in Assembly (FZX driver,
                                  Vortex Tracker player, interrupt vector)
  vtplayer_62863.bin            - Vortex Tracker player
  mmcm-*.bin                    - Vortex Tracker songs
  page0*.bin                    - Gallery screens (bitmaps without attributes)
  intro.scr                     - Background intro screen
  pixelquest.fzx                - Main Pixel Quest font in FZX format
  micro.fzx                     - Gameplay board "micro" numbers in FZX format
  board.chr                     - Gameplay board characters in standard 8x8
                                  format
  loader.tap                    - BASIC loader and loading screen


==============
HOW TO COMPILE
==============

First you need to prepare your development environment, according to the
following steps:

1.) Download and install the latest version of Boriel's ZX BASIC (see link
    below);

2.) Download file "pasmo-0.5.4.beta2.zip" from Pasmo page (see link below), then
    extract file content to the same directory;

3.) Download file "ZX7_BorielZXBasicLibrary.zip" from ZX7 page (see link
    below), then extract its content to ZX BASIC directory "dist";

4.) Download file "ZX7_(WindowsExecutable).zip" from ZX7 page (see link below),
    then extract its content to ZX BASIC directory "dist";

5.) Download file "RCS_(WindowsExecutable).zip" from RCS page (see link below),
    then extract its content to ZX BASIC directory "dist";

6.) Download file "joy.zip" from JOY page (see link below), then extract file
    content to the same directory;

7.) Download file "defkey.zip" from DEFKEY page (see link below), then extract
    file content to the same directory;

8.) Download file "FZX_Driver.zip" from FZX page (see link below), then extract
    file content to the same directory;

9.) Edit file "FZXdriver.asm" to delete the following line from the beginning of
    this file:

  org     65000           ; driver address

10.) Extract content of this file "PixelQuest.zip" to ZX BASIC directory "dist".

Afterwards, double-click on file "PixelQuest.bat" to compile this game. If you
have properly followed all instructions above, this will generate a new file
"PixelQuest.tap" in the same directory.


=========
DEV TOOLS
=========

The following tools were used during the development of this game:

  ZX BASIC - by Jose Rodriguez (Boriel)
    http://www.boriel.com/wiki/en/index.php/ZXBasic

  Pasmo - by Julian Albo
    http://pasmo.speccy.org/

  ZX7 - by Einar Saukas
    http://www.worldofspectrum.org/infoseekid.cgi?id=0027996

  RCS - by Einar Saukas
    http://www.worldofspectrum.org/infoseekid.cgi?id=0028048

  JOY - by Einar Saukas
    https://www.dropbox.com/sh/bgtoq6tdwropzzr/AAAknv_0PeJGhn36dLJZfGASa

  DEFKEY - by Einar Saukas
    https://www.dropbox.com/sh/bgtoq6tdwropzzr/AAAknv_0PeJGhn36dLJZfGASa

  FZX - by Andrew Owen & Einar Saukas
    https://www.dropbox.com/sh/bgtoq6tdwropzzr/AAAknv_0PeJGhn36dLJZfGASa

  ZX-Paintbrush - by Claus Jahn
    http://www.zxmodules.de/


=======
CREDITS
=======

Game design, code and graphics by Einar Saukas

Load screen by Craig Stevenson (redballoon)

Music by Sergey Kosov (MmcM), featuring the following tracks:
    - "Ashes of Dreams" (2014)
    - "Classification" (2014)
    - "JaNuAry DaYs" (2015)
    - "Recollection" (2015)
