Find The Needle × LibertyTalk : Talky Needle

Talky Needle relie vos événements Twitch et YouTube à votre partie de Find The Needle. Quand Bob suit votre chaîne, un canard en plastique portant le nom « Bob » tombe sur votre tas de foin. Un raid déclenche une avalanche de foin et vous envoie en l'air. Une récompense de points de chaîne peut faire biper votre détecteur jusqu'à « AIGUILLE TROUVÉE ! », avant de révéler que c'était faux.

Ce qu'il vous faut

• Windows 10 ou 11.
• Find The Needle, le jeu complet sur Steam. La démo ne fonctionne pas : le mod se désactive.
• Node.js 18 ou plus récent, pour le pont.
• cloudflared, pour donner une adresse publique au pont.
• Un compte LibertyTalk avec Twitch ou YouTube connecté.

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

Récupérer Talky Needle

• Télécharger Talky NeedleLe fichier TalkyNeedle-0.2.1.zip, avec le mod, le pont et les scripts.
• Node.js
• cloudflared

Installer

1. 1

   Étape 1

   Extrayez le zip dans un dossier que vous gardez

   Par exemple Documents\TalkyNeedle. Le pont et sa configuration restent dans ce dossier, pas dans celui du jeu.

2. 2

   Étape 2

   Fermez le jeu et sauvegardez vos parties

   Vos parties se trouvent dans %APPDATA%\Godot\app_userdata\FindTheNeedle\saves. Copiez ce dossier ailleurs avant de continuer.

3. 3

   Étape 3

   Lancez le script d'installation

   Ouvrez un terminal PowerShell dans le dossier TalkyNeedle et lancez la commande ci-dessous. Le script copie mods\talky_needle à côté de FindTheNeedle.exe et ajoute une ligne TalkyNeedle dans override.cfg. Il garde une copie de ce fichier sous le nom override.cfg.talky-needle.bak.

powershell -ExecutionPolicy Bypass -File tools\install.ps1

Lancer le pont

Double-cliquez sur start-bridge.cmd et laissez la fenêtre ouverte pendant que vous jouez. Le pont ne reçoit des appels que sur votre PC, à l'adresse http://127.0.0.1:7421. Au premier lancement, il crée bridge\config.json avec un jeton aléatoire et copie ce jeton dans le presse-papiers sans jamais l'afficher, pour qu'il reste hors du stream.

created config.json with a random token, copied to your clipboard; never shown here
Talky Needle bridge 0.2.1 (unofficial): webhooks on http://127.0.0.1:7421, game link on port 7422
10 webhook(s), 24 workflow(s), waiting for the game...

Ouvrir le menu F8 et tester

1. 1

   Étape 1

   Chargez une partie à part

   Le foin ajouté par le mod peut rester dans la sauvegarde : gardez votre partie principale de côté pour ce test. Un bandeau « Talky Needle : mod non officiel actif » s'affiche, et le pont écrit game connected.

2. 2

   Étape 2

   Appuyez sur F8

   La fenêtre Talky Needle s'ouvre, avec Bridge connecté en haut à droite. F8 ou Échap la referme.

3. 3

   Étape 3

   Cliquez sur « Canard » dans la page Effets

   Le champ « Pseudo affiché » contient Viewer : fermez la fenêtre, et un canard à ce nom tombe sur le tas.

Vous pouvez aussi lancer un workflow depuis un terminal ouvert dans le dossier bridge, par exemple pour le relier à un Stream Deck :

node bridge.js fire new_follower user=Bob

Ouvrir le tunnel

LibertyTalk refuse les adresses locales : le pont a besoin d'une adresse publique pour recevoir vos événements. Dans une seconde fenêtre, lancez la commande ci-dessous, puis notez l'adresse https://des-mots-au-hasard.trycloudflare.com qu'elle affiche.

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

Relier LibertyTalk

Le widget officiel « Find The Needle · Talky Needle » envoie les événements de votre live au pont, à travers le tunnel. Il est gratuit, et chaque événement a sa case dans sa configuration.

1. 1

   Étape 1

   Installez le widget

   Sélectionnez votre communauté dans la barre latérale. Sur la fiche du widget dans la Marketplace, cliquez sur Installer, puis ouvrez-le dans Widgets et gardez la portée Global.

