Skip to content

PaperProxy Link

LucasTHCRR edited this page Oct 22, 2026 · 1 revision

PaperProxy Link

PaperStream can pair with PaperProxy, a Velocity fork. Everything is off by default and every part has its own switch.

Setting Default What it does
proxy.link false allows pairing at all
proxy.announce-shutdown true on stop or restart, the proxy moves players to another server or its limbo first, so nobody gets kicked
proxy.configure-forwarding false pairing sets up Velocity forwarding and online-mode by itself. Off: the console shows what to set
proxy.allow-restart false the proxy may restart this server (/paperproxy link restart, rolling restarts)
proxy.shutdown-wait-seconds 5 how long a stop waits for the proxy to move players
proxy.exec-allowed [] commands the proxy may run here. Only the first word counts, * allows everything

PaperProxy needs paperstream-link.enabled = true in paperproxy.toml as well.

Pairing

  1. On the proxy: /paperproxy link pair <server-name> [group]. It shows a one time code, valid for 10 minutes.
  2. On this server: /paperstream pair <proxy-address[:port]> <code>.

The link uses the normal proxy port. It is encrypted, and the code never travels over the network.

Clone this wiki locally