PSwiki - User contributions [en]

Troubleshooting guide for Linux

2012-04-24T15:36:58Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

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

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch --console
</pre>

If the updater fails with errors such as:

<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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:

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/pslaunch
</pre>

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.subhosting.net/index.php?page=about_page

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:

<pre>
~/PlaneShift/pslaunch --console
</pre>

Updating may take a few minutes.

Then try to connect again.

'''4.'''
Edit servers.xml manually and replace ''planeshift.zeroping.it'' with ''planeshift.subhosting.net''

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

<pre>
~/PlaneShift/data/servers.xml
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''
----

'''Text corruption'''

Edit:

<pre>
PlaneShift/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.
----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''
----

'''Character appears to be stuck'''

From the game's communications window type:

/unstick
----

Troubleshooting guide for Linux

2012-04-24T15:21:55Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

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

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch --console
</pre>

If the updater fails with errors such as:

<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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

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

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/pslaunch
</pre>

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.subhosting.net/index.php?page=about_page

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:

<pre>
~/PlaneShift/pslaunch --console
</pre>

Updating may take a few minutes.

Then try to connect again.

'''4.'''
Edit servers.xml manually and replace ''planeshift.zeroping.it'' with ''planeshift.subhosting.net''

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

<pre>
~/PlaneShift/data/servers.xml
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''
----

'''Text corruption'''

Edit:

<pre>
PlaneShift/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.
----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''
----

'''Character appears to be stuck'''

From the game's communications window type:

/unstick
----

PlaneShift Development School

2012-03-31T18:36:06Z

Galok:

== PlaneShift Development School ==

'''Become an Apprentice Software Developer for the PlaneShift project.'''

Who can apply?

You if:
* You have experience with any programming language.
* Are willing to learn C and C++.
* You can spare two evenings (or equivalent) a week for approximately four months.

The ultimate goal of this apprenticeship is to understand how to work as a software developer, in a distributed software development team, for the PlaneShift project and eventually fix bugs.

There are (at least) two phases that must be completed before becoming a PlaneShift Software Development Apprentice and each phase will be supported by:
* PlaneShift Software Development Team via the IRC channel: #planeshift-build
* PlaneShift Software Development Team via the PlaneShift forum private messaging system.

The PlaneShift Software Development Team will constructively grade your work at each stage, with an eye to help you become a PlaneShift Software Development Apprentice.

''Phase 1.''

'''Environment and documentation'''

Topics covered:
* Linux, MacOS, Windows.
* How to install a test PlaneShift Game Server on your own computer.
* How to set up a development environment.
* How to read the PlaneShift Application Programming Interface (API).
* How to check-out source code from versioning software, make changes and then check your changes back in.
* How to test your code.
* How to use the Bug Tracking web site.

The duration of this phase will be entirely up to you but assuming you can spare two evenings a week (or equivalent), the initial subject matter listed above should be completed over a period of two months.

Then what?

''Phase 2.''

'''Coding exercises'''

If the PlaneShift Software Development Team is satisfied that you have completed phase 1 then real coding exercises will be given to you.

You must complete and test each exercise on your own PlaneShift Game Server.

After each exercise, you will submit code and screenshots to the PlaneShift Software Development Team, who will constructively grade your work with an eye to help you become a PlaneShift Software Development Apprentice.

The duration of this phase, again will be entirely up to you but assuming you can spare another two evenings (or equivalent) a week, expect to spend two more months on these exercises.

The Software Development Team need confidence in you and your abilities so please be patient if they ask you to spend a little more time on some more exercises.

Then what?

Provided you have met the PlaneShift Software Development Team’s standards, you will be invited to become a PlaneShift Software Development Apprentice.

You will become part of an experienced, distributed software development team and assigned bugs to fix.

'''Tour of duty'''

How long is the apprenticeship for?

This will depend on how many hours and how much work you are able to do but after a year you can expect to receive a certificate stating that you have been a member of the Software Development Team for the Open Source Project: PlaneShift

for a period of one year.

Certificates will be issued annually there after.
----

