Difference between revisions of "Troubleshooting guide for MacOSX"

From PSwiki
Jump to navigation Jump to search
m (Update →‎Tips)
Line 4: Line 4:


==Tips==
==Tips==
* Ensure you have created an account on the server. [http://62.173.168.9/register/newaccount.php You can do that here] (RP).
* Ensure you have created an account on the server. [http://209.59.234.149/register/ You can do that here].
* For those who are annoyed when Planeshift pauses whenever it loses focus, here's a quick fix for you:
* 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).
*# Open the file psclient.cfg with TextEdit (it's in <Home directory>/Library/Application Support/Planeshift/psclient.cfg).

Revision as of 16:49, 29 February 2012

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.
  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:

<serverlist>
    <server name="Laanx Server (Main)" ip="209.59.234.149" 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.


For Those Who Know What They Are Doing

Launching Planeshift with Arguments

I (Talad) 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, or dabble in applescript. 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. Download the application: PSClientCMD.jar (2 k)
  2. Move the application into your PlaneShift folder.
  3. Open TextEdit (usually in /Applications). 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 do nothing.
  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 not 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:

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

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! - Talad