Windows

A great way to troubleshoot Windows issues is by starting with a clean boot: http://support.microsoft.com/kb/929135/

Generic troubleshooting: https://planetaryannihilation.com/support/troubleshooting/

Windows System Requirements

MinimumRecommended
Windows 7 Service Pack 1Windows 10 latest

Update Your Windows GPU Drivers

Please make sure your graphics drivers are up to date by downloading your drivers directly from the graphics card manufacturer websites. Drivers from Windows laptop manufacturer websites are often outdated.

Alternatively use the graphic card manufacturer auto detection and update tools:

Multiple GPUs or Switchable Graphics

If your gaming laptop or desktop has multiple graphics cards, please make sure you have updated drivers for both cards and that you have configured both PA and CoherentUI to run on your high performance dedicated GPU.

Windows Planetary Annihilation Data Directory

The default location is in your local app data directory:

%LOCALAPPDATA%\Uber Entertainment\Planetary Annihilation
C:\Users\YOURUSERNAME\AppData\local\Uber Entertainment\Planetary Annihilation

Your user AppData directory is hidden by default so you have a couple of options:

Windows Incompatible Software

ASUS / ROG GameFirstMay cause network lag resulting in unit stutter / jumps with both online and offline servers.
Firewall / Security Suites
May cause connection failures and crashes.

Disable or add exceptions for SSL / protocol scanning / filtering for PA.exe, server.exe and CoherentUI_Host.exe

ESET: https://support.eset.com/en/kb5833-manage-protocolssltls-filtering-in-eset-windows-home-products
Kaspersky: https://support.kaspersky.com/12684#block2
On Screen Displays (OSD)May cause black screens and crashes.

MSI Afterburner / Rivatuner
ASUS / ROG Sonic Radar
3D API / OpenGL InterceptorsMay cause black screens and crashes.

Lucid Virtu MVP
Sound EnhancersMay cause no sound.

ASUS Sound Studio
Nahimic for Gamers

Windows Crash Dumps

PA generated crash reports with logs (and dxdiag on windows) are usually automatically uploaded to our crash reporting system.

When reporting crashes it also helps if you include the crash ID from your logs (same as the filename of the generated minidump):

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.dmp


The default location for crash dumps generated by PA is now the logs directory in your Planetary Annihilation data directory.

The environment variable MINIDUMP_DIRECTORY can be used to change the location where PA crash minidump files are saved and will also generate more detailed (and larger) minidump files similar to the new --enable-detailed-minidump command line option.

Windows Error Reporting (WER)

The default location for mini crash dumps created by Windows Error Reporting (WER) is:

  • %LOCALAPPDATA%\CrashDumps\

WER crash dump files are named like:

  • PA.exe.NNNNN.dmp

Windows Environment Variables

To set environment variables on Windows use:

  • Control Panel > System > Advanced system settings > Environment Variables (or search for environment variables if using Windows 10).

Troubleshooting

Planetary Annihilation is a cross platform client / server networked OpenGL application.

Any software that interferes with network connections or OpenGL can cause issues.

When playing you are connecting to a local server or hosted server over the internet.

A cabled Ethernet connection to your router will perform better than Wi-Fi for most games.

System level crashes or mouse / keyboard freezes during live games are almost always a hardware / driver issue with your system. PA can really push your hardware to the max.

System Requirements

MinimumRecommended
CPUMODERN Quad CoreMODERN Quad Core+
Memory8GB RAM for dedicated GPU
12GB RAM for integrated GPU
4GB free for local server
16GB RAM
GPUOpenGL 3.2+ / 1GB VRAMDedicated GPU
Storage5GB available space7 GB available space
InternetBroadbandBroadband via Ethernet

Older CPUs

  • AMD Phenom
  • Intel Core 2

Try the legacy build.: https://planetaryannihilation.com/guides/planetary-annihilation-public-test-environments-pte/

Older AMD / Intel GPUs or Brightness Issues

All modern GPUs should now support sRGB and sRGB multiple render targets blending.

Historical sRGB workarounds for AMD / Intel GPU’s were removed in 114880.

Use the following if you need to enable the previous settings:

  • --gl-disable-srgb
  • --gl-disable-mrt-srgb

For Intel GPUs on Windows 10 make sure you have the latest GPU driver and the Intel Graphics Commander Center:

Lost TITANS Ownership After Linking Steam with PA Account

Open a support ticket at: https://support.planetaryannihilation.com/

Verify Your Game Files

Clear Your Download Cache

Delete the contents of the download directory in your Planetary Annihilation Data Directory.

Remove Special Characters from your Display Name

Special characters in display names can cause issues like:

  • hanging on the login accepted screen
  • game over not appearing

To change your display name in-game, click on the social icon in the lower right-hand corner. A menu should appear with your name and a dropdown box to change your online status. Below that says, “Change Display Name.”