PlaneShift Development School

2012-03-31T18:35:41Z

Galok:

== PlaneShift Development School ==

'''Become an Apprentice Software Developer for the PlaneShift project.'''

Who can apply?

You if:
* You have experience with any programming language.
* Are willing to learn C and C++.
* You can spare two evenings (or equivalent) a week for approximately four months.

The ultimate goal of this apprenticeship is to understand how to work as a software developer, in a distributed software development team, for the PlaneShift project and eventually fix bugs.

There are (at least) two phases that must be completed before becoming a PlaneShift Software Development Apprentice and each phase will be supported by:
* PlaneShift Software Development Team via the IRC channel: #planeshift-build
* PlaneShift Software Development Team via the PlaneShift forum private messaging system.

The PlaneShift Software Development Team will constructively grade your work at each stage, with an eye to help you become a PlaneShift Software Development Apprentice.

''Phase 1.''

'''Environment and documentation'''

Topics covered:
* Linux, MacOS, Windows
* How to install a test PlaneShift Game Server on your own computer.
* How to set up a development environment.
* How to read the PlaneShift Application Programming Interface (API).
* How to check-out source code from versioning software, make changes and then check your changes back in.
* How to test your code.
* How to use the Bug Tracking web site.

The duration of this phase will be entirely up to you but assuming you can spare two evenings a week (or equivalent), the initial subject matter listed above should be completed over a period of two months.

Then what?

''Phase 2.''

'''Coding exercises'''

If the PlaneShift Software Development Team is satisfied that you have completed phase 1 then real coding exercises will be given to you.

You must complete and test each exercise on your own PlaneShift Game Server.

After each exercise, you will submit code and screenshots to the PlaneShift Software Development Team, who will constructively grade your work with an eye to help you become a PlaneShift Software Development Apprentice.

The duration of this phase, again will be entirely up to you but assuming you can spare another two evenings (or equivalent) a week, expect to spend two more months on these exercises.

The Software Development Team need confidence in you and your abilities so please be patient if they ask you to spend a little more time on some more exercises.

Then what?

Provided you have met the PlaneShift Software Development Team’s standards, you will be invited to become a PlaneShift Software Development Apprentice.

You will become part of an experienced, distributed software development team and assigned bugs to fix.

'''Tour of duty'''

How long is the apprenticeship for?

This will depend on how many hours and how much work you are able to do but after a year you can expect to receive a certificate stating that you have been a member of the Software Development Team for the Open Source Project: PlaneShift

for a period of one year.

Certificates will be issued annually there after.
----

PlaneShift Development School

2012-03-31T18:28:43Z

Galok:

== PlaneShift Development School ==

'''Become an Apprentice Software Developer for the PlaneShift project.'''

Who can apply?

You if:
* You have experience with any programming language.
* Are willing to learn C and C++.
* You can spare two evenings (or equivalent) a week for approximately four months.

The ultimate goal of this apprenticeship is to understand how to work as a software developer, in a distributed software development team, for the PlaneShift project and eventually fix bugs.

There are (at least) two phases that must be completed before becoming a PlaneShift Software Development Apprentice and each phase will be supported by:
* PlaneShift Software Development Team via the IRC channel: #planeshift-build
* PlaneShift Software Development Team via the PlaneShift forum private messaging system.

The PlaneShift Software Development Team will constructively grade your work at each stage, with an eye to help you become a PlaneShift Software Development Apprentice.

''Phase 1.''

'''Environment and documentation'''

Topics covered:
* How to install a test PlaneShift Game Server on your own computer.
* How to set up a development environment.
* How to read the PlaneShift Application Programming Interface (API).
* How to check-out source code from versioning software, make changes and then check your changes back in.
* How to test your code.
* How to use the Bug Tracking web site.

The duration of this phase will be entirely up to you but assuming you can spare two evenings a week (or equivalent), the initial subject matter listed above should be completed over a period of two months.

Then what?

''Phase 2.''

'''Coding exercises'''

