Skip to content

Creating a new server

Connecting the server to Velocity

  • When creating a new server (especially with Paper) remember to configure it to support Velocity by modifing the paper config file

    # config/paper-global.yml
    proxies:
      bungee-cord:
        online-mode: true
      proxy-protocol: false
      velocity:
        enabled: true
        online-mode: false
        secret: 'secret'
    

  • disable online-mode in the server properties

    # server.properties
    network-compression-threshold=256
    online-mode=false
    op-permission-level=4
    

    Why disable online mode?

    When a server is connected to a reverse proxy the authentication of the clients is made by the proxy, in this way the player will be authenticated only when he connects to the network and not at every server switch.

  • In the velocity config file add the server with it's IP pointing to the UUID1 of the server to use the internal NAT and not the external one

    #  In Velocity
    #  velocity.toml
    
    [servers]
        # Configure your servers here. Each key represents the server's name, and the value
        # represents the IP address of the server to connect to.
        hub = "d757552b-2bee-4b38-8c56-674b18dfe0c2:25500"
        limbo = "5d5690e7-49b1-4c8f-b383-e1a863821c36:25501"
    
        example-name = "UUID:port"
    
        # In what order we should try servers when a player logs in or is kicked from a server.
        try = ["hub"]
    

    Can i still use the server actual IP?

    Yes you can but it'll pass throu the LAN NAT and thus will add unnecessary delay to the signal.

    Using the server UUID cannot be done if the connection is not made in the same docker network, in that case you'll need to use it's actual IP.

  • Add it to the Pterodactyl Power Action plugin config with the name of the server (possibly the same used for velocity) and the short-UUID2

    #  In Velocity
    #  plugins/pterodactyl_power_action/config.yml
    
    servers:
      hub:
        identifier: "d757552b"
      limbo:
        identifier: "5d5690e7"
      example-name:
        identifier: "short-UUID"
    

Tip

Remember to add the server to the serevers list before you foger!


  1. The UUID is the unique identifier for servers in the Pelican (and Pterodactyl) echosystem, they can be fount in the server settings tab or in the admin menu of the server 

  2. The short UUID is the first piece of the server UUID, it can be found in the server settings tab or in the admin menu of the server (or in the link pointing to the server ex.: panel.thepacta.net/server/short-UUID/console