A box will appear where you can type in your New Display Name. If the name you’ve entered has already been taken, a message will appear to notify you.

Disable FPS Counters / Overlays / Memory Optimisers

The safe way to check stats is via control-p in-game to toggle between:

  • Client FPS
  • GPU memory usage

When connected to a local or public server:

  • Server (always max 1FPS)
  • Sim (max 10 FPS once game has started)

Close Other Applications / Browsers

PA is a CPU heavy game especially when running a local server.

Close unnecessary applications and browser tabs especially on older systems.

Clean Testing

You can start a clean copy of PA without deleting your existing Planetary Annihilation Data Directory by using the --localstorageurl command line parameter.

Planetary Annihilation Data Directory

The data directory or folder is separate from your install directory and contains:

  • logs
  • local configuration localstore
  • file system mods client_mods and server_mods
  • downloads for community mods download

The data directory is shared by all installations of Planetary Annihilation:

  • steam
  • launcher
  • stable or PTE streams

Updating or reinstalling PA does not impact the data directory.

By default all installations use the same local configuration. You can override this using the --localstorageurl command line parameter.

--localstorageurl=localstore-testing

Windows Planetary Annihilation Data Directory

The default location is in your local app data directory:

%LOCALAPPDATA%\Uber Entertainment\Planetary Annihilation
C:\Users\YOURUSERNAME\AppData\local\Uber Entertainment\Planetary Annihilation

Your user AppData directory is hidden by default so you have a couple of options:

macOS Planetary Annihilation Data Directory

The default location is in your local library folder:

/Users/YOURUSERNAME/Library/Application Support/Uber Entertainment/Planetary Annihilation
~/Library/Application Support/Uber Entertainment/Planetary Annihilation 

Your user library folder is hidden by default and can be accessed via:

Linux Planetary Annihilation Data Directory

The default location is in your home directory:

  • ~/.local/Uber Entertainment/Planetary Annihilation/

Steam Installation Directory

  • Open your Steam library
  • Right click on Planetary Annihilation: TITANS or Planetary Annihilation in your list of games
  • Select Properties
  • Click the LOCAL FILES tab
  • Click BROWSE LOCAL FILES

Steam Command Line Parameters

  1. Open your Steam library
  2. Right click Planetary Annihilation: TITANS then select Properties
  3. Click Set Launch Options…

PA Launcher Command Line Parameters

  1. Open the PA launcher and sign in
  2. Click on your username then select Build Options… from the list
  3. Additional command-line options

Crash Reports

PA generated crash reports with logs (and dxdiag on windows) are usually automatically uploaded to our crash reporting system.

When reporting crashes it also helps if you include the crash ID from your logs (same as the filename of the generated minidump):

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.dmp


The default location for crash dumps generated by PA is now the logs directory in your Planetary Annihilation data directory.

The environment variable MINIDUMP_DIRECTORY can be used to change the location where PA crash minidump files are saved and will also generate more detailed (and larger) minidump files similar to the new --enable-detailed-minidump command line option.

Windows Error Reporting (WER) and macOS may also generate different crash reports: https://support.planetaryannihilation.com/kb/faq.php?id=200

Repeatable Crashes Within N Minutes

When there is a repeatable crash after starting a game, clicking on preview PIPs, etc it’s often caused by local issues like:

  • out of date drivers
  • out of date BIOS
  • faulty / failing hardware
    • faulty or mismatched RAM
    • old or underrated power supply

PA can stress your hardware more than other games and we can normally spot local issues by:

  • uniqueness of crash
  • type of crash
  • location of crash
  • kernel events

Streaming

Use game capture with a specific window to avoid jitter when scrolling.

HDR10

Experimental hardware HDR10 support can be enabled on latest Windows 10 for modern Nvidia 10 series or newer GPUs connected via DisplayPort 1.4+ or HDMI 2.0+ using:

  • --hardware-hdr

Note: macOS HDR10 support is automatic.

macOS

macOS is our primary development environment.

Generic troubleshooting: https://planetaryannihilation.com/support/troubleshooting/

macOS System Requirements

MinimumRecommended
macOS10.9 64 bit10.15
CPUMODERN Quad Core i5MODERN Quad Core i7+
Memory8GB RAM for dedicated GPU
12GB RAM for integrated GPU
4GB free for local server
16GB RAM
GPUOpenGL 3.2+Dedicated GPU
Storage5GB available space7 GB available space
InternetBroadbandEthernet Broadband

macOS Planetary Annihilation Data Directory

The default location is in your local library folder:

/Users/YOURUSERNAME/Library/Application Support/Uber Entertainment/Planetary Annihilation
~/Library/Application Support/Uber Entertainment/Planetary Annihilation 

Your user library folder is hidden by default and can be accessed via:

