• Guide to installing OpenRPG on Mac OSX

Install using Fink

These are alternative instructions for getting OpenRPG to work on Macintosh OS X. Yes, it is quite a process, but if you're in to online RPG games and all your friends are using, it will be worth it.

I am running Mac OS 10.2

Additionally, I have tested this for a few days now and while not everything works like it's supposed to, these are simply minor inconveniences. Overall, it functions great.

Heimdall: These are basically the directions you had previously for ORPG and FINK, but I added a few more steps and I added a lot more explanation and some links. I am an amatuer coder, so please correct me if I'm abusing the lingo, and I will edit the post.

If anyone else is willing to try this, please post your success/failure. I will do what I can to help you.

1) Get and Install Apple Developer Tools: https://connect.apple.com . This is a hefty download, but if you upgraded from OS 9 to 10.2 then you should have received an extra CD that contains the Developer Tools on it. You can also have the CD shipped to you. Either way, you must register at the apple devel site to get it. You will know if you have this on your machine, if you look in the HD directory and see a directory named "Devel." This takes some time to install, if I remember correctly.

Also this will install a version of Python. I don't know if it matters or not, but I deleted mine before I installed the Fink Python. Just search for Python and delete any folders that have that name.

If you've been trying to get OpenRPG to work, then you've probably downloaded and tried to install various Python and wxPython programs. I recommend deleting those (you can hold on to the zip files if you like) before starting step 6.

2) Install Apple X11 and the Apple X11 SDK. http://www.apple.com/macosx/x11/ This is, I believe, Mac's answer to wxWindows.

3) Install the Fink system: While using Fink, you may be asked various Y/N questions. In most cases, you want to choose the default answer by hitting return. Despite being a command prompt controlled software, it is very user friendly.

For amateur hacks like me: Fink is a set of tools that have been ported from Unix/Linux systems. This means that Fink will install various software packages on your system that will make your Mac to behave more like these operating systems. You pick which packages you want to install; you do not need to get all of them. In short, this will allow you to take advantage of Open Source projects that have been developed for Unix based machines which use these programs. Open Source projects (like Fink and OpenRPG) are software programs that are developed and distributed for free. I guess hardcore programmers are just nice people? Welcome to the software underground.

For amateur hacks like me: there are two ways of getting your software packages. You can get the point release or with CVS updating you can get the latest build. Ok, ok, in normal speak, this means: you can get the version that is tested to work or you can get the latest version that is still being developed and tested. You do not need CVS updating to get OpenRPG to work, so I would caution against it, since some of the latest CVS builds may have problems that are currently being worked through. FYI- Fink creates and installs into the sw directory.

If you've looked at the Fink quick start guide, you'll know that on install, Fink should start a Terminal window as ask you a few questions that will set up your path. You should be ok, if you choose the default answers. If this doesn't happen there is a way to start it manually. Go here for more details: http://fink.sourceforge.net/download/index.php but do not execute "dselect" as outlined in the Fink quick start guide.

4) More Fink setup: In order to get wxPython you must edit /sw/etc/fink.conf to include another branch listing, actually, two. You will append "unstable/main unstable/crypto" to the end of the third line in the file, or the line that starts with "Trees:".

To do this you may have to log in as root user (I did). DO NOT ACTIVATE THE ROOT USER (if all you're going to use it for is this install). There is a command in the shell (Terminal or X11) called 'sudo' that lets you do one action as root as long as you know an administrator user's password (the default user created with OSX should be an administrator). So, to edit the fink.conf file, type on a command line: sudo vi /sw/etc/fink.conf Substitute your favorite editor with 'vi'.

5) Fink setup, continued: Now to use Fink, you must be in the command terminal. To start it, go to applications/utilities/terminal. Inside the terminal type: "fink index"

If you've been trying to get OpenRPG to work, then you've probably downloaded and tried to install various Python and wxPython programs. I recommend deleting those (you can hold on to the zip files if you like) before starting the next step.

