Project Zomboid × LibertyTalk : Talky

Talky relie vos événements Twitch et YouTube à votre partie de Project Zomboid. Quand Bob suit votre chaîne, un bandeau annonce son arrivée et, deux secondes plus tard, un zombie apparaît à une dizaine de cases de votre personnage, avec « Bob » écrit en violet au-dessus de sa tête. Talky se compose de deux pièces : un mod pour le jeu et un petit programme, le pont (« Bridge » dans le menu du jeu), qui tourne sur votre PC.

Pourquoi un pont ? Le Lua de Project Zomboid ne peut pas recevoir d'appel réseau : il sait seulement lire et écrire des fichiers dans %USERPROFILE%\Zomboid\Lua. Le pont reçoit les appels de LibertyTalk sur http://127.0.0.1:7420 et écrit les actions dans ce dossier, que le mod lit chaque seconde.

La partie 1 installe Talky et le relie à LibertyTalk avec le widget officiel. La partie 2 explique les workflows des deux côtés, pour que vous puissiez changer ce qui se passe dans la partie quand un viewer offre 500 bits.

Ce qu'il vous faut

• Windows 10 ou 11.
• Project Zomboid Build 42, version 42.20.1 ou plus récente. Cette partie décrit le solo ; pour un serveur, voir la partie 3.
• Node.js version 18 ou plus récente, pour faire tourner le pont.
• cloudflared, l'outil de Cloudflare qui donne une adresse publique au pont.
• Un compte LibertyTalk avec votre chaîne Twitch ou YouTube connectée à votre communauté.

Node.js et cloudflared s'installent avec deux commandes dans un terminal PowerShell :

winget install OpenJS.NodeJS.LTS
winget install --id Cloudflare.cloudflared

Récupérer Talky

Talky se télécharge à deux endroits. Le Steam Workshop distribue le mod seul : il refuse les fichiers .bat, .exe et .zip, et réécrit son dossier à chaque mise à jour, ce qui effacerait la configuration du pont. Les releases GitHub contiennent le pont, start-bridge.cmd qui le lance, et une copie du mod pour jouer sans le Workshop.

• Talky sur le Steam WorkshopLe mod, tenu à jour par Steam. Abonnez-vous à l'élément Talky.
• Releases GitHub de TalkyLe zip Windows : le pont, start-bridge.cmd et une copie du mod.

Installer

1. 1

   Étape 1

   Extrayez le zip dans un dossier que vous gardez

   Par exemple Documents\Talky. Ne le décompressez ni dans %USERPROFILE%\Zomboid\mods ni dans le dossier du Workshop. Steam réécrit le dossier du Workshop à chaque mise à jour, et dans Zomboid\mods, supprimer ou remplacer un mod peut emporter le pont avec son fichier bridge\config.json. Le pont signale à chaque démarrage un dossier rangé dans Zomboid\mods.

2. 2

   Étape 2

   Sans le Workshop seulement : copiez le mod

   Copiez le dossier Talky du zip dans %USERPROFILE%\Zomboid\mods, pour obtenir %USERPROFILE%\Zomboid\mods\Talky\42\mod.info. Ne copiez que ce dossier : le pont reste dans Documents\Talky. Si vous êtes abonné sur le Workshop, sautez cette étape : Steam installe déjà le mod.

Il n'y a rien d'autre à installer : le pont crée sa configuration lui-même, à son premier lancement.

Lancer le pont

Double-cliquez sur start-bridge.cmd. Une fenêtre noire intitulée « Talky bridge » s'ouvre. Elle vérifie que Node.js 18 ou plus est installé, puis lance le pont. Au premier lancement, le pont crée bridge\config.json à partir de bridge\config.example.json : il tire au sort un jeton de 48 caractères, règle la langue des exemples sur celle de Windows (fr si le format régional est le français, en sinon) et copie le jeton dans le presse-papiers sans l'afficher. Vous le collerez dans le widget à la fin de cette partie. La fenêtre affiche ensuite ces lignes, chacune précédée de l'heure :

