pa-coop

Co-op for Prison Architect on your own server. Room for more than 4 players, Steam and Epic in the same game.

ver: pa-coop 0.1.0 · MIT · works with The_Jailhouse_1.02 (r11056)

In-game player list showing 13 players in one prison
13 players, one prison

the game stops at 4. eleven of these are our test bots.

The same prison on two computers side by side
Same prison, two PCs

Office of the Warden

To whoever runs this prison with friends,

The online mode works, until it doesn't. Four players at most. Big prisons drift out of sync, and when the game notices, it shows an error and throws the player out. The servers it talks to belong to someone else, and the multiplayer hasn't been touched since 2023.

pa-coop puts the server in your hands. It speaks the same language as the official one, so the game doesn't know the difference. The mod next to the game takes care of the rest: more players, and when the game reports a desync, the mod asks the host to resend the prison instead of dropping the player. It won't catch every case, but it is better than a kick.

Your saves and the game files stay as they are.

The Warden

From the cameras

The canteen at lunch, packed with prisoners
Lunch, 393 inmates. Same on every screen.
Ironfort seen from above
Ironfort from above
A cell block
Cell block B
Free time in the yard
Free time in the yard
Cells, shower block and morgue
Host on Epic, friend on Steam

All shots taken in the real game, during a co-op session through a pa-coop server.

How it works

Plan no. 1 · scale: not to scale

Your game (host)

Prison Architect
+ the pa-coop mod
runs the simulation

pa-coop server

replaces Photon's cloud
one TCP port (4533)
lobby, game list,
message relay
up to 16 per game

Friend on Steam

same game, same mod
sees what you see

Friend on Epic

Windows or Linux,
it does not matter

one port to open

the mod points the game at your server instead of the official one

desync reported? the mod asks the host to resend the prison

Install

  1. Windows (Steam or Epic)

    Download install-pa-coop.bat from the latest release and double-click it. It finds the game, copies three files next to it and asks one question: host or join.

  2. Host

    Pick "Host a game". Load a prison, then Menu > Go Online. The game starts the server for you and the router opens port 4533 (UPnP). The installer shows the address to give your friends.

  3. Join

    Pick "Join a friend" and type their address. In the game: Join Online Game, their prison is in the list.

  4. Linux (Steam)

    Same thing from a terminal, then add the launch option it prints:

    curl -fsSL https://raw.githubusercontent.com/fabienmillet/prison-architect-server/master/install/install.sh | bash

Router won't open the port? A VPN between friends (Tailscale, ZeroTier, NetBird) works too.

Work order — dedicated server

No. 0001

Keep the prison online even when the host is asleep. One small program, one TCP port. Players set server=<your address>.

Docker

Image on GitHub Container Registry, amd64 and arm64, 6 MB.

docker run -d --name pa-coop \
  -p 4533:4533 \
  -e PACOOP_MAX_PLAYERS=16 \
  ghcr.io/fabienmillet/prison-architect-server

Plain binary

Linux (amd64, arm64) or Windows, from the release page.

./pacoop-server
./pacoop-server -port 14533 -max-players 24
./pacoop-server -h

Pterodactyl / Pelican

Import the egg, create a server with one port allocation, start. Reinstall to update.

deploy/pterodactyl/egg-pa-coop.json
deploy/pelican/egg-pa-coop.json

Options: PACOOP_PORT · PACOOP_MAX_PLAYERS · PACOOP_UPNP · PACOOP_PUBLIC · PACOOP_VERBOSE

W.Approved by: the Warden

Incident reports

Questions people ask, filed and answered.

Incident #0041

Do my friends need the mod?

Yes. Every player installs it, it is what sends the game to your server. It is one double-click.

Incident #0042

Can I still play on the official servers?

Run the installer again and pick "Back to official multiplayer", or delete the three files.

Incident #0043

Does it touch my saves or the game?

No. It sits next to the game and only redirects online play. Saves and game files stay as they are.

Incident #0044

Do I need my own copy of the game?

Yes. pa-coop ships nothing from the game. Steam or Epic, every player needs a copy.

Incident #0045

What if a friend desyncs?

If the game detects it, the mod asks the host to resend the prison so the player can stay. A safety net, not a guarantee: some desyncs can still end the session.

Incident #0046

Mods and the game's DLC?

Same rules as the official co-op: the game disables mods online, and players should own the same DLC.