Troubleshooting guide for Linux

From PSwiki
Jump to navigation Jump to search

Requesting help from the PlaneShift forums

If you still have a problem after reading this document, then please post a message on the PlaneShift forums.

Please copy and paste the following text into your forum post, adding your details under each heading:


Operating System (Linux, MacOS, Windows XP, Vista, etc):


Graphics card (nVidia foo, ATI bar, Intel abc, etc):


The problem is:


Problems before entering the game

Installation

If you need advice before or while installing PlaneShift, then join the PlaneShift IRC channel.

Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/IRC



Permissions

You may have to set permissions on the downloaded installation file so it will run. Do this from a command prompt, from the directory where you downloaded the installation file.

Assuming the downloaded file is in a directory called: Downloads which is in your home directory, type:

cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run

This chmod command will make the file readable, writeable and executable to you only.

Then, to run the installation program, assuming you still have the same command prompt open:

./PlaneShift-vn.n.n-x86.run

replace: PlaneShift-vn.n.n-x86.run

with the actual file name, n.n.n-x86 will need to be changed.



To start PlaneShift from a Linux command line

If PlaneShift is installed in your home directory:

~/PlaneShift/psclient

or

~/PlaneShift/pslaunch

If these files don't run, then they may need permissions to be set. If PlaneShift is installed in your home directory:

chmod 700 ~/PlaneShift/psclient
chmod 700 ~/PlaneShift/pslaunch

These chmod commands will make the files readable, writeable and executable to you only.

If it still doesn't start it may be you got the wrong version of the client (32 bit instead of 64 bits). You need to download the version which is compatible with your system.

Use :

 uname -a

and see if there is a x64 mentioned in the resulting string. If there is then you are on a 64 bit operating system.




To update PlaneShift from a Linux command line

If PlaneShift is installed in your home directory:

~/PlaneShift/pslaunch --console

If the updater fails with errors such as:

Unable to get root node! Segmentation fault

Edit: updateservers.xml and updaterinfo.xml

(found in your PlaneShift directory) so that the <mirrors> tag looks like this:

<mirrors>
      <mirror id="1" name="server1" url="http://194.116.72.94/update/" />
</mirrors>

and try to update again.



Graphics card drivers

Ubuntu, Kubuntu, Xubuntu, etc, will install or offer to install the latest stable version of your graphics card driver for you.

If you are using a different Linux distribution and it does not automatically install an optimised driver for your graphics card then you can install one manually.

NVIDIA: http://www.nvidia.com/content/drivers/drivers.asp

AMD/ATI: http://support.amd.com/us/gpudownload/Pages/index.aspx

Intel: http://www.intel.com/p/en_UK/support/graphics/

Each of these web sites have Linux drivers for their laptop and desktop computers' graphics cards. Documentation regarding their installation will be included with the driver.



Game crashes after upgrading to 0.5.9

Edit ~/.PlaneShift/planeshift.cfg

add this line:

Video.OpenGL.UseExtension.GL_ARB_shader_objects = false


Black or grey screens

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

~/PlaneShift/pslaunch

From the PlaneShift Launcher click: Settings then Graphics

Unselect the check box: Enable VBO

Click: OK


This suggests your graphics card is not adequate for running PlaneShift.

If the PlaneShift application just exits when creating a character for the first time, this is another symptom of an insufficient Graphics Processing Unit.



No audio

This message may be displayed when you start PlaneShift:

could not load plugin 'crystalspace.sndsys.renderer.null'

Start the PlaneShift Launcher. If PlaneShift is installed in your home directory:

~/PlaneShift/pslaunch

Click the Settings button.

From the Settings screen click: Audio

Select: Enable sound

Set Sound Renderer to: OpenAl



Unable to connect to server

1. The following page will inform you whether the game server is accessible.

http://planeshift.teamix.org/index.php

Check the Stats box for server status.

If the Total online is: 0, this probably means administrators are updating software on the game server.


2. If you have a firewall then you need to know that PlaneShift requires the outbound port: 7777

Then try to connect again.


3. Run the updater:

If PlaneShift is installed in your home directory:

~/PlaneShift/pslaunch --console

Updating may take a few minutes.

Then try to connect again.


4. Edit servers.xml manually and replace planeshift.zeroping.it or planeshift.subhosting.net with planeshift.teamix.org

If PlaneShift is installed in your home directory then servers.xml will be located here:

~/PlaneShift/data/servers.xml

Then try to connect again.



Full screen mode crashes the client

Unfortunately full screen mode does not currently work reliably. It is recommended that you do not use full screen mode.

To turn off full screen mode:

Start the PlaneShift Launcher. If PlaneShift is installed in your home directory:

~/PlaneShift/pslaunch

Click Settings

Unselect Enable Fullscreen

Click: OK

In game bugs (after loading world)

Performance

1. Run the updater to ensure the PlaneShift software has the latest bug fixes installed.

2. Update your graphics card drivers.

3. Set your desktop colour depth to 24 or 32 bit, sometimes called 'true colour'.


Then start the PlaneShift Launcher. If PlaneShift is installed in your home directory:

~/PlaneShift/pslaunch

Click Settings then Graphics.

Set Colour depth to: 32


4. Enable Adaptive Distance.

Start PlaneShift, log in. Then from the game's tool bar, click the Options button.

From the Options window, under the Graphics item, click Details.

Select the Adaptive distance check box.

Click: Save


5. Texture down sampling.

Edit: PlaneShift/psclient.cfg

and change:

Video.OpenGL.TextureDownsample = 0

to

Video.OpenGL.TextureDownsample = 4


6. Turn off: Background loading

Start the PlaneShift Launcher. If PlaneShift is installed in your home directory:

~/PlaneShift/pslaunch

Click Settings then Graphics.

Set Background loading to: off

Click: OK


7. Lower Shaders value.

Start the PlaneShift Launcher. If PlaneShift is installed in your home directory:

~/PlaneShift/pslaunch

Click Settings then Graphics.

Select a lower Shaders value.

Click: OK



Text corruption

Edit:

PlaneShift/data/config/r3dopengl.cfg

If PlaneShift is installed in your home directory

~/PlaneShift/data/config/r3dopengl.cfg

Add the following lines to the bottom of the file.

Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false

Find the following line:

Video.OpenGL.FontCache.UseMultiTexturing = yes

and change yes to no

Video.OpenGL.FontCache.UseMultiTexturing = no

Save changes.



Invisible NPCs

Turn off: Background loading

Start the PlaneShift Launcher. If PlaneShift is installed in your home directory:

~/PlaneShift/pslaunch

Click Settings then Graphics.

Set Background loading to: off

Click: OK



Character appears to be stuck

From the game's communications window type:

/unstick