6) Fink and X11 hook-up: Type: "fink install system-free86" (this may take while. Also, I'm not positive, but I think you may need to be connected to the internet for all fink install operations. Sometimes Fink must download stuff before it call install it.)

7) Almost there: Type "fink install python2.2 wxpython-py22" (this will probably take a long while. Fink must install the dependencies for python and wxpython. This means that there are maybe 20 other programs that Fink must install because python and wxpython use them and hence, are dependent. I don't know how long; I set this to run before I went to bed.)

8) Install OpenRPG!!!: ok, you're so close now. Unzip the file, and move the directory somewhere inside your Home folder as it will be easier to get to this way. I put mine in the applications folder, but I don't see why you couldn't put it in the main directory of the Home folder.

9) It's do or die now, so cross your fingers: Open the X11 terminal (should be in the main app folder), at the command prompt you will want to navigate to the OpenRPG folder. For those unfamiliar with the command prompt, you must use Unix commands (a quick search on google will provide you with plenty of basic guides). Since I put mine in the applications folder, I can get there by typing "cd applications/openrpg1/". Once you are in the right folder, type "python2.2 start.py"

Last edited by Versible on 09-27-2003 at 04:05 PM

Install using Macho Python

OpenRPG User Guide: Macintosh Installations Written By: Pugio il Audacio

There are two ways you can install OpenRPG on a Macintosh.

• Step 1.

You need to install the Python framework. The latest version can be downloaded at: http://ftp.cwi.nl/jack/python/mac/MacPython-OSX-2.3-1.dmg (this is as of 09-15-03). You can also check to see if there is a newer version at: http://homepages.cwi.nl/~jack/macpython/download.html.

Once you've downloaded it, double click on the MacPython-OSX.pkg and follow the installation instructions. Note: You'll need an administrator password to install this.

Step 2. Now you need to install the graphics add-on to Python: wxPython. Download this at http://aleron.dl.sourceforge.net/sourceforge/wxpython/wxPythonOSX-2.4.1.2-py2.3.dmg. To check for later versions go to http://wxpython.org/download.php and go down to the Mac OS X section of the page.

Once downloaded, click on the wxPythonOSX.pkg , not the wxPythonOSX-devel.pkg (this is the dev version). Note: You'll need an administrator password to install this.

Step 3. Now that you have all the required files, it's time to get OpenRPG itself. Download this from http://openrpg.wrathof.com/OpenRPGd.zip. This is a development version, and is the only known version that allows Miniature use with a Macintosh.

Step 4. Now you're gonna need to disable some pieces of code. You do this by opening up the file and putting a '#' at the beginning of the line.

Open up the chatwnd.py file (in /openrpg1/orpg/chat/) in a plain text editor. Textedit (in your Applications folder) works perfectly. Note: Do no use Microsoft word as it saves it in a different format. Now put a '#' in front of these lines in the file:

self.scroll_lock = wxToggleButton( self, SLOCK, "Scroll ON",size=wxSize(70,25)) self.toolbar_sizer.Add(self.scroll_lock,0,wxEXPAND) EVT_TOGGLEBUTTON(self, SLOCK,self.lock_scroll)

For users who do not want to edit files themselves, download this file and copy it over the one in your current directory.

To quickly find these lines hit command-F to bring up the find window. Then just copy these lines into field and click next. When you're done, save the file.

Modify the /orpg/systempath.py file. Change any references to "python2.2" to "python2.3". This will fix some window issues.

Step 5. Now you'll need to tell your computer where to access python scripts.

Open up the Terminal program (found in /Applications/Utilities/Terminal). Enter the following code after the '% prompt:

% vi .cshrc (Note: There's a period in front of cshrc, don't forget it!) % setenv PATH /usr/local/bin:{$PATH} Hit Escape at this point. % :wq

Now log back out and back in to initialize the path.

Step 6. Finally, you need to start the program up. Open up the Terminal program. Type these commands after the prompt: % cd /The/path/to/the/OpenRPG/folder

for example:

cd ~/documents/openrpg1/ (Note: The '~' at the beginning stands for '/users/yourUserName')

You should see the path to the folder displayed to the left of the prompt.

Now you need to type:

pythonw2.3 start.py

That's all there is. If you did everything correctly OpenRPG should start up. For easy startup of OpenRPG. Use this shell script. Just open it up in a text editor and change the path to wherever you keep your program.

Author's Note: If the chat window scrolls up and down wildly, try typing "/lines 25". That will limit the number of chat lines displayed. Play around until you find a line length that fits.

Editor's Note: For another way to install OpenRPG for Macintoshes using Fink, click here.