created ~\Documents\Talky\bridge\config.json with a random token (language: en)
the token is in your clipboard and in config.json, never shown here: paste it into "Bridge token" in the LibertyTalk widget
created ~\Zomboid\Lua\talky_config.json from config.json
config loaded: 10 webhook(s), 14 workflow(s)
Talky bridge 0.4.0 listening on http://127.0.0.1:7420
game folder: ~\Zomboid\Lua
http steps allowed to: *.liberty-talk.com
  webhook  POST /hooks/follow
  webhook  POST /hooks/sub
  webhook  POST /hooks/gift
  webhook  POST /hooks/bits
  webhook  POST /hooks/raid
  webhook  POST /hooks/donation
  webhook  POST /hooks/superchat
  webhook  POST /hooks/member
  webhook  POST /hooks/command
  webhook  POST /hooks/points

À chaque démarrage, le pont peut aussi afficher des lignes qui commencent par warning:. Il démarre quand même, mais chacune signale un réglage à corriger : cloudflared absent du PATH, Talky installé deux fois (une copie dans Zomboid\mods en plus du Workshop), ou dossier du pont rangé dans Zomboid\mods. Le dépannage à la fin de cette partie donne la solution de chacune.

Laissez cette fenêtre ouverte pendant toute la session : si vous la fermez, plus rien n'arrive dans le jeu. Si le pont s'arrête sur une erreur, la fenêtre affiche le message, puis The bridge has stopped., et attend que vous appuyiez sur une touche. Dans ses messages, erreurs sur config.json comprises, le pont écrit ~ à la place de votre dossier utilisateur, ce qui garde votre nom d'utilisateur Windows hors de l'écran si la fenêtre passe en live.

Activer le mod et ouvrir le menu

1. 1

   Étape 1

   Activez le mod

   Dans le menu principal de Project Zomboid, ouvrez Mods et cochez Talky - LibertyTalk Live Events.

2. 2

   Étape 2

   Lancez une partie

   Nouvelle partie solo ou sauvegarde.

3. 3

   Étape 3

   Ouvrez le menu Talky avec F8

   La touche se change dans Options > Raccourcis > Talky, ligne « Ouvrir la fenêtre Talky ».

4. 4

   Étape 4

   Vérifiez la page Statut

   En bas à gauche, la pastille doit afficher « Bridge connecté » en vert, et le haut de la page « Bridge connecté sur le port 7420 - 0 job(s) en attente », suivi de la version du pont, puis la ligne « Solo : les jobs s'exécutent dans cette partie. ». Une pastille rouge « Bridge hors ligne » s'accompagne du message « Bridge hors ligne : lancez start-bridge.cmd (ou node bridge/bridge.js) sur ce PC. ». Dans ce cas, voyez le dépannage à la fin de cette partie.

La fenêtre compte cinq pages, listées à gauche sous « TALKY ». Statut montre la connexion, l'adresse publique et les derniers événements reçus. Webhooks liste les adresses /hooks/<id> que LibertyTalk appelle. Workflows contient ce que le jeu fait pour chaque événement. Événements du jeu relie la mort d'un zombie nommé ou celle du joueur à un workflow. Réglages fixe les plafonds, par exemple « Zombies max par action » à 60. Le bouton Enregistrer, en bas à droite, devient Enregistrer * tant qu'une modification n'est pas enregistrée.

Tester sans LibertyTalk

Avant de brancher Twitch, vérifiez que le pont et le mod se parlent. Dans le menu F8, page Workflows, sélectionnez new_follower dans la liste de gauche, tapez Bob dans le champ « Tester avec le pseudo » puis cliquez sur Tester maintenant. Le jeu confirme l'envoi du test par une notification, et la fenêtre du pont écrit une ligne comme [test] new_follower -> 3 game step(s) (job #1) user=Bob, dont le numéro de job augmente à chaque envoi.

Vous pouvez aussi lancer le test depuis un second terminal ouvert dans le dossier de Talky, pendant que le pont tourne :

node bridge\bridge.js fire new_follower user=Bob

Dans le jeu, le bandeau « Bob rejoint la horde ! » s'affiche (« Bob joins the horde! » avec les exemples en anglais), puis un zombie nommé « Bob » apparaît entre 8 et 14 cases de votre personnage. Si rien ne s'affiche, vérifiez que la partie n'est pas en pause : le mod n'exécute rien en pause, au menu principal ou quand votre personnage est mort. Tester maintenant envoie aussi bits à 500, viewers à 10 et tier à 1000 : sur le workflow bits, il fait apparaître 5 zombies.

Ouvrir le tunnel

LibertyTalk refuse d'appeler une adresse locale comme 127.0.0.1, pour empêcher les requêtes vers des réseaux privés. Le tunnel cloudflared donne au pont une adresse publique en https. Dans un nouveau terminal, lancez :

