PSUnreal Guide

Logs and Configs

PSUnreal Client logs and configs

PSUnreal Command Line Options

Settings

The game saves all options present in the Settings panel into savegame files located in your Saved/SaveGames directory (see above for logs and configs)

Here you can find the following files

• audio.sav : stores the audio volumes
• compendium.sav : stores all the entries added to your compendium
• EnhancedInputUserSettings.sav : stores the controls set by user, as they are defined under Settings "Controls"
• interface.sav : all options you see under Settings "interface", including mouse options, font size, menu sizes, ...
• macros.sav : stores the content of the shortcutbar including all the commands
• uiLayout.sav : stores the position and size of all windows

Keys and controls

Keyboard and mouse layout

Troubleshooting on Linux

Running Windows package on Linux

VK_ERROR_DEVICE_LOST

(Moved from: Crash fix on Linux)

If you experience a crash on Linux in 0.7.18 release when loading world, with the log saying VK_ERROR_DEVICE_LOST , try the following:

Go in your config directory (~/.config/Epic/PSUnreal/Saved/Config/LinuxClient/), check if there is a file called Engine.ini or create it.

and then add this two lines. Be sure to have uppercase 'E' in Engine.ini filename:

[SystemSettings]
r.AllowStaticLighting=0

This will disable static lighting completely which seems to be the cause of crashes on some hardware.

VK_ERROR_INCOMPATIBLE_DRIVER

If your launcher or client is crashing before starting, and is throwing VK_INCOMPATIBLE_DRIVER errors, there are two fixes for this assuming that you have the correct drivers installed, and have your card's Vulkan drivers installed.

Note: All commands below should be run without the leading and tailing single quotes. Failure to do so will cause the commands to not work.

Make sure your system has vulkan drivers installed. On most systems, running the command 'ls -la /usr/share/vulkan/icd.d/' will tell you if you have vulkan installed. If nothing shows or there's an error, please install your Graphics Cards Vulkan drivers.

If your drivers are installed and you have more than one, check the output of 'printenv | grep VK_DRIVER_FILES'. It should contain all of the vulkan driver files you wish to use. Running the ls command from the first step will tell you the names of the driver files and their paths. You must put their entire path, separated by colons (:). For example, using the radeon vulkan driver would look like this:

export VK_DRIVER_FILES=/usr/share/vulkan/icd.d/radeon_icd.i686.json:/usr/share/vulkan/icd.d/radeon_icd.x86_64.json 

If this fixes your issue, you may add this line to your '.xinitrc' (or equivalent) file with an ampersand (&) at the end.

If you'd rather prefer to choose your drivers at runtime, and are using an AMD card, you might wish to try AMD Vulkan Prefixes. If you are running ArchLinux, there is an AUR package. Please refer to the linked page for usage.

Troubleshooting on Mac

Please remember to extract the PlaneShift tar file under /Applications. You need to have the PSLauncher and PSUnrealClient in the Applications folder.

PSUnreal Mac authorize app

We had an issue Mac with UE 5.4.3 was freezing after login showing the sky and nothing else, no character selection, no UI. We deleted /Users/<usename>/Library/Application Support/Epic/PSUnreal/Saved/PSUnreal_SF_METAL_SM5.upipelinecache and it worked. That cache was probably made with previous version of unreal 5.1.1

For the Legacy Players

(Moved from: Convert books to PSUnreal)

For books we changed the XML format as we do not have all the same formatting capabilities and we want to split the creations by page.

There are two type of books.

1. One only text, in this case the format is the same, and works also for editing. Expect these book to be fully working in PSUnreal without any modifications
2. One with text and images. The idea was that this format was available only to developers. But some smart players figured out how to enter the XML into the book, to produce a formatted book. These books will not be converted automatically. We ask the players to edit those books in Unreal and fix them for the new format.

The PSLegacy syntax was to have a <Content> tag with type text or pic, example:

 <Contents><Content type="pic" align="0" padding="0 20 0 20" width="225" height="202" src="/paws/base/book_pics/book_ulbernaut.dds;">
 <Content type="text"> Anysu Atani and Migg Ellorean ]</Content>

The new format is:

 <Page><Text>My name is Pabes Riolant, an adventurer always in search of new knowledge. I decided to compile a series of books on the creatures I faced, and you are reading one of them. Here is what I've discovered about the trepor.</Text><Pic width="300" height="300" y="330" src="109" /><Text>A fully-grown trepor is about 1.5m high, 1m wide and 1m long. </Text></Page><Page><Pic width="200" height="200" y="103" src="108" /><Text>They look like the previous image. They are fast-moving carnivorous predators that hunt in small packs. They inhabit plains, forests and caves.</Text><Pic width="200" height="200" y="430" src="108" /></Page><Page><Text>They have four feelers on their raised backs; these feelers help them to move around swiftly in the darkness. Most of their body is covered with a very hard layer of toughened scales. </Text></Page><Page><Text>They can be quite dangerous in small packs and lethal if their colony is threatened. They are able to attack in complete darkness because of their good vision and feelers. A trepor attacks by biting and clawing. Trepor colonies can be found deep in caves. Unlike most insects and arthropods, there is no single queen. </Text></Page><Page><Text>Trepors are unique in that they are hermaphroditic: all possess the organs to both fertilize and lay eggs. They will defend their colony and other trepors to the death, and any invaders are attacked on sight. If you encounter a trepor colony, extreme caution is advised. </Text></Page>

Pictures are no more referred explicitly with the texture name, but they have an internal ID which is pointing to the picture. We will provide you the picture ID in the future. example 108 and 109 are working atm.