Intégrer Discord à un serveur Project Zomboid

Project Zomboid embarque un pont Discord nativement, sans mod ni bot tiers : les messages du chat global du jeu partent dans un salon Discord, et inversement. Ce guide couvre la configuration complète en Build 42, où les clés du fichier servertest.ini ont changé par rapport à Build 41.

Sur un serveur Project Zomboid chez HebergTonServ, l’intégration se configure directement dans servertest.ini via le gestionnaire de fichiers ou en SFTP, sans accès SSH.

⚠️ Le point que 90 % des tutoriels français ratent : en Build 41, on renseignait DiscordChannel et DiscordChannelID. Ces deux clés n’existent plus dans le servertest.ini de Build 42. Elles ont été remplacées par trois salons nommés distincts. Si vous suivez un guide écrit avant 2026, votre intégration ne démarrera jamais.

Les 5 clés de l’intégration Discord en Build 42

Voici la section telle qu’elle apparaît dans le servertest.ini d’un serveur 42.20 :

DiscordEnable=false
DiscordToken=
DiscordChatChannel=
DiscordLogChannel=
DiscordCommandChannel=

Trois salons séparés, c’est le vrai apport de Build 42 : on peut laisser le chat public à toute la communauté et réserver logs et commandes à un salon staff.

Ne confondez pas avec WebhookAddress. Cette clé, située juste au-dessus dans le fichier, est décrite dans la documentation comme l’URL d’un webhook entrant Slack — pas Discord. Y coller une URL de webhook Discord est une erreur fréquente qui ne produit rien.

Étape 1 — Créer le bot Discord

L’intégration passe par un bot, pas par un webhook. Il faut donc en créer un.

1. Ouvrez le portail développeur Discord et cliquez sur New Application.
2. Nommez l’application (le nom s’affichera dans le salon, choisissez celui de votre serveur PZ).
3. Onglet Bot → Reset Token → copiez le token. Il ne s’affiche qu’une fois.
4. Toujours dans l’onglet Bot, activez MESSAGE CONTENT INTENT.

L’étape 4 est celle qui casse le plus d’intégrations. Sans le Message Content Intent, le bot voit passer les messages Discord mais n’en lit pas le contenu : le jeu → Discord fonctionne, Discord → jeu reste muet. Si votre pont est unidirectionnel, c’est là qu’il faut regarder en premier.

Étape 2 — Inviter le bot sur votre serveur Discord

Onglet OAuth2 → URL Generator :

Copiez l’URL générée en bas de page, ouvrez-la, sélectionnez votre serveur Discord, validez.

Vérifiez ensuite que le bot a bien accès aux salons visés : un salon privé dont le rôle du bot est absent de la liste des permissions restera invisible pour lui, même si le bot est sur le serveur.

Étape 3 — Préparer les trois salons

Créez (ou désignez) trois salons textuels. Exemple d’organisation :

Les clés de Build 42 attendent le nom du salon, pas son identifiant numérique — c’est précisément ce qui change par rapport à DiscordChannelID en Build 41. Notez le nom exactement tel qu’il apparaît dans Discord, sans le #.

Si votre panel ou votre template d’hébergeur affiche encore un champ DiscordChannelID, c’est qu’il est resté sur un modèle Build 41. Éditez directement servertest.ini, qui fait toujours foi.

Étape 4 — Remplir servertest.ini

Arrêtez le serveur avant d’éditer. Project Zomboid réécrit servertest.ini à l’extinction et écrase toute modification faite serveur allumé.

DiscordEnable=true
DiscordToken=VotreTokenDeBotIci
DiscordChatChannel=pz-chat
DiscordLogChannel=pz-logs
DiscordCommandChannel=pz-commandes

Puis redémarrez. Le bot doit passer en ligne dans la liste des membres Discord dans les secondes qui suivent le démarrage.

Pour situer ces clés dans l’ensemble du fichier : Configurer servertest.ini Project Zomboid.

Étape 5 — Tester dans les deux sens

1. Jeu → Discord : en jeu, tapez un message dans le chat global (/all). Il doit apparaître dans pz-chat.
2. Discord → jeu : écrivez dans pz-chat. Le message doit s’afficher dans le chat du jeu.

