Troubleshooting guide for MacOSX

PLEASE HELP US TO IMPROVE THIS GUIDE!!

Frequent Question 1: When Trying to launch the game the picture with the arcane magic comes up and then the bar fills and then it freezes up. So wI went into the updater and it says "an update is available but I don't have the correct permissions to continue"

Answer 1: Ok, I assume you've downloaded the file from the website- it should say PlaneShift-v0.5.7.dmg, then you've clicked that and it expands into a white hard drive-looking icon that just says PlaneShift, and inside is a folder that says PlaneShift. You need to drag that entire folder into your main Applications folder (the one that looks like an 'A' made out of pencils when you open a new finder window)

Now, the client probably needs updating, so you'll need to run 'pslaunch' which is the updater. If you're still getting a permissions error, then try to change the permissions of both 'psclient' and 'pslaunch.' To do that, right-click on each and select 'get info.' At the bottom of the box it should say 'sharing and permissions.' Open that, and switch the privilege of both yourself and admin to 'read and write.'

If that still doesn't work, try turning every application off, and opening "Disk Utility" (which is found inside Utilities inside the Applications). Click on your hard drive at the left, then click 'repair disk permissions.' That will reset all permissions to what the computer thinks should be the correct settings.

You may need to re-open the 'get info' for 'pslaunch' and 'psclient' and repeat setting the permissions there.

If none of that helps... then sorry, you'll have to ask someone more knowledgable.

---

Guide to run PlaneShift on Mac OSX

1. Download the latest full release from the PlaneShift main site (I suggest you use the BitTorrent download) and unzip the ZIP archive by double-clicking on it (note the archive may unzip automatically if you download it directly from a mirror with Safari): [url=http://www.planeshift.it/download.html][Color=Blue]PlaneShift SB Download Page[/color][/url]

2. Run the enclosed file PlaneShift-v0.4.03.app). Follow the on-screen instructions to complete the installation.

3. Use the built-in updater to get the latest files: Double-click the file updater(.app) in your Planeshift 3D folder. Once it finishes launching, click "Update," sit back and relax (you're in for a pretty long wait at times).

4. Double-click pssetup(.app) to modify your settings and then psclient(.app) and play.

For some basic fixes and known bugs, see [url=http://www.hydlaaplaza.com/smf/index.php?topic=34250.0]this thread[/url]. If you're having trouble on an old Mac with OS 10.4.x (Tiger), take a look at [url=http://www.hydlaaplaza.com/smf/index.php?topic=32477.0]this thread[/url]. For help applying basic fixes and other utilities, please visit [url=http://planeshift.caarrie.org/]this site[/url].

If you have a MacBook running Leopard [10.5] AND you have an intel GMA 3100 graphics card and you have issues loading some maps, make sure texture downsampling is at 1/2 or further to the right.

IMPORTANT1: For some people, Planeshift only works if you are the primary administrator. The reason for this is not entirely understood. If you're having problems, try logging in as the primary admin if possible.

IMPORTANT2: if you are having trouble getting onto the server (i.e. "Server unreachable", please follow the following steps: 1. Ensure that you are connected to the internet (just to be on the safe side ;) ). 2. Ensure that the server is up: go to [url=http://laanx.fragnetics.com]http://laanx.fragnetics.com[/url] and look at the report on the left side of the screen. If the number of user accounts is 0 (or there is no number listed) or if the [b]Report Time[/b] is more than a minute or so different from the [b]Time[/b], the server is down and you will be unable to connect. 3. Ensure that you are not behind a hardware or software firewall, or, if you are, that you have allowed incoming traffic on port 7777. Note that if you are on a college campus, school campus, or at an office, you will probably be behind a firewall; if you are, your only option is to ask your network administrator to open port 7777 for incoming traffic. 4. If it still won't work, open your Planeshift folder, open the "data" folder, and open "server.xml" (/Applications/PlaneShift/data/servers.xml) in TextEdit (click on servers.xml and drag it to /Applications/TextEdit(.app) ). Ensure that the port for server "Fragnetics" and/or "Ezpcusa" is set to 7777 (if not, change it). It should end up something like this: [code]<serverlist> <server name="Fragnetics (RP)" ip="laanx.fragnetics.com" port="7777"/> <server name="Ezpcusa (Non-RP)" ip="planeshift.ezpcusa.com" port="7777"/> </serverlist> [/code]

See you all in Yliakum!

P.S. Make sure to [url=http://laanx.fragnetics.com/register/]create an account on Fragnetics[/url] and/or at [url=http://planeshift.ezpcusa.com/register]create one on Ezpcusa[/url]!

P.P.S. For those who are annoyed when Planeshift pauses whenever it loses focus, here's a quick fix for you: Open the file psclient.cfg with TextEdit (it's in <Home directory>/Library/Application Support/Planeshift/psclient.cfg). Append the following line to the end of the file: "System.RunWhenNotFocused = true" Save and close. Play Planeshift.

P.P.P.S. Those who want to launch Planeshift with an extra command or option, read the following:

I have brought back PSClientCMD to help Planeshifters that would like to run Planeshift with special arguments but don't want to launch it from the command line. There is basically a two-step setup procedure which I've elongated to six steps to make it easy for anyone to use.

The steps required to use PSClientCMD are as follows: 1. Downlaod the application: [url=http://www.world-of-cha0s.hostrocket.com/PSUpdater/PSClientCMD.jar][Color=Blue]PSClientCMD.jar (2 k)[/color][/url]

2. Move the application into your PlaneShift folder.

3. Open TextEdit (/Applications/TextEdit(.app)). Create a new document if one is not already open (from the "File" menu, select "New"). Pull down the "Format" menu. If the option "Make Plain Text" is available, select it. If the option instead reads "Make Rich Text" then [u][b]do nothing[/b][/u].

4. Type any arguments you want to send to PlaneShift when it runs. Include a dash ("-") before each argument and separate each argument with a space (" "). Do [u][b]not[/b][/u] enclose the arguments in quotes. All the arguments must be on one line (line wrapping is ok; just don't press the return or enter key).

5. Save the file in your Planeshift folder as "PSClientCMDlist.txt" (a plain text document). This exact name must be used.

6. Double-click "PSClientCMD.jar" whenever you want to run PlaneShift. The arguments will be passed when the client launches.

You can get a list of available arguments by running psclient with "-help" as an argument. Note that this list is not exhaustive: some options exist that are not listed. I've copied the current list here: [code]Options for MacOS X 2D graphics drivers:

 -screen=<num>      Screen number to display on (default=0)

Options for Crystal Space 2D driver for MacOS/X (OpenGL):

 -depth=<val>       Display depth (32)
 -[no]fs            Fullscreen if available (no) 
 -mode=<val>        Window size or resolution (1280x854)

Options for Crystal Space 3D Engine:

 -fov=<val>         Field of Vision (0)
 -renderloop=<val>  Override the default render loop ()

General options:

 -help              this help
 -video=<a>         the 3D rendering driver (opengl, software, ...)
 -canvas=<a>        the 2D canvas driver (asciiart, x2d, ...)
 -plugin=<a>        load the plugin after all others
 -verbose           be more verbose; print better diagnostic messages

[/code]

[b] Many many thanks to everyone who has helped me with this guide. It's only as useful as it is thanks to your ideas and suggestions! [/b]