cloudflared tunnel --url http://127.0.0.1:7420

Facultatif : collez aussi cette adresse dans F8, page Statut, champ « URL publique (tunnel Cloudflare) », puis cliquez sur Enregistrer. La liste des webhooks affiche alors leurs adresses publiques, jeton masqué. Copier la commande copie node bridge\bridge.js url <webhook> pour le webhook sélectionné : lancée dans un terminal ouvert dans le dossier de Talky, cette commande met l'URL complète, jeton compris, dans le presse-papiers et l'affiche masquée. Le jeu ne voit jamais le jeton. Le widget n'en a pas besoin : cette commande sert quand vous construisez vous-même un workflow LibertyTalk.

Installer le widget officiel

Le widget officiel « Project Zomboid · Talky » contient déjà les dix chaînes LibertyTalk qui appellent le pont : follow, abonnement, abonnements offerts, bits, raid, points de chaîne, commande de chat, don Streamlabs, Super Chat et nouveau membre YouTube. Vous remplissez l'adresse du tunnel et le jeton, puis vous l'activez.

1. 1

   Étape 1

   Installez-le dans votre communauté

   Sélectionnez votre communauté dans la barre latérale. Sur la fiche du widget dans la Marketplace, cliquez sur Installer. Le même bouton se trouve sur sa carte dans la Bibliothèque officielle de Widgets. LibertyTalk ajoute le widget à la communauté sélectionnée, désactivé, puis ouvre sa page.

2. 2

   Étape 2

   Gardez la portée Global

   Sur la page du widget, gardez la portée Global, sélectionnée par défaut : le widget écoutera tous les comptes Twitch et YouTube de la communauté. Pour revenir plus tard sur cette page, ouvrez Widgets et cliquez sur la carte Project Zomboid · Talky, sous « Widgets de workflow ».

3. 3

   Étape 3

   Remplissez sa configuration

   Dans l'onglet Configuration du widget, ouvrez la section « Connexion au pont Talky » et remplissez « Adresse publique du pont Talky » et « Jeton du pont ». Le tableau ci-dessous détaille chaque champ. Cliquez sur Enregistrer : le message « Configuration du widget enregistrée. » confirme.

4. 4

   Étape 4

   Activez-le

   Dans le bloc Activation, cliquez sur Activer : la ligne « Inactif sur Global. » devient « Actif sur Global. » et le bloc Écoute liste les comptes écoutés. La page refuse d'activer tant qu'une modification de la configuration n'est pas enregistrée. Si seule votre chaîne Twitch est connectée, les déclencheurs YouTube restent muets ; ils se branchent quand vous connectez YouTube à la communauté.

Vérifier de bout en bout

Demandez à quelqu'un de suivre votre chaîne, ou suivez-la avec un second compte. Quelques secondes plus tard, la fenêtre du pont écrit une ligne [hook:follow] new_follower -> 3 game step(s), le zombie apparaît, et dans F8, page Statut, la liste « Derniers événements reçus par le bridge » affiche hook:follow -> new_follower (Pseudo) précédé de l'heure. Côté LibertyTalk, ouvrez l'onglet Exécutions de la page du widget et cliquez sur « Charger le dernier run » pour voir le même passage.

Dépannage

Deux moteurs, un même modèle

Un workflow LibertyTalk part d'un déclencheur, un événement comme « Nouveau follower », puis exécute ses nœuds dans l'ordre en leur passant les données de l'événement. Le pont Talky a son propre moteur, plus petit : chaque webhook /hooks/<id> lance un workflow du pont, une liste d'étapes que le mod exécute dans la partie.

Retenez cette frontière : LibertyTalk décide quels événements partent vers le jeu et avec quelles données, le pont décide de ce qui se passe dans la partie.

Ce que fait le widget officiel

Le widget contient dix chaînes construites sur le même patron : un déclencheur, un nœud « Si (classique) » qui teste la case de l'événement, puis un « Appel webhook / API (arrière-plan) ». Chaque appel envoie un POST à {talky_bridge_url}/hooks/<id> avec l'en-tête {"X-Bridge-Token":"{talky_token}"}. L'appel part en arrière-plan pour qu'un tunnel lent ne retarde pas les autres événements de votre communauté. La chaîne des abonnements teste aussi is_gift : elle ne relaie que les abonnements qui ne sont pas offerts, la chaîne des cadeaux s'occupe des autres.

