Read Me

Shopping-ManaJer Milestone 4:

---COPYRIGHT AND LICENCE
Shoppingmanager (c) Thomas Kamps, 2006/2007
Alls files in this package: (c) Shopping-ManaJer-Development-Team, 2006/2007

Except:
payed.wav (original KDE_beep_connected.wav) out of KDE 3.5.3
shelfcrash.wav (original Menu_Item_Selected_Sound_0.wav) out of freedroidRPG

Shopping-ManaJer is published under GPL v2
See "conying.txt" for more information

----WARNING
Using the scrips and the game on your own risk.
It should not happen, but there is a very very little risk, that your system takes damage, or that your computer even explodes. Any other damage is also possible.
The game has been testet, the scipts also have been testet on Linux 2.6 and Win32 systems. No damage is arised and no computer exploded.

If you have the source-only package you have to compile it before using it.
If you have the binary package, you may compile it, but this is not needed.

----SYSTEM REQUIEMENTS
All systems:
CPU: 400Mhz
RAM: 32MB free ram
HD: 2MB
Input: Mouse and Keyboard
Screen resolution: 1024x768 or hiher recommendet
Color-depth: 16bit or higher recommendet
Java: Sun JRE or JDK 1.5(For Source-only packages) or higher

*NIX:
  Xfree 4.3 or higher, or Xorg 6.8 or higher. The game was sucessfully testet on Xgl
Win32/64:
  Alls Win32/64 systems should have a graphical user-interface natively

----COMPILING (NOT NEEDED IN THE BINARY-PACKAGE)
If you wish to compile the sources you need the Sun JDK 1.5 avialbe at the Sun Homepage:
On *NIX systems type "./compile.sh"
On Win32/64 systems execute the "compile.bat"
Note for Win32/64 users:
The installer of the JDK does not add the path to the javac.exe to the PATH variable.
You have to add the directory where the javac.exe is placed to the PATH varible to be 
able to compile the package.

Compiling is not needed in the binary package.

----INSTALLING
To install the game into your system type:
On *NIX systems type "./install" as root.
    the script will copy all files to /usr/share/games/shoppingmanajer
    A symbolik link to /usr/share/games/shoppingmanajer/shoppingmanajer.sh will be created to
    /usr/games/shoppingmanajer
On Win32/64 systems execute the install.bat
    The script will copy all files to "C:\Programs\ShoppingmanaJer"

----RUNNING THE GAME
If you installed the game to your system:
On *NIX systems: just type "shoppingmanajer" from any directory
On Win32/64 system execute the "C:\Programs\ShoppingManaJer\shoppingmanajer.bat"

If you dont want to install it, got to the directory, where this file (README.txt) is found:
On *NIX systems type: "./shoppingmanajer.sh local"
On Win32/64 systems type: "shoppingmanajer.bat"

----CHANGING LANGUAGE AND TEXTURE-PACK
Start the game. Click on Options. Then a window with two Comboboxes opens. The left one is for the texture-pack and the right one is for the language.
Aviable texture-packs and languages will be added to the combo-boxes automatically.
Just choose the wished language and textutre-pack.
After that click on "Save" to save your options.
--
Aviable languages can be found in res/languages.
All files starts with "lang_".
--
Aviable texture-packs can be found in res/textures

----WHERE SHOPPING-MANAJER SAVES HIS STUFF
On 'NIX systems the savegames and the options are stores in the directory ".shoppingman" that is created in the users home-directory 
On Win32/64 systems the same directory is used.

----HELPING US
If you want to help developing ask the developers. You will find the contact-information in the impressum of the homepage
http://shoppingman.sourceforge.net

We need:
-Persons who makes graphics
-Persons who will make some music for M4
-Testers
-Translators
-ect.

----HOW TO REPORT BUGS AND CRASHS
If you occour a game chrash, save the current game and send it with the console-output to tkamps@gmx.de
On other Bugs please send a detailes description how to reproduce it (eg. a savegame) to tkamps@gmx.de