If the PlaneShift Software Development Team is satisfied that you have completed phase 1 then real coding exercises will be given to you.

You must complete and test each exercise on your own PlaneShift Game Server.

After each exercise, you will submit code and screenshots to the PlaneShift Software Development Team, who will constructively grade your work with an eye to help you become a PlaneShift Software Development Apprentice.

The duration of this phase, again will be entirely up to you but assuming you can spare another two evenings (or equivalent) a week, expect to spend two more months on these exercises.

The Software Development Team need confidence in you and your abilities so please be patient if they ask you to spend a little more time on some more exercises.

Then what?

Provided you have met the PlaneShift Software Development Team’s standards, you will be invited to become a PlaneShift Software Development Apprentice.

You will become part of an experienced, distributed software development team and assigned bugs to fix.

'''Tour of duty'''

How long is the apprenticeship for?

This will depend on how many hours and how much work you are able to do but after a year you can expect to receive a certificate stating that you have been a member of the Software Development Team for the Open Source Project: PlaneShift

for a period of one year.

Certificates will be issued annually there after.
----

PlaneShift Development School

2012-03-31T18:08:20Z

Galok:

== PlaneShift Development School ==

'''Become an Apprentice Software Developer for the PlaneShift project.'''

Who can apply?

You if:
* You have experience with any programming language.
* Are willing to learn C and C++.
* You can spare two evenings (or equivalent) a week for approximately four months.

The ultimate goal of this apprenticeship is to understand how to work as a software developer, in a distributed software development team, for the PlaneShift project and eventually fix bugs.

There are (at least) two phases that must be completed before becoming a PlaneShift Software Development Apprentice and each phase will be supported by:
* PlaneShift Software Development Team via the IRC channel: #planeshift-build
* PlaneShift Software Development Team via the PlaneShift forum private messaging system.

The PlaneShift Software Development Team will constructively grade your work at each stage, with an eye to help you become a PlaneShift Software Development Apprentice.

''Phase 1.''

'''Environment and documentation'''

Topics covered:
* How to install a test PlaneShift Game Server on your own computer.
* How to set up a development environment.
* How to read the PlaneShift Application Programming Interface (API).
* How to check-out source code from versioning software, make changes and then check your changes back in.
* How to test your code.
* How to use the Bug Tracking web site.

The duration of this phase will be entirely up to you but assuming you can spare two evenings a week (or equivalent), the initial subject matter listed above should be completed over a period of two months.

Then what?

''Phase 2.''

'''Coding exercises'''

If the PlaneShift Software Development Team is satisfied that you have completed phase 1 then real coding exercises will be given to you.

You must complete and test each exercise on your own PlaneShift Game Server.

After each exercise, you will submit code and screenshots to the PlaneShift Software Development Team, who will constructively grade your work with an eye to help you become a PlaneShift Software Development Apprentice.

The duration of this phase, again will be entirely up to you but assuming you can spare another two evenings (or equivalent) a week, expect to spend two more months on these exercises.

The Software Development Team need confidence in you and your abilities so please be patient if they ask you to spend a little more time on some more exercises.

Then what?

Provided you have met the PlaneShift Software Development Team’s standards, you will be invited to become a PlaneShift Software Development Apprentice.

You will become part of an experience, distributed software development team and assigned bugs to fix.

----

PlaneShift Development School

2012-03-31T18:03:48Z

Galok: Created page with " == PlaneShift Development School == '''Become an Apprentice Software Developer for the PlaneShift project.''' Who can apply? You if: * You have experience with any prog..."

== PlaneShift Development School ==

'''Become an Apprentice Software Developer for the PlaneShift project.'''

Who can apply?

You if:
* You have experience with any programming language.
* Are willing to learn C and C++.
* You can spare two evenings (or equivalent) a week for approximately four months.

The ultimate goal of this apprenticeship is to understand how to work as a developer, in a distributed software development team, for the PlaneShift project and eventually fix bugs.