Les workflows du pont de la dernière colonne sont ceux livrés avec Talky. Vous les modifiez dans F8, page Workflows, sans toucher au widget. Par exemple, Super Chats et dons partagent donation, qui tire au sort un fusil à pompe avec ses cartouches, un soin avec des conserves, ou un pick-up.

Pour qu'un viewer obtienne un zombie à son nom, passez par un événement qui fournit un pseudo hors du chat : un follow, des bits, ou une récompense de points de chaîne dont le titre contient « zombie ». Cette dernière lance points_zombie, qui nomme le zombie d'après le viewer qui a échangé la récompense.

Les variables

Dans LibertyTalk, une variable s'écrit entre accolades simples. Chaque déclencheur annonce les siennes : « Bits reçus (cheer) » fournit {bits}, {user_name} et {is_anonymous}, et « Récompense (points de chaîne) » fournit {reward_title} et {reward_cost}. Le sélecteur de variables de l'éditeur les propose dans les nœuds qui suivent.

Les variables du widget, {talky_bridge_url}, {talky_token} et {talky_command}, sont remplies à l'installation et relues à chaque exécution. Elles portent le préfixe talky_ parce que les données de l'événement passent en priorité : une variable de widget nommée user_name serait masquée par celle du déclencheur. {talky_token} est déclarée secrète : sa valeur est masquée dans les traces d'exécution.

Une variable mal orthographiée reste telle quelle : avec {user_nmae}, le pont reçoit ce texte et votre zombie s'appelle « {user_nmae} ». Une variable prévue par le déclencheur mais absente de l'événement devient vide, comme {user_name} pour un cheer anonyme ; le pont utilise alors son nom par défaut.

Le pont a ses propres modèles, entre accolades doubles, avec des filtres : {{bits | div:100 | floor}} donne 4 pour 450 bits. {{user}} prend le premier champ rempli parmi user_name, author_display_name, donor et quelques autres, ce qui permet au même workflow new_sub de servir aux abonnés Twitch et aux membres YouTube. Quand aucun de ces champs n'est rempli, {{user}} vaut le nom des événements anonymes.

Décider dans LibertyTalk ou dans le pont

Les deux moteurs ne savent pas faire les mêmes choses. LibertyTalk n'a pas de nœud de boucle ni de calcul : un nœud ne peut pas se répéter « une fois par tranche de 100 bits ». Le pont, lui, ne voit que ce que LibertyTalk lui envoie. Ce tableau indique où placer chaque besoin.

En pratique, laissez LibertyTalk router et filtrer, et donnez au pont les nombres bruts. Le widget suit cette règle : il envoie {bits} tel quel et le pont calcule la taille de la horde.

Exemple 1 · Un follow, un zombie nommé

Quand Bob suit la chaîne, le widget envoie {"user_name":"Bob"} à /hooks/follow. Le pont lance new_follower, qui contient trois étapes :

1. notify : un bandeau avec le pseudo, en violet #b388ff.
2. wait : 2 secondes de pause dans le jeu.
3. spawn_zombie : un zombie nommé {{user}}, entre 8 et 14 cases du personnage, avec son nom affiché de la même couleur.

Pour changer ce zombie, ouvrez F8, page Workflows, new_follower, et double-cliquez sur l'étape du zombie dans la liste des étapes. Cochez « Rampant » pour qu'il rampe, ou passez « Nombre » à 3 : trois zombies apparaissent, nommés « Bob #1 » à « Bob #3 », ou tous « Bob » avec « Même nom pour tous ». Cliquez sur Valider, puis sur Enregistrer : le pont recharge la configuration sans redémarrer.

Exemple 2 · Des bits, une horde à leur mesure

Le widget transmet {bits} sans le transformer, car LibertyTalk ne sait ni diviser un nombre ni répéter un nœud. C'est le workflow bits du pont qui fait le calcul :

"bits": {
  "steps": [
    { "if": { "bits": { "gte": 1000 } },
      "then": [ { "action": "helicopter" } ],
      "else": [
        { "if": { "bits": { "gte": 100 } },
          "then": [
            { "repeat": "{{bits | div:100 | floor}}", "max": 20, "steps": [
              { "action": "spawn_zombie", "name": "{{user}}", "sameName": true, "distance": 18 },
              { "action": "wait", "seconds": 1 }
            ] }
          ],
          "else": [ { "action": "noise", "radius": 25 } ] }
      ] }
  ]
}

