How To Install OpenRPG

If you don't want to contribute you should go for the player's way.
Windows developers and/or hackers must follow the latter.

The player's way (Windows)

Simply donwload the installer and it should setup all for you (dependencies included)!

The hacker's way

1. The dependencies

   First of all install the dependencies, if you don't already have them.

   1. Python 2.5.1 or better, but not 2.6

      I am not sure if Python 2.6 works with OpenRPG so I suggest you get a copy of Python 2.5. You can get this at python.org/download but it might be easier to use the links here and you can get wxPython via those links too.
      I suggest you to append to your PATH environment variable the path to where you just installed python (e.g. C:\Python25) and to the Scripts dir (e.g. C:\Python25\Scripts). This will allow you to call the python interpreter and all the scripts filed under the Scripts dir directly from the cmd.exe just typing "python" or the script name. You can also append to your PATHEXT environment variable the .PY extension, so you don't even need to type the extension when calling a python script from the console.

      To check if all has gone fine, open a console window and type:

      C:\>python
      Python 2.5.1 (r251:54863, Apr 18 2007, 08:51:08) [MSC v.1310 32 bit (Intel)] on win32
      Type "help", "copyright", "credits" or "license" for more information.
      >>>

   2. WxPython 2.8.1 through 2.8.7

      You might be able to find an old version of wxPython from their home site but I suggest using the links here.
      Then type in a new instance of the python interpreter:

      >>> import wx

      If you don't see any ImportError it's all right.

   3. Mercurial

      Download it from www.selenic.com/mercurial.
      I also put a windows binary installer for python 2.5.1, compiled with mingw32, in the Files tab. If you try it let me know if it worked posting a comment here. Now open your terminal and type (Note: If you used my installer or you compiled manually the source code of mercurial this won't work unless you added your Scripts dir to your PATH and you enabled the .PY extension.):

      C:\>hg</pre>
      You should see a list of commands ... you are now ready to install !OpenRPG!
      

2. Now OpenRPG!

   Once you successfully installted all the dependencies you can proceed installing OpenRPG.
   

   Get the code

   To do it, clone the project's repo with mercurial:

   C:\SRC>hg clone http://hg.assembla.com/openrpg
   destination directory: openrpg
   requesting all changes
   adding changesets
   adding manifests
   adding file changes
   added 41 changesets with 504 changes to 463 files
   updating working directory
   463 files updated, 0 files merged, 0 files removed, 0 files unresolved
   
   C:\SRC>
   

   (This is the output I got on my local machine.)

   Setup the Environment

   Before starting to use openrpg you have to set two environment vars on your system. They are:
   • HG with value hg
   • OPENRPG_BASE with value the path to where you just cloned the repo (C:\SRC\openrpg in my case)

   Finished!

   You can then cd to openrpg and start hacking!