Linux

Linux is our labour of love.

Starting with build 114220 we have upgraded our Ubuntu based toolchain to gcc-9 with LTO which is available in the default repositories or backports of most distributions.

gcc-9 is available for all Ubuntu releases back to Ubuntu 12 Precise and derivatives via https://wiki.ubuntu.com/ToolChain

gcc-9 for Debian 10 buster can be pulled from Debian 11 Bullseye.

https://gcc.gnu.org/onlinedocs/libstdc++/manual/abi.html

Local servers will see performance improvements from the move to gcc-9 with LTO and c++17.

https://www.phoronix.com/scan.php?page=news_item&px=GCC-9.1-Compiler-Released

Generic troubleshooting: https://planetaryannihilation.com/support/troubleshooting/

Linux Dependencies

  • libstdc++6 >= gcc-9 GLIBCXX_3.4.26 (native)
  • libcurl4-gnutls or libcurl-compat (native on non Ubuntu / Debian)
  • libsdl2 (provided by steam)
  • libgl1 (provided by steam)
  • libudev0 (provided by steam)
  • libuuid (provided by steam)

There are some known issues for Linux distributions not based on Ubuntu / Debian.

As a last resort if packages are not available for libudev0 or libcurl4-gnutls you might be able to use a hacky symlink (not recommended).

Stops on launch splash

Downloads are stalled due to missing certs on some non Debian / Ubuntu distributions like Fedora or NixOS.

Use the OpenSSL SSL_CERT_FILE environment variable when launching PA from a shell script:

SSL_CERT_FILE=/etc/ssl/certs/ca-bundle.crt

For steam command line arguments use:

SSL_CERT_FILE=/etc/ssl/certs/ca-bundle.crt %command%

Black screen or fails to start

Check your logs for missing dependencies:

  • libcurl4-gnutls
  • libstdc++6 from gcc-9 or newer

Some non Ubuntu / Debian distributions provide a libcurl-compat package for compatibility with libcurl-gnutls from Ubuntu based builds.

Mesa Coherent UI Panel Corruption

The following added to /etc/drirc or ~/.drirc in the <device driver="radeonsi"> section may help:

<application name="CoherentUI_Host"executable="CoherentUI_Host">
    <option name="radeonsi_zerovram" value="true" />
</application>

Linux Planetary Annihilation Data Directory

The default location is in your home directory:

  • ~/.local/Uber Entertainment/Planetary Annihilation/

Sim Performance, Time Dilation and RAM Usage

Planetary Annihilation is a cross platform client / server networked OpenGL application.

Any software that interferes with network connections or OpenGL can cause issues.

When playing you are connecting to a local server or hosted server over the internet.

A cabled Ethernet connection to your router will perform better than Wi-Fi for most games.

System level crashes or mouse / keyboard freezes during live games are almost always a hardware / driver issue with your system. PA can really push your hardware to the max.

Troubleshooting: https://planetaryannihilation.com/support/troubleshooting/

A high spec dedicated server with multi-threading enabled will always out perform a public shared server: https://planetaryannihilation.com/guides/hosting-a-local-server/

Client Performance Does Not Impact Server Performance or Other Clients

The performance of individual clients has no impact on servers or other clients. ie a player with a low spec computer has no impact on the server or other players.

Sim Performance and Time Dilation

When the sim is under pressure the sim rate will slow down causing time dilation.

ie the sim time is slower than real time (this is not lag).

Sim performance depends on:

  • map
    • number of planets (sweet spot is under 8 unless they are tiny with MAX_PLANETS = 16 defined in media/server-script/sim_utils.js)
    • radius (recommended maximum size is 800 – 1000)
    • CSG (more CSG = more complex pathing and navigation)
  • number of armies
  • number of AIs
    • increase the difficulty before adding more
    • increase their eco modifier before adding more
  • number of units
  • number of unit interactions
  • number of projectiles
  • play style
    • hoarding units
    • area patrolling a large group of units
  • CPU
  • network usage (see below)

Games with large systems containing many big planets with lots of CSG and many players that hoard thousands of units are not going to perform well on any server.

Each shared team is considered to be a single army in the sim so a 5v5 shared is only two armies and will impact the sim less than a 5v5 unshared or 10 FFA.

Moving large groups of units will impact the sim with planet wide area patrol having the most impact.

Sim Network Throttles

The sim currently throttles to maintain each history viewpoint at a maximum of 4 Mbps (megabits per second).

Each PIP is a separate viewpoint connection multiplexed into a single TCP connection.

The maximum bandwidth per client TCP connection or socket is 16 Mbps (megabits per second).

32 players might use up to 512 Mbps (megabits per second) of outgoing bandwidth on a server.

Server RAM Usage

