Troubleshooting guide for MacOSX

Welcome to the Troubleshooting Guide for the Mac OSX. Have a seat, a mug of cocoa and relax. You're in good hands!

If there's anything critical we've missed, please tell us in the discussions page - and bear in mind that this page is relatively new!

Tips

• Ensure you have created an account on the server. You can do that here.
• For those who are annoyed when Planeshift pauses whenever it loses focus, here's a quick fix for you:
  1. Open the file psclient.cfg with TextEdit (it's in <Home directory>/Library/Application Support/Planeshift/psclient.cfg).
  2. Append the following line to the end of the file:
     System.RunWhenNotFocused = true
  3. Save and close. Play Planeshift.
• 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.

Troubleshooting

Updater lacks Permissions

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

A : First, ensure you've installed it corectly (see Installation, below) and that you're not trying to run the game nor its updater off the downloaded .dmg. The applications must be run off your Hard Drive.

Second, right-click on both psclient and pslaunch, select "get info". Check the bottom part of the dialogue(s) that appear and, under "Sharing & Permissions" make sure that both Admin and yourself can 'read & write'. If not, change it so you can (you may need an Admin password). Close and try to update again.

If that still does not work, close all applications (except Finder, obviously) and then go to Utilities (subfolder of Applications) and double-click "Disk Utility". Select your system hard-drive from the left-hand side, and then press "Repair Disk Permissions". This will set all permissions back to what OSX thinks they should be. Once complete, you may need to repeat the "Second, right-click..." step above.

If it still doesn't work, seek further help.

Server Unreachable

If you are having trouble getting onto the server (i.e. "Server unreachable") then please follow the following steps:

1. Ensure that you are connected to the internet (just to be on the safe side ;) ).
2. Ensure you're connecting to the right server.
   • As of 11th December 2011, the Non-RP server Ezpcusa is offline due to lack of use.
   • In February 2012, PlaneShift relocated its main server from Zero Ping to Subhosting.net.
   • In June 2013, PlaneShift relocated its main server from Subhosting.net to Teamix GmbH.
3. Ensure that the server is up: go here and look at the Stats on the left side of the screen. If the number of Total Online is 0 (or there is no number listed) or if the Report Time is more than a minute or so different from the Time, then the server is down and you will be unable to connect. Try again in a few minutes.
4. 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 (politely) ask your network administrator to open port 7777 for incoming traffic.
5. If it still won't work, open your Planeshift folder, open the "data" folder, and open "servers.xml" (/Applications/PlaneShift/data/servers.xml) in TextEdit (click on servers.xml and drag it to /Applications/TextEdit(.app) ). Ensure that the port for the server is set to 7777 (if not, change it).

It should end up looking something like this (there may be a description as well):

<serverlist>
    <server name="Laanx Server (Main)" ip="planeshift.teamix.org" port="7777"/>
</serverlist>

Still stuck?

• For some basic fixes and known bugs, see this thread.
• If you're having trouble on an old Mac with OS 10.4.x (Tiger), take a look at thread.
• For help applying basic fixes and other utilities, please visit this site.
• 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.

See you all in Yliakum!

Guide to installing PlaneShift on Mac OSX

You are advised to use the Torrent Download as this places less strain on the Servers. This does however require a torrent tracker. If you do not have one, there is one available for download just above the torrent links. Alternatively you may use the direct link.

Using the Torrent Link

1. Go to the Download page (it may help to ctrl-click and open this in a new tab)
2. Scroll a little way down to the uTorrent links
3. Click on PlaneShift-v0.5.8.dmg torrent and download.
4. Once downloaded, open the file PlaneShift-v0.5.8.dmg.torrent in your favourite torrent Tracker.
5. Begin the Torrent
6. If you have not done so already, this would be an excellent time to create your user account on the server. (see Tips)
7. Once the torrent has completed, you should now have a file called PlaneShift-v0.5.8.dmg
8. Follow the 'installation' instructions below

Using the Direct Link

1. Go to the Direct Download links. (it may help to ctrl-click and open this in a new tab)
2. Choose your link, and download (about 1GB of data).
3. If you have not done so already, this would be an excellent time to create your user account on the server. (see Tips)
4. Once downloaded you should now have a file called PlaneShift-v0.5.8.dmg
5. Follow the 'installation' instructions below

Installing the Game

1. Double-click the file PlaneShift-v0.5.8.dmg (if you downloaded the direct link with Safari, it may have already opened)
2. Select the folder inside entitled Planeshift
3. Drag it to your Applications folder.
4. Once transferred, open the folder you just moved and double-click pslaunch(.app).
5. The game should now update itself, synching with the server. This may take some time.
6. Once the game has updated, close the updater and double-click psclient(.app)
7. Enjoy! Any problems, please see troubleshooting.

Launching Planeshift with Arguments from Terminal

Go under Applications and find the "Terminal" program, launch it, a window will open.

If you are confused about using terminal read this: http://blog.teamtreehouse.com/introduction-to-the-mac-os-x-command-line

In the terminal type:

 cd /Applications/PlaneShift

As a response you will get something like:

 luca-MacBook-Pro:Planeshift luca$

This means you (luca) are now in the folder called PlaneShift. This is the main PlaneShift directory. From here you can launch the launcher without UI, so it's safer:

 ./pslaunch.app/Contents/MacOS/pslaunch_static -console

And you can also launch the client with the console, to print a lot more information to detect errors:

 ./psclient.app/Contents/MacOS/psclient_static -console

If you have problem with the client, then copy all the text you get by the last command, and put it on forums asking for help.

If you get a "No such file or directory" as a response of the commands above, means you have typed the command wrong or PlaneShift is installed in another place. Remember the text above is case-sensitive, so watch upper/lower case. Best way is to copy it from here to the terminal with "command+c" and "command+p"

If for some reason you cannot copy the text execute this command:

 ./psclient.app/Contents/MacOS/psclient_static -console > ~/Documents/logfile.txt

This will create a file with the text in Documents folder. Consider that it may not create the file in your user document folder but on the main document folder under the hard drive. Also before sending the file consider there may be your name in the text.

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!