Si seul le sens 1 fonctionne, revenez à l’étape 1 (Message Content Intent). Si aucun des deux ne fonctionne, le bot n’est probablement pas connecté : vérifiez le token et regardez les logs de démarrage du serveur.

Le sens jeu → Discord dépend aussi de GlobalChat : avec GlobalChat=false, il n’y a plus de chat global à relayer.

Sécuriser l’intégration

Le token du bot est un secret au même titre qu’un mot de passe RCON.

1. Ne partagez jamais votre servertest.ini brut sur Discord ou un forum d’entraide — il contient token, Password et RCONPassword. Censurez-les avant.
2. Régénérez le token (Reset Token) dès qu’un membre du staff ayant eu accès au fichier quitte l’équipe.
3. Gardez DiscordCommandChannel en salon privé. Un salon de commandes ouvert à tous revient à distribuer l’accès admin.
4. Donnez au bot le strict minimum de permissions Discord : pas de Administrator, pas de Manage Server.

Le même raisonnement s’applique au RCON : RCON Project Zomboid — activer et sécuriser.

Faut-il un bot tiers à la place ?

L’intégration native fait une chose : le pont de chat. Pour du monitoring (joueurs connectés, RAM, redémarrages annoncés), il faut passer par un bot externe branché sur le RCON.

Les deux cohabitent sans conflit : le natif pour le chat, le RCON pour l’administration.

FAQ

Faut-il un mod pour relier Discord à Project Zomboid ?

Non. L’intégration est intégrée au serveur dédié depuis Build 40 et se configure entièrement dans servertest.ini. Aucun mod côté client ni côté serveur n’est requis, donc aucun risque de désynchronisation de mods.

Pourquoi mon intégration Discord ne fonctionne pas en Build 42 ?

Dans l’immense majorité des cas : vous utilisez DiscordChannel ou DiscordChannelID, des clés de Build 41 qui n’existent plus. Build 42 attend DiscordChatChannel, DiscordLogChannel et DiscordCommandChannel. Deuxième cause : le Message Content Intent non activé dans le portail développeur.

Faut-il mettre le nom du salon ou son ID ?

Le nom du salon, sans le #. C’est le changement majeur apporté par Build 42 : on ne manipule plus l’identifiant numérique à 18 chiffres que réclamait Build 41.

À quoi sert WebhookAddress dans servertest.ini ?

Cette clé est documentée comme une URL de webhook entrant Slack, pas Discord. Elle n’a rien à voir avec les cinq clés Discord* et n’est pas nécessaire au pont Discord.

Peut-on envoyer des commandes admin depuis Discord ?

C’est la vocation de DiscordCommandChannel. Gardez ce salon strictement réservé au staff : y écrire revient à piloter le serveur. Pour une automatisation plus poussée (scripts, cron, annonces), le RCON reste l’outil de référence.

Le serveur doit-il être arrêté pour modifier ces clés ?

Oui. Project Zomboid réécrit servertest.ini quand il s’éteint : une modification faite serveur allumé est écrasée à l’arrêt suivant. Éditez serveur arrêté, puis redémarrez.

Le bot apparaît hors ligne, qu’est-ce que ça veut dire ?

Que le serveur PZ n’a pas réussi à s’authentifier auprès de Discord. Token invalide ou tronqué à la copie dans 95 % des cas, DiscordEnable resté sur false dans les autres. Les logs de démarrage du serveur indiquent lequel des deux.

Conclusion

L’intégration Discord native de Project Zomboid tient en cinq lignes de servertest.ini — à condition d’utiliser les clés de Build 42 (DiscordChatChannel, DiscordLogChannel, DiscordCommandChannel) et non celles de Build 41, et d’avoir activé le Message Content Intent côté portail développeur. Ces deux points expliquent la quasi-totalité des intégrations qui ne démarrent pas.

Pour un hébergeur Project Zomboid avec accès SFTP complet à servertest.ini, gestionnaire de fichiers intégré et console en temps réel, HebergTonServ démarre à 25,90 €/mois.

Pour aller plus loin

• Configurer servertest.ini Project Zomboid
• RCON Project Zomboid : activer, se connecter et sécuriser
• Chat, VOIP et modération sur un serveur Project Zomboid
• Redémarrages automatiques sur un serveur Project Zomboid
• Hébergeur Project Zomboid dès 25,90€/mois