• 450 bits : 450 / 100 arrondi à l'entier inférieur donne 4 zombies au nom du viewer, un par seconde, à 18 cases au plus.
• 1 000 bits ou plus : l'hélicoptère passe, sans zombie nommé.
• Moins de 100 bits : un bruit attire les zombies dans un rayon de 25 cases.

Le plafond max: 20 protège la partie si vous retirez la branche de l'hélicoptère : 5 000 bits donneraient sinon 50 zombies. Pour tester sans dépenser de bits, Tester maintenant sur bits envoie 500 bits, soit 5 zombies.

Exemple 3 · Une récompense de points, un événement au choix

Le widget envoie toutes les récompenses de points de chaîne au même webhook, points, avec user_name et reward_title. Le pont choisit le workflow avec des routes : la première dont la condition est vraie gagne. Les routes livrées avec Talky cherchent un mot dans le titre, en français si le pont a été lancé la première fois avec settings.language à fr :

• « hélico » lance points_helicopter : l'hélicoptère passe, une fois toutes les 10 minutes au plus.
• « soin » lance points_heal : soin complet et texte flottant au nom du viewer.
• « tempête » lance points_storm : 3 heures de tempête dans le jeu.
• « zombie » lance points_zombie : un zombie dont le nom, en bleu clair, est le pseudo du viewer qui a échangé la récompense.

La comparaison contains du pont ignore les majuscules : « Appeler l'Hélico » correspond, mais « Appeler l'helico » sans accent ne correspond pas, et un pont resté en anglais cherche helicopter, heal et storm. Des routes en matches acceptent plusieurs graphies et les deux langues. Une récompense qui ne correspond à aucune route ne lance rien : la page Statut l'affiche avec « ignoré : aucune route ne correspond ».

[
  { "when": { "reward_title": { "matches": "h[ée]lico" } },        "workflow": "points_helicopter" },
  { "when": { "reward_title": { "matches": "soin|heal" } },        "workflow": "points_heal" },
  { "when": { "reward_title": { "matches": "temp[êe]te|storm" } }, "workflow": "points_storm" },
  { "when": { "reward_title": { "contains": "zombie" } },          "workflow": "points_zombie" }
]

La même logique dans LibertyTalk

Vous préférez voir l'aiguillage dans l'éditeur de workflows ? Décochez « Envoyer les récompenses de points de chaîne » dans le widget pour éviter les doublons, puis construisez votre propre workflow :

1. 1

   Étape 1

   Le déclencheur

   « Récompense (points de chaîne) » sur votre compte Twitch.

2. 2

   Étape 2

   Un Aiguillage exclusif

   « Aiguillage (switch) » en mode « Exclusif (1er cas vrai) », un cas par récompense, par exemple reward_title « ~ correspond au regex » /h[ée]lico/iu.

3. 3

   Étape 3

   Une variable par cas

   Dans chaque branche, « Définir une variable » nommée talky_hook, avec la valeur helico, soin ou tempete.

4. 4

   Étape 4

   Un seul appel

   Reliez toutes les branches au même « Appel webhook / API (arrière-plan) » : URL https://votre-tunnel.trycloudflare.com/hooks/{talky_hook}, méthode POST, en-têtes {"X-Bridge-Token":"votre jeton"}, corps {"user_name":"{user_name}","reward_title":"{reward_title}"}. Comme ce workflow n'est pas le widget, son adresse est à mettre à jour à chaque nouveau tunnel.

5. 5

   Étape 5

   Les webhooks côté pont

   Dans F8, page Webhooks, créez helico, soin et tempete avec + Nouveau puis Renommer, et associez-les à points_helicopter, points_heal et points_storm.

Un seul appel final plutôt qu'un appel par branche : au-delà de 5 appels HTTP atteignables depuis un même déclencheur, l'éditeur affiche un avertissement à l'enregistrement.

Limiter la fréquence

Chaque workflow du pont a deux délais, réglables dans F8, page Workflows : « Cooldown global (s) » bloque le workflow pour tout le monde, « Cooldown par viewer (s) » pour un même pseudo. Par défaut, points_helicopter attend 600 secondes entre deux hélicoptères, et chat_zombie 20 secondes entre deux zombies.

