Commandes admin Palworld, RCON et API REST : le guide complet

Quand on fait tourner un serveur Palworld, on découvre vite que le vrai travail commence après l'installation : modérer les joueurs, sauvegarder le monde à temps et planifier les redémarrages sans que la moitié de la communauté se retrouve déconnectée en plein combat de boss. Palworld vous donne trois outils pour cela : les commandes admin en jeu, l'ancien protocole RCON et l'API REST. Ces deux derniers font l'objet de beaucoup de confusion en ligne, car bon nombre de guides d'administration recommandent encore RCON — alors que la documentation officielle du serveur a entre-temps déclaré RCON obsolète (deprecated) et annonce qu'il cessera de fonctionner dans une future mise à jour. Dans ce guide, nous faisons le point sur la situation actuelle, vérifiée sur la syntaxe 1.0.

D'abord : définir le mot de passe admin

Tout commence par le mot de passe admin. Ouvrez PalWorldSettings.ini sur votre serveur et renseignez un mot de passe solide dans AdminPassword :

AdminPassword="kies-iets-sterks"

Redémarrez le serveur pour charger la modification. En jeu, ouvrez ensuite le chat et identifiez-vous comme administrateur :

/AdminPassword kies-iets-sterks

À partir de ce moment, le serveur accepte vos commandes admin. Prenez ce mot de passe au sérieux : ce même mot de passe sera bientôt aussi votre accès à l'API REST, et quiconque le connaît peut mettre votre serveur à genoux. Votre serveur tourne encore sur une ancienne version ? Notre base de connaissances vous explique comment mettre à jour votre serveur Palworld vers la 1.0.

Toutes les commandes en jeu en un coup d'œil (1.0)

Voici le jeu de commandes officiel complet. Vous les tapez dans le chat en jeu, après vous être identifié avec /AdminPassword :

Les Steam ID dont vous avez besoin pour expulser, bannir et téléporter s'obtiennent avec /ShowPlayers. Deux conseils pratiques : les messages contenant des espaces ne passent pas toujours correctement, utilisez donc au besoin des underscores (/Broadcast Herstart_over_5_minuten). Et réservez /DoExit aux urgences ; pour un arrêt normal, /Shutdown avec un compte à rebours propre reste toujours le meilleur choix.

Pourquoi n'existe-t-il pas de /give ?

La question la plus googlée chez les nouveaux admins : comment rendre ses objets à un joueur après un crash, ou comment faire apparaître un Pal ? La réponse honnête : c'est impossible. Sur les serveurs dédiés, Palworld n'a pas de /give, pas de commandes de spawn et aucun moyen de distribuer de l'XP ou des objets. Le jeu de commandes officiel est un pur outil d'administration de serveur — modérer, sauvegarder, arrêter — et non une console de triche comme celle que vous connaissez peut-être d'autres jeux de survie.

Si vous voulez malgré tout ajuster les curseurs, deux pistes existent. Les paramètres du monde comme les taux de drop et les multiplicateurs d'XP se règlent dans PalWorldSettings.ini ; c'est ainsi que vous pilotez toute l'économie de votre serveur. Et pour du vrai spawn d'objets, il existe des mods, mais ils apportent leur propre maintenance et un risque de crash. Ne promettez donc pas à vos joueurs des objets de compensation après un incident : c'est tout simplement impossible avec les moyens que le jeu vous donne. Un bon planning de sauvegardes évite plus de frustration qu'une commande give ne l'aurait jamais fait.

RCON est officiellement obsolète

RCON est le protocole classique de console à distance que vous connaissez peut-être d'autres serveurs de jeu. Palworld le prend encore en charge (port 25575 par défaut, activable avec RCONEnabled=True), mais la documentation officielle du serveur est limpide : RCON est obsolète, utilisez l'API REST, et RCON est censé cesser complètement de fonctionner dans une prochaine mise à jour.

À cela s'ajoute le fait que l'implémentation de RCON dans Palworld n'a jamais été tout à fait aboutie. Elle contient un bug connu qui déforme les noms de joueurs comportant des caractères multi-octets (pensez aux noms japonais ou chinois), ce qui rend la modération par nom peu fiable. Le conseil est donc simple : ne construisez rien de nouveau sur RCON, et si vous avez des scripts ou outils existants qui en dépendent, migrez-les vers l'API REST avant qu'une mise à jour ne les casse. Si vous tombez en ligne sur un guide qui vous fait configurer RCON en détail, regardez la date de publication — il y a fort à parier qu'il a été écrit avant l'arrivée de l'API REST.