There are (at least) two phases that must be completed before becoming a PlaneShift Software Development Apprentice and each phase will be supported by:
* PlaneShift Software Development Team via the IRC channel: #planeshift-build
* PlaneShift Software Development Team via the PlaneShift forum private messaging system.

The PlaneShift Software Development Team will constructively grade your work at each stage, with an eye to help you become a PlaneShift Software Development Apprentice.

''Phase 1.''

'''Environment and documentation'''

Topics covered:
* How to install a test PlaneShift Game Server on your own computer.
* How to set up a development environment.
* How to read the PlaneShift Application Programming Interface (API).
* How to check-out source code from versioning software, make changes and then check your changes back in.
* How to test your code.
* How to use the Bug Tracking web site.

The duration of this phase will be entirely up to you but assuming you can spare two evenings a week (or equivalent), the initial subject matter listed above should be completed over a period of two months.

Then what?

''Phase 2.''

'''Coding exercises'''

If the PlaneShift Software Development Team is satisfied that you have completed phase 1 then real coding exercises will be given to you.

You must complete and test each exercise on your own PlaneShift Game Server.

After each exercise, you will submit code and screenshots to the PlaneShift Software Development Team, who will constructively grade your work with an eye to help you become a PlaneShift Software Development Apprentice.

The duration of this phase, again will be entirely up to you but assuming you can spare another two evenings (or equivalent) a week, expect to spend two more months on these exercises.

The Software Development Team need confidence in you and your abilities so please be patient if they ask you to spend a little more time on some more exercises.

Then what?

Provided you have met the PlaneShift Software Development Team’s standards, you will be invited to become a PlaneShift Software Development Apprentice.

You will become part of an experience, distributed software development team and assigned bugs to fix.

----

Troubleshooting guide for Linux

2012-03-27T17:23:03Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

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

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch --console
</pre>

If the updater fails with errors such as:

<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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

'''Black or grey screens'''

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/pslaunch
</pre>

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.subhosting.net/index.php?page=about_page

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:

<pre>
~/PlaneShift/pslaunch --console
</pre>

Updating may take a few minutes.

Then try to connect again.

'''4.'''
Edit servers.xml manually and replace ''planeshift.zeroping.it'' with ''planeshift.subhosting.net''

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

<pre>
~/PlaneShift/data/servers.xml
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''
----

'''Text corruption'''

Edit:

<pre>
PlaneShift/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.
----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''
----

'''Character appears to be stuck'''

From the game's communications window type:

/unstick
----

Troubleshooting guide for Windows

2012-03-27T17:09:24Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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 ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/314854/EN-US

----

'''Black or grey screens'''

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

Black or grey screens may suggests your graphics card is not adequate for running PlaneShift.

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

'''No audio'''

This message may also be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button, then from the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering does not work on Windows so either use OpenAl or disable sound.
----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

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:

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

Then try to connect again.

'''4.'''
Edit servers.xml manually and replace ''planeshift.zeroping.it'' with ''planeshift.subhosting.net''

To find servers.xml, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
servers.xml
</pre>

or

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>

From there you will find:

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.

From the Windows Start menu > PlaneShift > PlaneShift

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''
----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.
----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''
----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), which is found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html
----

'''Character appears to be stuck'''

From the the game's communications window type:

/unstick
----

Troubleshooting guide for Windows

2012-03-27T17:02:30Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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 ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/314854/EN-US

----

'''Black or grey screens'''

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

Black or grey screens may suggests your graphics card is not adequate for running PlaneShift.

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

'''No audio'''

This message may also be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button, then from the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering does not work on Windows so either use OpenAl or disable sound.
----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

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:

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

Then try to connect again.

'''4.'''
Edit servers.xml manually and replace ''planeshift.zeroping.it'' with ''planeshift.subhosting.net''

To find servers.xml, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
servers.xml
</pre>

or

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>

From there you will find:

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.

From the Windows Start menu > PlaneShift > PlaneShift

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-27T16:56:22Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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 ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/314854/EN-US

----

'''Black or grey screens'''

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

Black or grey screens may suggests your graphics card is not adequate for running PlaneShift.

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

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

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.

