Planetary Annihilation Modding

From Planetary Annihilation Titans & Classic PA Wiki
Jump to: navigation, search

Titans-icon.png Planetary Annihilation Titans & Classic Modding Wiki

Gold-rank-icon.png Mod Development

Development Tools

Gold-rank-icon.png Submitting Your Mod

Before submitting your mod create a forum post in the appropriate forum:

Update your modinfo.json with your forum post URL.

For released mods please create a post on steam discussions with prefix [MOD]:

The Community Mods server requires a downloadable URL to a ZIP archive of your top level directory containing your modinfo.json and mod files.

A new game lobby UI client mod would be submitted as a downloadable URL to:

    • modinfo.json
      • ui
        • mods
            • new_game.js

GitHub projects with static download links to a release branch are preferred for auto updating.


You can exclude files from the zip using .gitattributes:

.gitattributes export-ignore
.gitignore export-ignore

If using Dropbox links they must end with dl=1 to be downloadable.

Check the status of your mod at:

Gold-rank-icon.png Updating Your Mod

Existing mods will update automatically if you update the existing zip without changing the URL or mod identifier. GitHub will do that automatically.

When changing your mod please remember to update the date and version.

For each update of your mod please post a new comment to your forum and steam discussions posts with any changes then update your original posts.

Check the status of your mod at:

Platinum-rank-icon.png New Mod Submission Offline

New mod submissions are currently offline until a new server is available.

To submit a new mod please signup to using your forum or in-game name then post your mod URL in the mods channel.

Existing mods will update automatically if you update the existing zip without changing the URL or mod identifier.

Platinum-rank-icon.png Mod Privacy / Security Guidelines

Any mods found remotely harvesting, collecting or tracking user information will be removed and the mod creator permanently banned.

If you have a specific reason to collect information remotely then post about it first in the mod forums and ask permission.

Create your own unique identifier and save in user settings if you need to validate user identity over time.

Save only the minimal information required and do not associate or track IP addresses or any other personally identifiable information.

Assume your server will be hacked eventually so be careful what you save and how you secure data.

Platinum-rank-icon.png Server Mod Guidelines

Server mods should NOT:

  • install outside of current game
  • make changes to user settings or data without permission
  • take over PA in any way eg full screen with no cancel option
  • prevent players from leaving game
  • show inappropriate content

Badly behaved server mods will be killed.

Platinum-rank-icon.png UberId / UberName / DisplayName

Display names are considered public info and can be easily changed. They are not a reliable way to identify users.


UberIds are unique long numbers you can store as strings to identify users without personally identifiable information.


UberNames were replaced by uberIds and are only used now for linked forums names. Steam users will have an auto generated uberName like steam000000000000000.

Ubernames cannot be changed except when linking a forum account with steam.

Ubernames are used for non steam logins to PlayFab / UberNet via the Uber Launcher, PA launched manually and web based Community Chat

Note: PA Stats was never updated to use uberIds.