L'API REST : le nouveau standard

L'API REST est la voie officielle pour administrer votre serveur en dehors du jeu. Vous l'activez dans PalWorldSettings.ini :

RESTAPIEnabled=True
RESTAPIPort=8212

Après un redémarrage, l'API écoute sur le port 8212 et utilise l'authentification HTTP Basic : nom d'utilisateur admin, mot de passe votre AdminPassword. Tous les endpoints se trouvent sous /v1/api/. Un premier test depuis le serveur lui-même :

curl -u admin:kies-iets-sterks http://localhost:8212/v1/api/info

Vous recevez du JSON avec, entre autres, la version et le nom du serveur. L'API sait faire tout ce que font les commandes en jeu — announce (broadcast), kick, ban, unban, save et shutdown — mais elle offre en plus trois fonctions qui n'existent que via l'API :

• /v1/api/settings — consulter les paramètres actifs du serveur ;
• /v1/api/metrics — des données serveur en direct comme le framerate, l'uptime et le nombre de joueurs ;
• le world actor snapshot — un instantané des objets du monde, surtout intéressant pour les outils externes.

metrics en particulier vaut de l'or : il vous permet de surveiller la santé de votre serveur sans vous connecter au jeu. Un framerate serveur en baisse est par exemple le premier signe que la fameuse fuite de mémoire refait des siennes.

Automatiser : sauvegardes et redémarrages planifiés

Le grand avantage d'une API HTTP : tout ce qui peut appeler curl peut administrer votre serveur. Deux exemples que pratiquement chaque administrateur souhaite. D'abord les sauvegardes automatiques, ici toutes les 30 minutes via cron :

*/30 * * * * curl -s -u admin:kies-iets-sterks -X POST http://127.0.0.1:8212/v1/api/save

Et un redémarrage propre : d'abord prévenir, puis arrêter avec un compte à rebours. Votre gestionnaire de processus (ou le panneau d'hébergement) relance ensuite automatiquement le serveur :

curl -u admin:kies-iets-sterks -X POST http://127.0.0.1:8212/v1/api/announce \
  -H "Content-Type: application/json" \
  -d '{"message": "Server herstart over 5 minuten"}'

curl -u admin:kies-iets-sterks -X POST http://127.0.0.1:8212/v1/api/shutdown \
  -H "Content-Type: application/json" \
  -d '{"waittime": 300, "message": "Herstart over 5 minuten"}'

Notez que les messages de l'API acceptent très bien les espaces. Une dernière remarque importante : n'exposez jamais le port 8212 sur Internet. L'API parle du simple HTTP et votre mot de passe admin voyage avec chaque requête ; la documentation elle-même précise que l'API n'est pas conçue pour être accessible publiquement. Gardez-la sur localhost ou au sein de votre propre réseau et protégez-la avec un pare-feu.

Comment cela fonctionne dans le panneau MC-Node

Si votre serveur tourne chez MC-Node, vous n'avez pas besoin de bricoler vous-même avec cron et curl pour la gestion quotidienne. Dans le panneau, vous modifiez PalWorldSettings.ini via le gestionnaire de fichiers (renseigner le mot de passe admin, activer l'API REST), vous suivez les logs en direct et vous démarrez, arrêtez ou redémarrez le serveur en un clic. Les redémarrages planifiés et les sauvegardes automatiques se configurent dans le panneau — et justement avec Palworld, réputé pour sa consommation de mémoire lors des longues périodes d'activité, vous voulez activer ces redémarrages dès le premier jour. L'API reste par ailleurs pleinement disponible pour qui veut automatiser davantage ou superviser depuis l'extérieur.

Pas encore de serveur à vous ? Dans la boutique Palworld de MC-Node, vous démarrez à partir de € 6,00 par mois, sur notre propre matériel avec stockage NVMe dans le datacenter Previder à Hengelo, protection DDoS incluse et résiliable chaque mois.

À lire aussi

• Palworld Awakening et Radiant Gems : le nouvel endgame expliqué
• Palworld 1.0 : les meilleurs emplacements de base par ressource