Minecraft plansGuide

Connect a proxy to your Minecraft servers

A proxy is the front door of a network. Players connect to the proxy, and it sends them to your own Minecraft servers. You need at least one game server, at ClanNode or elsewhere, before anyone can play.

Not a playable server

Ordering a proxy does not change or replace a Paper, Purpur, Vanilla or Fabric server. Each server is a separate order, and you link them yourself with the steps below.

What you need

One proxy server (Velocity or BungeeCord) and at least one game server.
The address of each game server: its IP and port, shown in your game panel.
Access to the files of both servers in the game panel (Files tab) to edit the configuration.

Velocity

On the proxy, open velocity.toml and replace the placeholder lobby line with your game server:
```
[servers]
lobby = "YOUR-SERVER-IP:25565"
try = ["lobby"]
```
Still in velocity.toml, keep modern forwarding on and note the file named forwarding.secret on the proxy; it holds the shared secret.
```
player-info-forwarding-mode = "modern"
```
On the Paper (or Purpur) server, open config/paper-global.yml, enable Velocity forwarding and paste that secret; then set online-mode to false in server.properties.
```
proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: "paste the contents of forwarding.secret"
```

BungeeCord

Read Keep it safe below before you use BungeeCord.

On the proxy, open config.yml and replace the placeholder lobby entry with your game server:
```
servers:
  lobby:
    address: YOUR-SERVER-IP:25565
    restricted: false
```
On the game server, set settings.bungeecord to true in spigot.yml, and set online-mode to false in server.properties.
```
settings:
  bungeecord: true
```
Restart the game server first, then the proxy. Players now join through the proxy address.

Keep it safe

Use Velocity with modern forwarding. Your Paper server then only lets in players who come through the proxy with the shared secret, so keep that secret private. BungeeCord's forwarding has no such check, and game servers at ClanNode can be reached directly, so a game server switched to offline mode for BungeeCord would let anyone join under any name. Open a support ticket before you switch a game server to offline mode for BungeeCord.