This guide covers how to set up and configure your Puck dedicated server hosted with Legion Hosting. Puck is a physics-based multiplayer hockey game -- no rules, no timeouts, just get the puck in the goal. For admin commands and server management, see Puck Server Admin Guide.
1. Accessing Your Server
- Log in to GPanel.
- Select your Puck server from the server list.
- Your server IP and port are displayed on the Console tab. See How to Find Your Server IP and Port for details.
Note: Ports are randomly assigned unless you have a private IP. Use the port shown in GPanel when connecting.
2. Startup Variables
Configure these settings from the Startup tab in GPanel:
| Variable | Env Name | Default | Description |
|---|---|---|---|
| Max Players | MAX_PLAYERS |
10 | Maximum players (up to 32). |
| Query Port | QUERY_PORT |
7778 | Query port for server browser visibility. |
| Password | SRV_PASSWORD |
(empty) | Password required to join. Leave empty for public access. |
| Kick Timeout | KICK_TIMEOUT |
300 | Seconds before an AFK player is kicked. |
| Target Framerate | FRAME_RATE |
120 | Server framerate. Should be 10-20 above the tick rate. |
| Server Tick Rate | SERVER_TICK_RATE |
100 | Server simulation tick rate (max 360). |
| Client Tick Rate | CLIENT_TICK_RATE |
360 | Client update rate. Should be at least double the server tick rate. Do not exceed 360 unless you know what you are doing. |
| Auto Update | AUTO_UPDATE |
0 | Automatically update the server on startup (1=yes, 0=no). |
3. Configuration File
The server configuration is stored in server_configuration.json in the root directory. The panel automatically updates key values from your startup variables. You can edit additional settings via SFTP:
{
"port": 7777,
"pingPort": 7778,
"name": "My Puck Server",
"maxPlayers": 10,
"password": "",
"voip": false,
"isPublic": true,
"adminSteamIds": [],
"kickTimeout": 300,
"targetFrameRate": 120,
"serverTickRate": 100,
"clientTickRate": 200,
"startPaused": false,
"allowVoting": true,
"mods": []
}4. Connecting to Your Server
- Purchase and install Puck from Steam.
- Launch the game and open the server browser.
- Find your server by name, or use direct connect with your IP and port.
- Enter the password if one is set.
5. First-Time Setup Checklist
- Edit
server_configuration.jsonto set a servername. - Add your Steam ID to the
adminSteamIdsarray for in-game admin access. - Configure tick rates and framerate (keep defaults unless you have a specific need).
- Start the server and verify it shows
Server authenticatedin the console.
Related Articles
Need Help?
If you run into issues with your Puck server, open a support ticket and include your server IP, a description of the problem, and any error messages from the GPanel console.
