Ce qu’il vous faut
- Système d’exploitation : une machine Linux 64 bits (le serveur dédié Linux a besoin de
start_server.sh) ou Windows (le développeur a ajouté une build de serveur dédié Windows dans la Build 174.2).
- Matériel : le développeur ne publie pas de configuration requise pour le serveur dédié. La page Steam n’indique que ce dont le client du jeu a besoin.
- Réseau : le port de jeu, 7777 dans la configuration d’exemple ci-dessous, joignable depuis internet. Dans nos tests, le serveur a journalisé son écoute de jeu en UDP sur ce port. Depuis B897, le développeur indique que le navigateur de serveurs interroge les serveurs et lit leur état en TCP, sans nommer le port.
- Compte Steam : inutile pour télécharger le serveur. Notre commande d’installation utilise
+login anonymous.
- Le jeu : Puck est gratuit sur Steam pour Windows, macOS et Linux, vos amis n’ont donc rien à acheter pour vous rejoindre.
Le logiciel serveur est gratuit. Vous payez la machine, l’électricité et la bande passante, pas le logiciel.
Option 1 : l’héberger vous-même
Il y a deux façons de faire tourner votre propre serveur. La rapide est intégrée au jeu : depuis la Build 174.2, le menu New Server a un onglet SELF HOSTED qui héberge un serveur sur votre propre PC, et Puck tente de rediriger les ports avec uPnP, ce que certains routeurs et fournisseurs d’accès n’autorisent pas. Pour un serveur qui reste allumé, utilisez le serveur dédié ci-dessous.
Linux (Debian ou Ubuntu)
- Installez la bibliothèque dont SteamCMD a besoin, et curl pour l’étape suivante.
sudo apt-get update
sudo apt-get install lib32gcc-s1 curl
- Créez un utilisateur
steam et installez SteamCMD avec cet utilisateur. Valve prévient que lancer SteamCMD en root est un risque de sécurité.
sudo useradd -m steam
sudo -iu steam
mkdir ~/Steam && cd ~/Steam
curl -sqL "https://client-update.steamstatic.com/installer/steamcmd_linux.tar.gz" | tar zxvf -
- Téléchargez le serveur.
~/Steam/steamcmd.sh +quit
~/Steam/steamcmd.sh +force_install_dir /home/steam/puck +login anonymous +app_update 3481440 validate +quit
La première ligne laisse un SteamCMD tout neuf se mettre à jour avant le vrai téléchargement. Notre script d’installation fait pareil puis réessaie jusqu’à trois fois, car Steam répond parfois « Failed to install app (Missing configuration) » et SteamCMD termine quand même par « success ». Vérifiez que /home/steam/puck/steamapps/appmanifest_3481440.acf existe. Sinon, relancez le téléchargement.
- Écrivez un fichier de configuration nommé
server_config.json dans /home/steam/puck. C’est le fichier que le serveur a lu au démarrage dans nos tests (son journal indique Deserializing server config from file (./server_config.json)) et celui que crée notre installation :
{
"port": 7777,
"name": "My Puck Server",
"maxPlayers": 12,
"password": "",
"tickRate": 200,
"isPublic": true,
"useVoip": false,
"useWhitelist": false,
"mods": [],
"gameMode": "public",
"level": "default"
}
Un password vide signifie que n’importe qui ayant l’adresse peut rejoindre. Mettez isPublic sur false pour garder le serveur hors du navigateur de serveurs : depuis la Build 174, le navigateur respecte ce réglage.
- Démarrer le serveur avec le lanceur, pas avec l’ancien exécutable. Depuis la Build 202, le serveur Linux a besoin de
start_server.sh pour que la bibliothèque de l’API Steam se charge. Il transmet tous les arguments à Puck.
cd /home/steam/puck
chmod +x start_server.sh
./start_server.sh
Si votre build ne trouve pas le fichier dans ce dossier, le développeur indique que le chemin de la configuration peut être défini avec l’argument de lancement --serverConfigurationPath (Build 174), et celui de la liste de bannissements avec --bannedSteamIdsPath.
- Ouvrez les ports. Autorisez votre port de jeu dans le pare-feu de la machine (avec ufw :
sudo ufw allow 7777, qui l’ouvre en TCP et en UDP), puis redirigez-le sur votre routeur vers cette machine. Le jeu lui-même écoute en UDP. Le développeur dit que le navigateur de serveurs joint les serveurs en TCP sans dire sur quel port ; si Direct Connect fonctionne et que le navigateur n’affiche pas votre serveur, c’est donc cette connexion qu’il faut vérifier.
- Testez. Cherchez le nom de votre serveur dans le navigateur de serveurs de Puck, ou utilisez Direct Connect avec votre IP publique et le port. Le développeur a fait de Direct Connect un bouton natif dans la Build 1153, les outils de débogage F5 ne sont donc plus nécessaires.
Windows
- Installez SteamCMD depuis
https://client-update.steamstatic.com/installer/steamcmd.zip dans un dossier comme C:\steamcmd.
- Téléchargez le serveur. L’app Steam 3481440 a une build Windows en plus de celle de Linux (le développeur l’a ajoutée dans la Build 174.2) ; le même téléchargement SteamCMD fonctionne donc avec un dossier Windows :
C:\steamcmd\steamcmd.exe +force_install_dir C:\puck +login anonymous +app_update 3481440 validate +quit
- Créez
server_config.json dans C:\puck comme à l’étape 4 de Linux et lancez Puck.exe, le programme Windows que Steam indique pour cette app. Nous avons fait tourner et vérifié le serveur Linux, pas le serveur Windows ; s’il ne prend pas le fichier, passez-lui son chemin avec --serverConfigurationPath. Autorisez votre port de jeu en entrée dans le Pare-feu Windows et redirigez-le sur votre routeur.
Mods
Depuis la Build 202, un serveur peut charger des mods Steam Workshop via une liste mods dans sa configuration. Chaque entrée a l’id de l’élément Workshop, enabled et clientRequired (true oblige les joueurs à télécharger le mod à la connexion, false est pour les mods côté serveur uniquement). L’exemple du développeur :
"mods": [
{ "id": 3493628417, "enabled": false, "clientRequired": true },
{ "id": 3491056040, "enabled": true, "clientRequired": false }
]
Commandes d’administrateur
Selon les annonces du développeur, les administrateurs de serveurs dédiés ont des commandes de chat : /kick, /pause et /resume (Build 171), /ban et /unban par SteamID64 (Build 1153). Les administrateurs du serveur ne peuvent pas être exclus par vote et peuvent rejoindre un serveur plein.
Option 2 : l’héberger sur PlayNHost
La location supprime le pare-feu, la redirection de ports et la routine de mises à jour. Le port et le fichier de configuration sont préparés pour vous.
- Choisissez une offre. Ouvrez la page d’hébergement de serveur Puck et comparez les offres (FACEOFF, SLAPSHOT et OVERTIME au moment de la rédaction, pour 12, 16 et 24 joueurs). Cliquez sur Créer un serveur pour FACEOFF ou SLAPSHOT, ou sur Personnaliser l’offre pour OVERTIME, puis terminez la commande.
- Attendez l’installation. Vous recevez un e-mail « serveur prêt » et le serveur apparaît sur panel.playnhost.com. Dans l’onglet Console, le panel considère le serveur comme démarré quand le journal affiche une ligne contenant
is ready to accept clients on.
- Ouvrez Paramètres, puis Paramètres du jeu. Ces champs sont écrits dans
server_config.json à chaque démarrage du serveur :
- Nom du serveur : le nom affiché dans le navigateur de serveurs.
- Mot de passe du serveur : le mot de passe pour rejoindre. Il est vide au départ, mettez-en un si vous voulez garder la patinoire pour votre groupe.
- Joueurs max. : commence au nombre de joueurs de votre offre et ne peut pas le dépasser.
- Redémarrez. Quand le panel affiche « Enregistré. Le serveur doit redémarrer pour que ces modifications prennent effet. », cliquez sur Redémarrer maintenant et attendez la ligne « ready ».
- Rejoignez. Cherchez le nom de votre serveur dans le navigateur de serveurs de Puck, ou utilisez Direct Connect avec l’adresse et le port du serveur indiqués dans le panel. Saisissez le mot de passe si vous en avez mis un.
Ce que notre installation fait pour vous
- Clés écrites à chaque démarrage. Le panel écrit
name, password, maxPlayers et port dans server_config.json avant le démarrage du serveur. Les modifications manuelles de ces quatre clés sont remplacées au démarrage suivant, changez-les donc dans Paramètres du jeu.
- Les autres clés restent à vous. Notre installation crée le fichier avec
tickRate 200, isPublic true, useVoip false et useWhitelist false, et le panel n’y touche pas. Changez-les sur la page Paramètres, où server_config.json a sa propre entrée, ou modifiez le fichier dans Fichiers serveur arrêté, puis redémarrez-le.
- Le bon fichier de configuration. Certains guides et modèles de la communauté nomment le fichier
server_configuration.json. Dans nos tests, le serveur a lu server_config.json, comme le montre sa propre ligne de journal, c’est donc le fichier que le panel remplit et celui à modifier.
- Vérifications d’installation. Le script d’installation essaie SteamCMD jusqu’à trois fois et considère le manifeste de l’app, et non le code de sortie de SteamCMD, comme preuve que le jeu a été téléchargé.
- Mises à jour au redémarrage. Chaque démarrage cherche sur Steam une build de serveur plus récente et l’installe avant le lancement de Puck ; un redémarrage après un correctif de Puck met donc le serveur à jour.
- Liste de mods. La page Workshop est la voie prévue pour que les mods arrivent dans la liste
mods sur PlayNHost. Nous n’avons pas encore confirmé sur un serveur réel que les mods ajoutés ainsi se chargent ; demandez donc au support avant de compter sur l’un d’eux ou de modifier mods à la main.
- Console. L’onglet Console affiche le journal du serveur. Nous ne connaissons pas de console distante (RCON) pour Puck : les commandes d’administrateur se tapent dans le chat du jeu, et celles saisies dans la zone de la console du panel n’atteignent pas le jeu ; un changement de réglages et un redémarrage sont donc votre télécommande.
Auto-hébergement ou location : une comparaison honnête
- Coût. Auto-hébergé : le logiciel est gratuit, vous payez le matériel, l’électricité et la bande passante, ou une machine virtuelle dans le cloud. Loué : un abonnement mensuel selon l’offre. Voyez les offres actuelles.
- Disponibilité. Auto-hébergé : aussi fiable que votre machine et votre connexion à domicile, et il doit rester allumé quand vos amis jouent. Loué : tourne sur le matériel de l’hébergeur, pas sur votre PC.
- Exposition réseau. Auto-hébergé : les joueurs se connectent à votre IP publique, et vous gérez le pare-feu et le routeur. Loué : votre IP personnelle n’intervient pas.
- Compétences requises. Auto-hébergé : ligne de commande, redirection de ports et édition de JSON. Tout à fait faisable, et une bonne façon d’apprendre. Loué : un panel web avec des champs de formulaire.
- Mises à jour. Auto-hébergé : arrêtez le serveur, relancez la commande SteamCMD, redémarrez. Loué : aucune routine SteamCMD à exécuter, car chaque démarrage cherche sur Steam une build de serveur plus récente. Après un correctif de Puck, redémarrez le serveur.
L’auto-hébergement vous convient si une machine tourne déjà toute la journée et que vous êtes à l’aise avec les réseaux. La location vous convient si vous préférez ne pas gérer du matériel. Si vous voulez une patinoire pour votre groupe, voyez les offres Puck.
Problèmes courants et solutions
Le téléchargement se termine mais il n’y a aucun fichier de serveur
Cause : SteamCMD a affiché « Missing configuration » et a quand même terminé par « success ». Nous l’avons constaté sur nos propres installations.
Solution : vérifiez que steamapps/appmanifest_3481440.acf existe. S’il manque, relancez +app_update 3481440 validate.
Le serveur n’apparaît pas dans le navigateur de serveurs
Cause : isPublic est sur false, ou le serveur n’est pas joignable de l’extérieur. Le navigateur joint les serveurs en TCP, donc un pare-feu qui ne laisse passer que l’UDP peut masquer un serveur que Direct Connect atteint quand même.
Solution : mettez isPublic sur true, ouvrez et redirigez votre port de jeu, et essayez Direct Connect depuis un ordinateur extérieur à votre réseau.
Mes changements de configuration ne s’appliquent pas
Cause : le fichier a été modifié pendant que le serveur tournait, ou vous avez modifié une clé que le panel réécrit (PlayNHost).
Solution : arrêtez le serveur, modifiez, redémarrez. Sur PlayNHost, changez le nom, le mot de passe, la limite de joueurs et le port dans Paramètres du jeu.
FAQ
Puis-je héberger un serveur Puck gratuitement ?
Oui. Le serveur dédié est sur Steam et se télécharge en connexion anonyme. Vous payez quand même la machine, l’électricité et internet, et il doit rester allumé pendant que les gens jouent.
Dois-je posséder le jeu ?
Non. Puck est gratuit sur Steam, donc tous ceux qui rejoignent peuvent le télécharger sans payer.
Combien de joueurs peuvent rejoindre ?
Vous définissez maxPlayers dans la configuration. Dans la Build 19 (septembre 2024), avant la sortie du serveur dédié, le développeur limitait ses propres serveurs hébergés à 10 joueurs ; il n’a pas publié de plafond pour les serveurs dédiés depuis. Nos offres sont de 12, 16 et 24 joueurs.
Quel port utilise un serveur Puck ?
Le port de jeu est celui indiqué par port dans server_config.json, 7777 dans l’exemple. Dans nos tests, le jeu écoutait en UDP. Depuis B897, le navigateur de serveurs interroge les serveurs en TCP, et le développeur ne nomme pas ce port.
Puis-je ajouter des mods Steam Workshop ?
Oui, depuis la Build 202, via la liste mods montrée plus haut. Les joueurs téléchargent automatiquement tout mod marqué clientRequired à la connexion, et depuis B897 une fenêtre liste d’abord les mods requis.
