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

Convert books to PSUnreal