Warcraft for the GP2X
Version beta 3

Installation
------------

Warcraft version 1.21 required for installation (Floppy or CD version)

Simple instructions:
1) install Warcraft on your PC (using DOSBox for instance)
2) copy the files from this archive into the install directory
3) copy it all onto SD card
4) run Warcraft.gpe on GP2X

Example (Detailed instructions):
1) install Warcraft on your PC (using DOSBox for instance)
    - create directory C:\Games
    - in dosbox: mount C:\Games as C:
    - in dosbox: install Warcraft into C:\WARCRAFT

2) copy the files from this archive into the install directory
    - copy files from this archive (Warcraft.gpe, CP850.F08, Warcraft.cfg) to C:\Games\WARCRAFT
    - if you have Floppy version, then copy file Floppy\SR-War.exe to C:\Games\WARCRAFT
    - if you have CD version, then copy file CD\SR-War.exe to C:\Games\WARCRAFT

   FOR CLARIFICATION:
   See Example\List-Floppy.txt - list of files (after installation) - Floppy version
   See Example\List-CD.txt - list of files (after installation) - CD version

3) copy it all onto SD card
    - copy the directory C:\Games\WARCRAFT onto SD card

4) run Warcraft.gpe on GP2X


Music
-------------
To get music you will need to install the timidity instruments by downloading
http://www.libsdl.org/projects/SDL_mixer/timidity/timidity.tar.gz
and either:
a) Extract it to the root of your SD card.
or
b) Extract it elsewhere on your SD card.
Then copy timidity.cfg to the UFO directory and add this line at the start
dir /mnt/sd/path/to/timidity/
where path/to/timidity/ is the path to the timidity directory on your SD card.
You can use different timidity instruments, but these were the only ones tested.


Configuration
-------------

Warcraft for GP2X can be configured with configuration file (Warcraft.cfg) placed in the main directory (the directory where Warcraft.gpe is located).


Controls
--------

In game:

Mouse mode:
Stick: move mouse
R+Stick: move mouse - double speed

Keyboard mode:
L+Stick: up/down/left/right arrow

Both modes:
Y: left mouse click   [configurable]
X: right mouse click   [configurable]
A: m   [configurable]
B: a   [configurable]
Select: f1   [configurable]

R+Y: enter   [configurable]
R+X: esc   [configurable]
R+A: s   [configurable]
R+B: backspace   [configurable]
R+Select: virtual keyboard   [configurable]

Vol +: volume up   [configurable]
Vol -: volume down   [configurable]
R+Vol +: f8   [configurable]
R+Vol -: f5   [configurable]

Start: pause/unpause game
L+R+Start: immediate exit (without saving anything)

Virtual keyboard:
Stick: move
Y: select   [configurable]
L+R+Start: immediate exit (without saving anything)


Misc
----

multiplayer does not work (and it's not planned to make it work)


Changes
-------

beta 3 (2009-05-31)
* minor bug fixes
* speed optimizations
+ separate executables for Floppy and CD versions 


beta 2 (2009-04-03)
* insert delays into victory screen
+ new action for button mapping: macro for key followed by left mouse click (e.g. one-click move/attack/...)
+ new action for button mapping: combination left mouse click/select group (acts like left mouse button, when mouse is moved during click, switches to select group)
* fixed playing music at startup


beta 1 (2009-03-26)
first public version
