# How to Set Up a Minecraft Velocity Proxy (/docs/minecraft/velocity-guide)



Velocity is a modern Minecraft proxy with better security and performance than BungeeCord. It's recommended for new networks.

Setting Up Velocity [#setting-up-velocity]

<div className="fd-steps">
  <div className="fd-step">
    Create a Velocity server [#1-create-a-velocity-server]

    Set up a server with Velocity as the type in `Startup` on the [XGamingServer panel](https://panel.xgamingserver.com).
  </div>

  <div className="fd-step">
    Configure velocity.toml [#2-configure-velocitytoml]

    Go to `Files` and edit `velocity.toml`:

    ```toml
    bind = "0.0.0.0:25577"
    motd = "&aMy Network"
    show-max-players = 100
    player-info-forwarding-mode = "modern"

    [servers]
    lobby = "lobby-ip:lobby-port"
    survival = "survival-ip:survival-port"

    try = ["lobby"]
    ```
  </div>

  <div className="fd-step">
    Configure backend servers [#3-configure-backend-servers]

    On each Paper backend server, edit `config/paper-global.yml`:

    ```yaml
    proxies:
      velocity:
        enabled: true
        online-mode: true
        secret: ""  # Copy from velocity forwarding.secret
    ```
  </div>

  <div className="fd-step">
    Copy the forwarding secret [#4-copy-the-forwarding-secret]

    Find `forwarding.secret` in your Velocity server files and copy its contents into each backend's Paper config.
  </div>

  <div className="fd-step">
    Set online-mode on backends [#5-set-online-mode-on-backends]

    Edit `server.properties` on each backend:

    ```
    online-mode=false
    ```
  </div>
</div>

Velocity vs BungeeCord [#velocity-vs-bungeecord]

| Feature       | Velocity                              | BungeeCord           |
| ------------- | ------------------------------------- | -------------------- |
| Security      | Modern forwarding (secure by default) | Requires BungeeGuard |
| Performance   | Better                                | Good                 |
| Plugin API    | Modern                                | Legacy               |
| Configuration | TOML (cleaner)                        | YAML                 |

> 💡 **Tip:** Velocity's "modern" forwarding mode is inherently secure — no need for BungeeGuard.

See also: [BungeeCord Guide](/docs/minecraft/bungeecord-guide) | [IP Forwarding](/docs/minecraft/bungeecord-ip-forwarding)

If you need help, join our [Discord](https://discord.xgamingserver.com/).