chat_zombie n'a pas de « Cooldown par viewer (s) » : la commande de chat arrive sans pseudo, tous les viewers portent donc le même nom par défaut, et un délai par viewer y agirait comme un délai global. Pour espacer les !zombie, augmentez son « Cooldown global (s) ».

Côté LibertyTalk, aucun nœud n'est prévu pour ça, mais le nœud de modération « Détecter du spam (répétition / flood) » peut servir de délai : portée network_id, valeur à comparer constante (helico), fenêtre de 600 secondes, « Flood : messages max dans la fenêtre » à 2, puis « Si (classique) » sur is_flood faux. Le premier passage est accepté, les suivants sont bloqués jusqu'à la fin de la fenêtre, qui ne dépasse pas une heure.

Le retour du jeu vers LibertyTalk

Le mod renvoie trois événements au pont : zombie_killed avec name et byPlayer quand un zombie nommé meurt, player_died avec hoursSurvived et zombieKills, et game_started. F8, page Événements du jeu, relie chacun à un workflow du pont. Exemple : poster « Le zombie de Bob est tombé. » dans votre chat Twitch, avec le workflow désactivé report_to_libertytalk que Talky livre pour ça.

1. 1

   Étape 1

   Créez le webhook entrant

   Dans LibertyTalk, créez un workflow avec le déclencheur « Webhook entrant » et enregistrez-le : le champ « URL & secret du webhook » affiche l'adresse, qui se termine par /webhooks/workflow/<jeton>, et le secret.

2. 2

   Étape 2

   Récupérez le nom du zombie

   Dans « Variables depuis le payload », ajoutez la variable cible name avec la clé name.

3. 3

   Étape 3

   Postez dans le chat

   Ajoutez l'action Twitch « Envoyer un message » avec le contenu Le zombie de {name} est tombé., puis activez le workflow.

4. 4

   Étape 4

   Remplissez la cible du pont

   Hors live, ouvrez bridge\config.json dans un éditeur de texte. Dans httpTargets > lt_report, remplacez PASTE_THE_TOKEN_OF_YOUR_INCOMING_WEBHOOK par le jeton qui termine l'adresse du webhook entrant et PASTE_THE_SECRET_OF_YOUR_INCOMING_WEBHOOK par son secret, enregistrez, puis relancez le pont. Ce fichier reste hors de portée du jeu et de ses mods ; tant qu'une valeur PASTE_ reste, le pont refuse l'étape.

5. 5

   Étape 5

   Activez le workflow du pont

   Dans F8, page Workflows, sélectionnez report_to_libertytalk, cochez « Activé », puis cliquez sur Enregistrer. Son étape http indique seulement "target": "lt_report" : l'adresse et le secret ne passent pas par talky_config.json. Si votre talky_config.json vient de Talky 0.3.0, cette étape porte encore url et headers : remplacez-les par "target": "lt_report" (bouton « Workflow en JSON »), sinon le pont envoie l'appel avec un avertissement.

6. 6

   Étape 6

   Reliez l'événement du jeu

   Page Événements du jeu, choisissez report_to_libertytalk pour « Un zombie nommé meurt », puis cliquez sur Enregistrer.

"httpTargets": {
  "lt_report": {
    "url": "https://api.liberty-talk.com/webhooks/workflow/PASTE_THE_TOKEN_OF_YOUR_INCOMING_WEBHOOK",
    "headers": { "X-Webhook-Secret": "PASTE_THE_SECRET_OF_YOUR_INCOMING_WEBHOOK" }
  }
}

"report_to_libertytalk": {
  "enabled": false,
  "steps": [
    { "action": "http", "target": "lt_report",
      "body": { "event": "{{event}}", "name": "{{name}}", "hoursSurvived": "{{hoursSurvived}}", "zombieKills": "{{zombieKills}}" } }
  ]
}

L'hôte api.liberty-talk.com fait partie de httpAllowedHosts par défaut, l'étape passe donc sans réglage. Elle s'exécute en arrière-plan : elle ne retarde ni le jeu ni les autres événements. Relier « Un zombie nommé meurt » à report_to_libertytalk remplace on_zombie_killed, qui fait apparaître dans 30 % des cas deux « cousins » du zombie tué. Pour garder les deux, copiez plutôt l'étape http dans les étapes de on_zombie_killed.