Server RAM usage depends on:

  • system (see sim performance above)
  • history
    • game time
    • number of units created / killed
    • number of unit interactions
    • number of projectiles

Large systems containing many big planets with lots of CSG will require more initial RAM during loading on both the server and clients.

RAM usage will continue to grow over time based on the number of units created / killed and unit interactions.

History is very compressible so memory compression in latest macOS, Windows 10 and Linux will help to limit RAM usage as the history grows.

Public Shared Servers

Our PAnet shared public servers currently run on Amazon Web Services (AWS) in the following regions:

  • USWest (Oregon)
  • USCentral (Ohio) – this was USEast (Virginia) on UberNet from March 2018 to May 2019
  • USEast (Virginia)
  • APSouthEast (Singapore)
  • APNorthEast (Japan)

The following regions have higher capacity servers for bigger games:

  • USWest (Oregon)
  • USCentral (Ohio)
  • USEast (Virginia)
  • EUWest (Ireland)

Public Test Environments (PTE) and Legacy Builds

What is a PTE?

Public Test Environments are publicly available builds for testing upcoming changes prior to release as a stable build.

A PTE can contain any of the following:

  • fixes
  • enhancements
  • new features
  • new content
  • new units

What is a Legacy Build?

Legacy builds are publicly available stable builds for older CPUs like:

  • AMD Phenom
  • Intel Core 2

They automatically target the current stable servers.

How do I access a PTE or Legacy Build?

You can opt-in to a PTE or legacy build via Steam or the PA launcher.

  • modern-pte (optional modern Public Test Environment for modern CPUs)
  • legacy-pte (optional legacy Public Test Environment for older CPUs)
  • legacy (stable for older CPUs that automatically targets stable servers)

Steam (Windows / macOS / Linux)

  1. Open your Steam library
  2. Right click Planetary Annihilation: TITANS then select Properties
  3. Select the BETAS tab
  4. Select a PTE or legacy build from the list
  5. Click the CLOSE button and Steam will download any changes for the selected PTE or legacy build

PA Launcher (Windows / macOS prior to Catalina 10.15)

  1. Open the PA launcher and sign in
  2. Click on your username then select Build Options… from the list
  3. Tick the PTE builds you want to install then click SAVE
  4. Change the stream from stable to the PTE or legacy build you want to test
  5. Click VERIFY to install or update the selected PTE or legacy build

For Windows you may need to install the latest Visual Studio 2019 64 bit runtime: https://support.microsoft.com/en-nz/help/2977003/the-latest-supported-visual-c-downloads

papatcher.go using PAnet accounts

Download papatcher.go from https://raw.githubusercontent.com/planetary-annihilation/papatcher/master/papatcher.go

Install golang from repo (Linux) or https://golang.org/

go run papatcher.go --stream=modern-pte --update-only

Linux Dependencies

  • libsdl2
  • libgl1
  • libstdc++6

On Fedora / NixOS the following environment variable may be needed:

SSL_CERT_FILE=/etc/ssl/certs/ca-bundle.crt

Clean Testing with Multiple Copies of PA

You can start multiples copies of PA using the --localstorageurl command line option with a different name for each copy:

--localstorageurl=localstore-test1

A separate directory for settings will be created in your Planetary Annihilation Data Directory.

This can be used to separate testing from your stable build and is required when running multiple copies of PA at the same time to avoid data loss.

Playing on Stable Servers with PTE

For most PTEs you can play on stable servers using the --version command line option:

--version 114862

Remember to remove or update this when a new build goes live.

Crash Reports

PA generated crash reports with logs (and dxdiag on windows) are usually automatically uploaded to our crash reporting system.

When reporting crashes it also helps if you include the crash ID from your logs (same as the filename of the generated minidump):

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.dmp


The default location for crash dumps generated by PA is now the logs directory in your Planetary Annihilation data directory.

The environment variable MINIDUMP_DIRECTORY can be used to change the location where PA crash minidump files are saved and will also generate more detailed (and larger) minidump files similar to the new --enable-detailed-minidump command line option.

Windows Error Reporting (WER) and macOS may also generate different crash reports: https://support.planetaryannihilation.com/kb/faq.php?id=200

Steam Command Line Parameters

  1. Open your Steam library
  2. Right click Planetary Annihilation: TITANS then select Properties
  3. Click Set Launch Options…

PA Launcher Command Line Parameters

  1. Open the PA launcher and sign in
  2. Click on your username then select Build Options… from the list
  3. Additional command-line options

Steam Installation Directory

  • Open your Steam library
  • Right click on Planetary Annihilation: TITANS or Planetary Annihilation in your list of games
  • Select Properties
  • Click the LOCAL FILES tab
  • Click BROWSE LOCAL FILES
THE GALAXY WON'T CONQUER ITSELF Get it now on Steam!
Get It on Steam

90% off for classic PA owners