phpRPG WGDK (Web Game Development Kit)
http://www.phprpg.org/

All Platforms (including Windows, MacOS/X, GNU/Linux, BSD, Darwin, etc.)
===================

phpRPG is installed in the same fashion as most other open source projects:

* Install Apache from either source or from a precompiled server package
  for your distribution. Where we do not support Apache the documentation
  for the project can be found below:

  http://httpd.apache.org/docs/1.3/install.html
  http://httpd.apache.org/docs/1.3/windows.html

* Install the newest PHP from either source or a precompiled server package
  for your distribution.  Where we do not support PHP the documentation for
  the project can be found below:

  http://php.net/install
  http://php.net/install.windows

* Install MySQL from either source or from a precompiled server package for
  your distribution.  Were we do not support MySQL the documentation for the
  project can be found below:

  http://dev.mysql.com/doc/refman/4.1/en/installing.html

* Unpack the phpRPG tar ball or zip to the desired location, setting up any
  virtual hosts that may be needed for Apache.

  http://httpd.apache.org/docs/1.3/vhosts/

* Using your favorite MySQL administration tool, create a database for your
  game you will be running with phpRPG.  No need to populate it, the steps
  to do that will be discussed later in this document.

* Fix your permissions.  First run the file permfix.sh with the group that
  the web server is in.  Your commands should look similar to the following:

    % cd /dir/to/phpRPG
    % sh permfix.sh nobody

  + Note: Not all users will need to run this shell script, only those with
    GNU/Linux, BDSD, and other permissions based file systems that support
    the basic shell (sh) and it's helper programs (chmod & chgrp).

* Read and edit two files found in the ./etc folder where you uncompressed
  the phpRPG archive; runtime.conf.php and db.conf.php.

    - runtime.conf.php contains all the base configuration options.
    - db.conf.php contains the information for your database access.

* Using a web browser point yourself to your publicly viewable web space where
  you will be hosting your game.  In the address bar add /setup to the end and
  walk through the installation of your database using the GUI.
  
  example: http://yourwebserver.com/game/setup/

* Once the database is installed you are free to start using and modifying your
  copy of phpRPG.  As the initial admin you will want to log in with 'admin'
  for the user and password.

  + Note: You may wish to use the user editor popup found in
    [Admin Mode]->[Character Editor] to change the administration password for
    obvious security reasons.