'''3.'''
Run the updater:

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

Then try to connect.

'''4.'''
Edit servers.xml manually and replace ''planeshift.zeroping.it'' with ''planeshift.subhosting.net''

To find servers.xml, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
servers.xml
</pre>

or

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>

From there you will find:

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.

From the Windows Start menu > PlaneShift > PlaneShift

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-27T16:51:46Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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 ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/314854/EN-US

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

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.

'''3.'''
Run the updater:

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

Then try to connect.

'''4.'''
Edit servers.xml manually and replace ''planeshift.zeroping.it'' with ''planeshift.subhosting.net''

To find servers.xml, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
servers.xml
</pre>

or

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>

From there you will find:

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.

From the Windows Start menu > PlaneShift > PlaneShift

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-26T12:42:12Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/pslaunch
</pre>

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.subhosting.net/index.php?page=about_page

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.

'''3.'''
Run the updater:

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>

Updating may take a few minutes.

Then try to connect again.

'''4.'''
Edit servers.xml manually and replace ''planeshift.zeroping.it'' with ''planeshift.subhosting.net''

If PlaneShift is installed in your home directory then servers.xml will be located here:
<pre>
~/PlaneShift/data/servers.xml
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-26T12:38:09Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/pslaunch
</pre>

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.subhosting.net/index.php?page=about_page

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.

'''3.'''
Run the updater:

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>

Updating may take a few minutes.

Then try to connect again.

'''4.'''
Edit servers.xml manually and replace ''planeshift.zeroping.it'' with ''planeshift.subhosting.net''

If PlaneShift is installed in your home directory then servers.xml will be located here:
<pre>
~/PlaneShift/data/servers.xml
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/pslaunch
</pre>

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:

<pre>
~/PlaneShift/pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-26T12:29:10Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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.subhosting.net/index.php?page=about_page

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.

'''3.'''
Run the updater:

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>

Updating may take a few minutes.

Then try to connect again.

'''4.'''
Edit servers.xml manually and replace ''planeshift.zeroping.it'' with ''planeshift.subhosting.net''

If PlaneShift is installed in your home directory then servers.xml will be located here:
<pre>
~/PlaneShift/data/servers.xml
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-26T12:17:51Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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 ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/314854/EN-US

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

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.

'''3.'''
Run the updater:

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

Then try to connect.

'''4.'''
Edit servers.xml manually and replace ''planeshift.zeroping.it'' with ''planeshift.subhosting.net''

To find servers.xml, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
servers.xml
</pre>

or

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>

From there you will find:

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.

From the Windows Start menu > PlaneShift > PlaneShift

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-16T10:57:49Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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 ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/314854/EN-US

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

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

From the Windows Start menu > PlaneShift > PlaneShift

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-16T10:41:43Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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 ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

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

From the Windows Start menu > PlaneShift > PlaneShift

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-16T10:41:06Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-16T10:40:38Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-16T10:39:26Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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 ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

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

From the Windows Start menu > PlaneShift > PlaneShift

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-16T10:38:57Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-16T10:31:18Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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 ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

'''Full screen mode crashes the client'''

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

To turn off full screen mode:

Start the PlaneShift Launcher.

From the Windows Start menu > PlaneShift > PlaneShift

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-16T10:30:44Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

'''Full screen mode crashes the client'''

Unfortunately full screen mode does 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-14T10:34:04Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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 ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

'''Full screen mode crashes the client'''

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

To turn off full screen mode:

Start the PlaneShift Launcher.

From the Windows Start menu > PlaneShift > PlaneShift

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.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-14T10:33:10Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If your problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

'''Full screen mode crashes the client'''

Unfortunately full screen mode does 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-14T10:31:46Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If you problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

'''Full screen mode crashes the client'''

Unfortunately full screen mode does 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-14T10:31:13Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If you problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

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 ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

'''Full screen mode crashes the client'''

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

To turn off full screen mode:

Start the PlaneShift Launcher.

From the Windows Start menu > PlaneShift > PlaneShift

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.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-14T10:07:40Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If you problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

Please copy and paste the following text into your forum post, filling the 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 ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