2. 2

   Étape 2

   Remplissez sa configuration

   Saisissez les trois champs du tableau ci-dessous, puis cliquez sur Enregistrer.

3. 3

   Étape 3

   Activez-le

   Dans le bloc Activation, cliquez sur Activer.

Vérifier de bout en bout

Partie chargée, pont et tunnel ouverts, demandez à un ami de suivre votre chaîne, ou utilisez le test de déclencheur channelFollow de LibertyTalk. Le pont écrit le nom du workflow reçu, et la page Activité du menu F8 affiche l'événement avec le pseudo du viewer.

Dépannage

Ce que font vos événements par défaut

Régler le multiplicateur de bits

Chaque bit ajoute des brins de foin selon le multiplicateur : 10 par défaut, donc 500 bits ajoutent 5000 brins. Changez-le dans la page Réglages du menu F8 (x1, x2, x5, x10 ou x20) pour la session, ou avec bitsMultiplier dans settings de bridgeconfig.json pour le garder. 300 brins tombent à l'écran au plus : le reste s'ajoute directement au tas et au compteur, pour que votre partie ne gèle pas. Le workflow bits plafonne chaque événement à 5000 brins.

Créer des récompenses de points

Le webhook points choisit le workflow selon le titre de la récompense, en français ou en anglais. Créez une récompense Twitch dont le titre contient un des mots ci-dessous : « Coup de vent sur le tas » lance points_gust. La casse ne compte pas, et le premier mot trouvé dans la liste de bridge\config.json l'emporte.

Piloter depuis le menu F8

F9 supprime tous les canards à tout moment. Sinon, un canard disparaît après 3 minutes, ou 15 minutes pour ceux des abonnements et des dons. Les réglages de la page Réglages durent jusqu'au redémarrage du pont. Pour les garder, modifiez settings dans bridge\config.json.

Afficher un message envoyé par LibertyTalk

Le widget n'envoie pas de message. Pour en afficher un depuis LibertyTalk, créez un workflow dans Workflows avec l'action Appel webhook / API vers <adresse du tunnel>/hooks/message, en méthode POST, avec l'en-tête X-Bridge-Token et le corps ci-dessous. Les messages passent l'un après l'autre, 6 secondes chacun, et 20 au plus attendent leur tour.

{ "user_name": "{user_name}", "text": "Merci pour le follow !" }

Modifier les workflows du pont

Les workflows se trouvent dans bridge\config.json, avec la même syntaxe que Talky pour Project Zomboid. Relancez le pont après une modification. L'exemple ci-dessous envoie du foin selon les bits multipliés, avec un maximum de 2000 brins, et 5 canards à partir de 1000 bits.

"bits": {
  "steps": [
    { "action": "hay_rain", "count": "{{bitsMultiplied | clamp:10:2000}}" },
    { "if": { "bits": { "gte": 1000 } },
      "then": [ { "action": "duck", "name": "{{user}}", "count": 5, "size": 2 } ] }
  ]
}

Limiter les abus

Dans settings de bridge\config.json, maxJobsPerMinute plafonne les événements viewers (30 par défaut), blockedActions désactive des actions et safeMode coupe safeModeBlocks, les effets sur le joueur et la caméra par défaut. Chaque workflow accepte aussi cooldownSeconds et userCooldownSeconds. Le menu F8 et la commande fire ignorent ces délais et ce plafond pour que vous puissiez tester.

Prévenir LibertyTalk quand une aiguille est trouvée

1. 1

   Étape 1

   Créez un webhook entrant

   Dans LibertyTalk, créez un workflow avec le déclencheur Webhook entrant. Il fournit une URL et un secret.

2. 2

   Étape 2

   Remplissez la cible du pont

   Dans bridge\config.json, remplacez les valeurs PASTE_... de httpTargets.lt_report. Le pont refuse d'appeler une cible qui contient encore ces valeurs.

3. 3

   Étape 3

   Activez le workflow

   Passez enabled à true dans report_to_libertytalk, puis relancez le pont. À chaque aiguille trouvée, LibertyTalk reçoit event et needlesFound, que votre workflow peut par exemple écrire dans le chat.

Le jeu envoie aussi needle_discovered et pile_replaced. Reliez-les à vos workflows dans gameEvents.