Le corps envoie aussi event, hoursSurvived et zombieKills. Reliez « Le joueur meurt » au même workflow, déclarez aussi les variables event et hoursSurvived dans « Variables depuis le payload », et un « Aiguillage (switch) » avec un cas event égal à player_died peut poster un autre message à votre mort, par exemple Mort après {hoursSurvived} h de survie.

Tester et déboguer

Testez d'abord le pont seul, avec Tester maintenant ou node bridge\bridge.js fire. Pour tester le trajet de LibertyTalk vers le pont sans attendre un vrai follow, créez un workflow avec le déclencheur « Déclenchement manuel » et, dans « Variables simulées », user_name égal à Bob. Ajoutez un « Appel webhook / API » vers https://votre-tunnel.trycloudflare.com/hooks/follow, avec l'en-tête {"X-Bridge-Token":"votre jeton"} et le corps {"user_name":"{user_name}"}. Le bouton de déclenchement manuel fonctionne même si le workflow n'est pas activé.

La console d'exécution montre ce que chaque nœud a reçu et produit. Pour le widget, ouvrez son onglet Exécutions puis cliquez sur « Charger le dernier run ». Chaque étape affiche son entrée et sa sortie, et le bouton « Variables » montre toutes les variables disponibles à ce moment, secrets masqués, {talky_token} compris.

Limites à connaître

• L'adresse du tunnel rapide change à chaque lancement de cloudflared : recopiez-la dans le widget à chaque session, ou passez à un tunnel nommé.
• La commande de chat arrive sans pseudo ni texte, à cause de la règle de Twitch sur la redistribution des messages du chat : le zombie de !zombie porte le nom des événements anonymes.
• Un événement attend 15 minutes au plus : si le jeu reste fermé ou en pause plus longtemps, il est abandonné.
• Le pont plafonne chaque workflow : une étape wait dure 600 secondes au plus, les textes de notify, say et halo sont coupés à 200 caractères, un bandeau reste 60 secondes au plus, et un repeat ne dépasse jamais 100 tours, quel que soit son max.
• Les Super Chats et les membres YouTube n'arrivent que pendant un live, et les dons que si Streamlabs est relié.
• Talky 0.5.0 a été testé sur la Build 42.21. Une mise à jour du jeu peut changer les fonctions qu'il utilise : mettez à jour le mod et le pont ensemble.

Sur un serveur, dédié ou hébergé depuis le menu principal du jeu, le pont ne tourne pas sur le PC des streamers : l'admin le lance sur la machine du serveur et ajoute les streamers depuis le jeu. Chaque streamer reçoit une adresse et un jeton, qu'il colle dans son widget LibertyTalk. Les effets de son live se produisent autour de son personnage, et tous les joueurs les voient.

• L'admin du serveur installe le mod sur le serveur, lance le pont à côté, ouvre un port et ajoute les streamers.
• Chaque streamer rejoint le serveur, installe le widget LibertyTalk et y colle l'adresse et le jeton reçus. Rien d'autre à installer sur son PC que le mod, que le serveur demande de toute façon.

Pour l'admin : préparer le serveur

1. 1

   Étape 1

   Ajoutez Talky aux mods du serveur

   Serveur dédié : dans Zomboid/Server/<nom du serveur>.ini, mettez Mods=Talky et WorkshopItems=3830066321, l'id de Talky sur le Steam Workshop. Le serveur télécharge le mod au démarrage, et chaque joueur le reçoit en se connectant. Partie hébergée : Héberger > Modifier les réglages..., page Mods, puis page Workshop Steam.

2. 2

   Étape 2

   Réglez les limites

   Les options de Talky sont sur la page Talky des options bac à sable : limites de zombies, d'objets et de météo, un interrupteur par catégorie, délais, distance des autres joueurs. Le feu et l'hélicoptère sont désactivés par défaut sur un serveur.

1. 1

   Étape 1

   Installez Node.js 18 ou plus sur la machine du serveur

   Sous Windows : winget install OpenJS.NodeJS.LTS. Sous Linux : le paquet nodejs de la distribution s'il est en version 18 ou plus, sinon celui de nodejs.org.

2. 2

   Étape 2

   Décompressez le zip de Talky

   Téléchargez Talky-0.5.0.zip dans les releases GitHub et décompressez-le dans un dossier du compte qui lance le serveur.

3. 3

   Étape 3

   Lancez le pont en mode serveur

   Avec le compte qui lance le serveur : sh start-bridge.sh sous Linux, start-bridge.cmd server dans un terminal ouvert dans le dossier de Talky sous Windows. Partie hébergée : start-bridge.cmd server sur le PC de l'hôte. La fenêtre du pont affiche listening on http://0.0.0.0:7420 (server mode).