'''Full screen mode crashes the client'''

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

To turn off full screen mode:

Start the PlaneShift Launcher.

From the Windows Start menu > PlaneShift > PlaneShift

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.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-14T10:07:07Z

Galok:

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

* If you are unable to enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=17.0

* If you problem occurs once you enter the PlaneShift world then post in this forum: http://www.hydlaaplaza.com/smf/index.php?board=33.0

Please copy and paste the following text into your forum post, filling the 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.html

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

'''Full screen mode crashes the client'''

Unfortunately full screen mode does 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-08T21:56:20Z

Galok:

== 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.html

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

'''Full screen mode crashes the client'''

Unfortunately full screen mode does 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-08T21:55:24Z

Galok:

== Problems before entering the game ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

'''Full screen mode crashes the client'''

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

To turn off full screen mode:

Start the PlaneShift Launcher.

From the Windows Start menu > PlaneShift > PlaneShift

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.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-08T21:54:57Z

Galok:

== Problems before entering the game ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

'''Full screen mode crashes the client'''

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

To turn off full screen mode:

Start the PlaneShift Launcher.

From the Windows Start menu > PlaneShift > PlaneShift

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.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-08T21:53:10Z

Galok:

== 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.html

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

'''Full screen mode crashes the client'''

Unfortunately full screen mode does 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-06T16:16:13Z

Galok:

== Problems before entering the game ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

'''Full screen mode crashes the client'''

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

To turn off full screen mode:

Start the PlaneShift Launcher.

From the Windows Start menu > PlaneShift > PlaneShift

Click ''Settings''

Unselect ''Enable Fullscreen''

Click: ''OK''

----

Troubleshooting guide for Linux

2012-03-06T16:14:19Z

Galok:

== 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.html

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

'''Full screen mode crashes the client'''

Unfortunately full screen mode does 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings''

Unselect ''Enable Fullscreen''

Click: ''OK''

----

Troubleshooting guide for Linux

2012-03-05T09:46:34Z

Galok:

== 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.html

----

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

<pre>
cd ~/Downloads

chmod 700 PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

If these file 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.

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Linux

2012-03-03T09:41:24Z

Galok:

== 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.html

----

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 (~/Downloads). Type:

<pre>
cd ~/Downloads

chmod 755 PlaneShift-vn.n.n-x86.run
</pre>

Then, to launch it, assuming you still have the same command prompt open:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-03T09:40:50Z

Galok:

== Problems before entering the game ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

'''Character appears to be stuck'''

From the communications window type:

/unstick

----

Troubleshooting guide for Windows

2012-03-02T11:32:51Z

Galok:

== Problems before entering the game ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

Troubleshooting guide for Linux

2012-03-02T11:30:21Z

Galok:

== 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.html

----

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 (~/Downloads). Type:

<pre>
cd ~/Downloads

chmod 755 PlaneShift-vn.n.n-x86.run
</pre>

Then, to launch it, assuming you still have the same command prompt open:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.subhosting.net/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

Troubleshooting guide for Windows

2012-03-02T10:36:30Z

Galok:

== Problems before entering the game ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.zeroping.it/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

Troubleshooting guide for Linux

2012-03-02T10:35:25Z

Galok:

== 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.html

----

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 (~/Downloads). Type:

<pre>
cd ~/Downloads

chmod 755 PlaneShift-vn.n.n-x86.run
</pre>

Then, to launch it, assuming you still have the same command prompt open:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.zeroping.it/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

Troubleshooting guide for Windows

2012-03-02T10:33:38Z

Galok:

== Problems before entering the game ==

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

