Giter Club home page Giter Club logo

planetary-annihilation-docker's Introduction


GitHub


A docker image for running a dedicated server for the game Planetary Annihilation: Titans.

Quickstart

docker build \
    --build-arg PANET_USERNAME=<panet username> \
    --build-arg PANET_PASSWORD=<panet password> \
    -t pat https://github.com/FragSoc/planetary-annihilation-docker.git
docker run -d -p 20545:20545 pat

Building

Build Arg Key Default Decription
PA_STREAM_NAME stable Build stream to download the server from. Valid streams reported by papatcher as of 20th Jan 2021 are historical, legacy, legacy-pte, modern-pte, stable. See here.
PANET_USERNAME N/A Username to login to PANet with. Needs to own the game or be linked to a steam account which does. Required.
PANET_PASSWORD N/A Password for the provided username. Required.
UID 999 Unix UID to run the container as.

Note: Credentials for the account are not stored in the final image.

Running

Port 20545 must be opened for client connections.

The container uses just one volume, to store replays: /replays.

Note: if you use a bind mount, the host path you mount into the container must be owned by the UID you passed to the build (see above table)

Environment

The container can be completely customised with environment variables:

Var name Default Value Notes
PA_TITANS_ENABLED yes Any other value will disable the TITANS expansion on the server
PA_AI_ENABLED yes Any other value will disable AI players on the server
PA_SERVER_NAME "A Dockerised PA:T Server"
PA_SERVER_PASSWORD "letmein" Leave blank for no password
PA_MAX_PLAYERS 12
PA_MAX_SPECTATORS 5
PA_SPECTATORS 5
PA_REPLAY_TIMEOUT 180
PA_GAMEOVER_TIMEOUT 360
PA_EMPTY_TIMEOUT 3600

For more information, see the official documentation.

In addition, passing a command to the container will pass that command through to the server binary as a parameter, though passing a parameter that the container already runs (see the above list and docker-entrypoint.sh) may result in undefined behaviour.

Licensing

The few files in this repository are licensed under the AGPL.

However, PA:T itself is licensed by Planetary Annihilation Inc.. No credit is taken for the software running in this container. Read their TOS for more information.

planetary-annihilation-docker's People

Contributors

rustyraptor avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.