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