----

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.zeroping.it/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Intel graphics chips on Windows'''

There is an abundance of 3D gaming and OpenGL problems on Windows, related to Intel's own Graphics Processing Unit (GPU), found on some laptops and PC motherboards. The problem is related to their own Windows' drivers. It is possible that Intel will improve the quality of these graphics drivers over time so it is important to check their web site regularly for the latest drivers.

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

Symptoms:

* Ground stretches and smears.

* Maps are broken.

* Crashing during character creation.

* Objects and maps flicker.

(Possible) workaround:

Install Xubuntu Linux alongside your Windows installation.

Linux is a free Operating System that can run alongside a Windows installation by way of dual booting and uses independent (not Intel's) graphics drivers. A minimum of ten gigabytes of disk space will be required for Xubuntu and the Linux version of PlaneShift.

http://xubuntu.org/

* Xubuntu is an elegant and easy-to-use operating system. Xubuntu comes with Xfce, which is a stable, light and configurable desktop environment.

If you need hand-holding or some advice before installing Xubuntu, then join the PlaneShift IRC channel. Simple instructions for joining the PlaneShift IRC channel can be found here:

http://www.planeshift.it/irc.html

----

Troubleshooting guide for Windows

2012-03-02T08:32:04Z

Galok:

== Problems before entering the game ==

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.zeroping.it/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Lower ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

Troubleshooting guide for Linux

2012-03-02T08:30:37Z

Galok:

== Problems before entering the game ==

'''Installation'''

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 (~/Downloads). Type:

<pre>
cd ~/Downloads

chmod 755 PlaneShift-vn.n.n-x86.run
</pre>

Then, to launch it, assuming you still have the same command prompt open:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.zeroping.it/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Select a lower ''Shaders'' value.

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

Troubleshooting guide for Windows

2012-03-02T08:27:51Z

Galok:

== Problems before entering the game ==

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.zeroping.it/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

'''7.''' Reduce: ''Shaders'' values.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Shaders'' to a lower value.

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

Troubleshooting guide for Linux

2012-03-02T08:16:30Z

Galok:

== Problems before entering the game ==

'''Installation'''

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 (~/Downloads). Type:

<pre>
cd ~/Downloads

chmod 755 PlaneShift-vn.n.n-x86.run
</pre>

Then, to launch it, assuming you still have the same command prompt open:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.zeroping.it/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating 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:

<pre>
~/PlaneShift/.pslaunch
</pre>

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:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

Troubleshooting guide for Linux

2012-03-02T08:04:58Z

Galok:

== Problems before entering the game ==

'''Installation'''

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 (~/Downloads). Type:

<pre>
cd ~/Downloads

chmod 755 PlaneShift-vn.n.n-x86.run
</pre>

Then, to launch it, assuming you still have the same command prompt open:

<pre>
./PlaneShift-vn.n.n-x86.run
</pre>

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:

<pre>
~/PlaneShift/psclient
</pre>
or
<pre>
~/PlaneShift/pslaunch
</pre>

----

'''To update PlaneShift from a Linux command line'''

If PlaneShift is installed in your home directory:
<pre>
~/PlaneShift/pslaunch --console
</pre>
If the updater fails with errors such as:
<pre>
Unable to get root node! Segmentation fault
</pre>

Edit: updateservers.xml and updaterinfo.xml

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

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

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.

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

If PlaneShift is installed in your home directory:

<pre>
~/PlaneShift/pslaunch
</pre>

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message is displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

----

'''Unable to connect to server'''

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

http://planeshift.zeroping.it/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating your graphics card drivers.

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

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

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

'''6.''' Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Text corruption'''

Edit:

<pre>
<PlaneShift dir>/data/config/r3dopengl.cfg
</pre>

If PlaneShift is installed in your home directory

<pre>
~/PlaneShift/data/config/r3dopengl.cfg
</pre>

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

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

<pre>
~/PlaneShift/.pslaunch
</pre>

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

Troubleshooting guide for Windows

2012-03-02T08:03:54Z

Galok:

== Problems before entering the game ==

'''Installing and reinstalling'''

If you require a fresh reinstall, where all previous configuration details and files are removed, then you will need to do some manual clean up. You will need to manually delete previous configuration files.

First run the PlaneShift uninstall program (Add and remove programs).

'''1.'''
Simplest way to find all PlaneShift files is to press the F3 key on your keyboard. The Windows Find dialog will be displayed.