4. 4

   Étape 4

   Démarrez le serveur

   Sa console affiche [Talky] server ready (Talky 0.5.0), puis [Talky] inbox ready à la première lecture des jobs.

1. 1

   Étape 1

   Ouvrez le port TCP 7420

   Dans le pare-feu de la machine (sous Linux, par exemple sudo ufw allow 7420/tcp ; sous Windows, une règle entrante TCP 7420) et dans celui de l'hébergeur s'il y en a un. Partie hébergée : redirigez aussi le port TCP 7420 de la box vers le PC de l'hôte.

2. 2

   Étape 2

   Notez l'adresse publique du pont

   http://<IP publique du serveur>:7420. Une adresse privée (192.168.…, 10.…) ne marche pas : LibertyTalk doit joindre le pont depuis internet.

1. 1

   Étape 1

   Passez admin

   La page Webhooks de F8 est réservée aux admins et aux modérateurs. Serveur dédié : tapez setaccesslevel "<nom d'utilisateur>" admin dans la console du serveur, ou connectez-vous avec le compte admin créé au premier démarrage. Partie hébergée : voir l'encadré plus bas.

2. 2

   Étape 2

   Enregistrez l'adresse publique

   En jeu : F8 > Webhooks > onglet Streamers. Tapez l'adresse notée plus haut dans Adresse publique du bridge, puis Enregistrer. L'IP seule suffit : Talky ajoute http:// et le port du pont.

3. 3

   Étape 3

   Ajoutez chaque streamer

   Tapez son nom d'utilisateur en bas à gauche, puis + Ajouter un streamer. Une seconde plus tard, le pont lui a tiré un jeton et il apparaît dans la liste.

4. 4

   Étape 4

   Envoyez-lui son adresse et son jeton

   Choisissez-le, puis Copier l'URL et le jeton : le presse-papiers contient les deux valeurs de son widget, une par ligne. Envoyez-les en message privé.

Pour le streamer : brancher son live

1. 1

   Étape 1

   Rejoignez le serveur

   Le mod Talky vient avec la liste des mods du serveur : le jeu le télécharge à la connexion.

2. 2

   Étape 2

   Installez le widget

   Dans le dashboard LibertyTalk : Marketplace > Project Zomboid · Talky > Installer, puis ouvrez sa page dans Widgets, comme dans la partie 1.

3. 3

   Étape 3

   Collez l'adresse et le jeton

   Onglet Configuration du widget : Adresse publique du pont Talky = l'adresse reçue de l'admin, Jeton du pont = votre jeton. Enregistrer, puis Activer.

4. 4

   Étape 4

   Vérifiez en jeu

   F8 > Statut affiche « Vous êtes streamer ici : les événements de votre live se produisent autour de votre personnage. »

Ports et sécurité

• Un seul port à ouvrir : TCP 7420 (port de bridge/config.json), vers la machine qui fait tourner le pont. Le serveur du jeu garde ses propres ports.
• Les appels de LibertyTalk arrivent en http, en clair : le jeton du streamer circule en clair entre LibertyTalk et le pont. Quelqu'un qui intercepte ce trafic pourrait le réutiliser jusqu'au prochain Nouveau jeton.
• Le jeton d'un streamer ne déclenche que des effets autour de ce streamer, dans les limites des options bac à sable du serveur.

Limites

• La machine du serveur doit pouvoir lancer Node.js et être joignable depuis internet sur le port du pont. Un serveur loué sans accès à la ligne de commande, géré seulement par un panneau web, ne convient pas.
• Un seul jeu de workflows pour tout le serveur : chaque streamer reçoit les mêmes effets, autour de son propre personnage. Les délais comptent par streamer.
• La météo et l'heure sont les mêmes pour tous les joueurs, et leurs délais comptent pour tout le serveur.
• L'hélicoptère va vers un joueur au hasard : il est désactivé par défaut et, une fois activé, ne part que si un seul joueur est connecté (sauf option contraire).
• Les jobs d'un streamer hors ligne attendent son retour, 15 minutes au plus ; au-delà, ils sont abandonnés.
• Les effets autour d'un streamer évitent les autres joueurs (15 cases par défaut) et les refuges où il n'a pas accès.

Dépannage