This guide covers admin access, game phase configuration, mods, and server management for your Puck dedicated server. For initial setup, see Puck Server Setup Guide.
1. Admin Access
Admin access is controlled through Steam IDs in the server_configuration.json file. To grant yourself admin:
- Find your Steam64 ID (use steamid.io).
- Edit
server_configuration.jsonvia SFTP. - Add your Steam ID to the
adminSteamIdsarray:
"adminSteamIds": ["76561198012345678", "76561198087654321"]- Restart the server for changes to take effect.
2. Game Phase Durations
Customize match phase durations (in seconds) in server_configuration.json:
| Phase | Default (seconds) | Description |
|---|---|---|
| Warmup | 600 | Pre-match warmup period. |
| FaceOff | 3 | Puck drop countdown. |
| Playing | 300 | Active gameplay period. |
| BlueScore | 5 | Celebration after blue team scores. |
| RedScore | 5 | Celebration after red team scores. |
| Replay | 10 | Goal replay duration. |
| PeriodOver | 15 | Break between periods. |
| GameOver | 15 | End-of-game scoreboard time. |
Example configuration in server_configuration.json:
"phaseDurationMap": {
"Warmup": 300,
"FaceOff": 3,
"Playing": 600,
"BlueScore": 5,
"RedScore": 5,
"Replay": 10,
"PeriodOver": 15,
"GameOver": 15
}3. Server Settings
Additional settings in server_configuration.json:
| Setting | Default | Description |
|---|---|---|
voip |
false | Enable voice chat. |
isPublic |
true | Show server in the public server list. |
startPaused |
false | Start the server in a paused state. |
allowVoting |
true | Allow players to vote on map changes and settings. |
sleepTimeout |
60 | Seconds before the server sleeps when empty. |
joinMidMatchDelay |
10 | Seconds a player must wait when joining mid-match. |
usePuckBannedSteamIds |
true | Use the global Puck ban list. |
printMetrics |
true | Print server performance metrics to the console. |
4. Mods
Puck supports Steam Workshop mods. Configure them in the mods array of server_configuration.json:
"mods": [
{
"id": 3493628417,
"enabled": true,
"clientRequired": false
}
]- id: The Steam Workshop item ID.
- enabled: Whether the mod is active.
- clientRequired: Whether players must have the mod installed to join.
5. Banning Players
To ban players, add their Steam IDs to a ban list file on the server, or enable usePuckBannedSteamIds to use the global community ban list. You can also set reloadBannedSteamIds to true to reload the ban list without restarting.
6. Troubleshooting
- Server not in browser: Ensure
isPublicistrueinserver_configuration.json. Wait forServer authenticatedin the console. - Physics feel off: Check your tick rate settings. Higher tick rates provide smoother physics but require more CPU. Keep
FRAME_RATE10-20 aboveSERVER_TICK_RATE. - Players getting kicked: Increase
KICK_TIMEOUTif players are being kicked for AFK too quickly. - Mods not loading: Verify the Workshop item ID is correct and
enabledis set totrue.
Related Articles
Need Help?
If you need further assistance, open a support ticket with your server IP and any error messages from the GPanel console.