From here you can inform Windows which hard drives to search and what to search for so in the search field, enter:
<pre>
PlaneShift
</pre>
Then, from Find's search results, delete all directories/folders called PlaneShift.

Take care not to delete the installation file you downloaded: PlaneShift-vn.n.n.exe

You are now ready for a fresh install.

'''2.'''
Slightly more technical way is to run the PlaneShift uninstall program (Add and remove programs), then find your Windows Application Data directory/folder.

Open the file manager (explorer) and in the Address field type:
<pre>
%AppData%
</pre>
followed by the enter key on your keyboard.

This will open your 'Application Data' folder. For example:
<pre>
c:\Documents and Settings\aUser\Application Data\
</pre>
In there you will find the PlaneShift configuration and logs directory.

Either delete it or rename it to: PlaneShift-old

You are now ready for a fresh install.

----

'''To update PlaneShift'''

From the Windows Start menu > PlaneShift > PlaneShift

If an update is available, the PlaneShift Launcher will prompt
you. Select ''Yes'' from the prompt to update.

Updating may take a few minutes.

The updater can all also be run from the command line:

<pre>
pslaunch.exe --console
</pre>

----

'''Graphics card drivers'''

Download the latest driver from the graphics card manufacturer's web
site and install it.

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/

Make sure Windows is using the correct driver. Windows has its own
set of drivers which are sometimes set as factory defaults, even
when the manufacturer's drivers are available. To ensure you are
using the correct driver for your graphics card, see:

http://windows.microsoft.com/en-US/windows-vista/Video-cards-frequently-asked-questions

http://support.microsoft.com/kb/200435

----

'''Black or grey screens'''

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.

Turning off Vertex Buffer Objects may help.

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''

Unselect the check box: Enable VBO

Click: ''OK''

----

'''No audio'''

This message may be displayed when you start PlaneShift:

<pre>
could not load plugin 'crystalspace.sndsys.renderer.null'
</pre>

Start the PlaneShift Launcher from the Windows Start menu > PlaneShift > PlaneShift

Click the ''Settings'' button. From the Settings screen click: ''Audio''

Select the check box: ''Enable sound''

Set Sound Renderer to: ''OpenAl''

''Software'' rendering of sound does not work on Windows so either use OpenAl or disable sound.

----

'''Unable to connect to server'''

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

http://planeshift.zeroping.it/index.php?page=about_page

Check the Stats box for server status.

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

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

== In game bugs (after loading world) ==

'''Performance'''

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

'''2.''' Updating your graphics card drivers.

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

Start button > Control Panel

Under Appearance and Personalization, click: ''Adjust screen resolution''

From Advanced settings, click the ''Monitor'' tab.

Under Colors, select ''True Color (32 bit)''.

Click: ''OK''.

'''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 psclient.cfg and change:

<pre>
Video.OpenGL.TextureDownsample = 0
</pre>

to

<pre>
Video.OpenGL.TextureDownsample = 4
</pre>

To find psclient.cfg, press F3 key on your keyboard and enter the following into the find dialog:

<pre>
psclient.cfg
</pre>

'''6.''' Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----

'''Text corruption'''

From the Windows desktop, press F3 to display the Find dialog. Then search for:

<pre>
r3dopengl.cfg
</pre>

It will be located amongst the PlaneShift installed files.

Add the following lines to the bottom of the file.

<pre>
Video.OpenGL.UseExtension.GL_ARB_texture_rectangle = false
Video.OpenGL.UseExtension.GL_NV_texture_rectangle = false
</pre>

Find the following line:

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = yes
</pre>

and change ''yes'' to ''no''

<pre>
Video.OpenGL.FontCache.UseMultiTexturing = no
</pre>

Save changes.

----

'''Invisible NPCs'''

Turn off: ''Background loading''

From the Windows Start menu > PlaneShift > PlaneShift

From the PlaneShift Launcher click: ''Settings'' then ''Graphics''.

Click ''Settings'' then ''Graphics''.

Set ''Background loading'' to: off

Click: ''OK''

----