Relie ton jeu, ton outil ou ton matériel à Hou.la Connect

Les actions ne portent pas de modèle : le mod reçoit l'identifiant de l'action et ses réglages.

{
  "id": "mon-jeu-godot",
  "nom": "Mon jeu Godot",
  "protocole": "jeu",
  "mode": "mod",
  "description": "Exemple : un jeu Godot 4 .NET piloté par un mod qui se relie à Hou.la Connect.",
  "actions": [
    {
      "id": "ralenti",
      "libelle": {
        "fr": "Ralenti",
        "en": "Slow motion"
      },
      "description": {
        "fr": "Le jeu tourne au ralenti quelques secondes.",
        "en": "The game runs in slow motion for a few seconds."
      },
      "effet": "gene",
      "params": [
        {
          "id": "secondes",
          "type": "entier",
          "min": 1,
          "max": 10,
          "defaut": 3,
          "libelle": {
            "fr": "Durée (secondes)",
            "en": "Duration (seconds)"
          }
        }
      ]
    },
    {
      "id": "soigner",
      "libelle": {
        "fr": "Soigner",
        "en": "Heal"
      },
      "effet": "aide",
      "params": [
        {
          "id": "cible",
          "type": "choix",
          "defaut": "moi",
          "libelle": {
            "fr": "Qui",
            "en": "Who"
          },
          "valeurs": [
            {
              "id": "moi",
              "libelle": {
                "fr": "Le streamer",
                "en": "The streamer"
              }
            },
            {
              "id": "tous",
              "libelle": {
                "fr": "Tout le monde",
                "en": "Everyone"
              }
            }
          ]
        }
      ]
    }
  ],
  "mod": {
    "moteur": "godot",
    "dossier": "mods/MonMod",
    "version": "1.0.0",
    "prerequis": {
      "fr": "Aucun : le jeu charge les mods de son dossier mods.",
      "en": "None: the game loads mods from its mods folder."
    }
  }
}

{param.valeur} est remplacé par le réglage choisi dans le pack ; {sender.name} et {gift.name} par l'événement.

{
  "id": "mon-serveur-rcon",
  "nom": "Mon serveur RCON",
  "protocole": "jeu",
  "mode": "rcon",
  "description": "Exemple : un jeu à serveur dédié qui accepte des commandes RCON.",
  "actions": [
    {
      "id": "gravite",
      "libelle": {
        "fr": "Changer la gravité",
        "en": "Change gravity"
      },
      "effet": "neutre",
      "params": [
        {
          "id": "valeur",
          "type": "entier",
          "min": 100,
          "max": 2000,
          "defaut": 200,
          "libelle": {
            "fr": "Gravité (800 = normale)",
            "en": "Gravity (800 = normal)"
          }
        }
      ],
      "commandes": [
        "sv_gravity {param.valeur}"
      ]
    },
    {
      "id": "annonce",
      "libelle": {
        "fr": "Annonce",
        "en": "Announcement"
      },
      "effet": "neutre",
      "commandes": [
        "say {sender.name} a offert {gift.name} !"
      ]
    }
  ]
}

Le message est du texte, ici du JSON. Pour un choix, la valeur (goblin) remplace le réglage, pas son identifiant.

{
  "id": "mon-jeu-websocket",
  "nom": "Mon jeu WebSocket",
  "protocole": "jeu",
  "mode": "ws",
  "description": "Exemple : un jeu qui écoute déjà un WebSocket sur ce PC (son adresse se saisit dans la connexion, par exemple ws://127.0.0.1:8123).",
  "actions": [
    {
      "id": "ennemis",
      "libelle": {
        "fr": "Faire apparaître des ennemis",
        "en": "Spawn enemies"
      },
      "effet": "gene",
      "params": [
        {
          "id": "nombre",
          "type": "entier",
          "min": 1,
          "max": 10,
          "defaut": 3,
          "libelle": {
            "fr": "Nombre",
            "en": "Count"
          }
        },
        {
          "id": "type",
          "type": "choix",
          "defaut": "petit",
          "libelle": {
            "fr": "Type",
            "en": "Type"
          },
          "valeurs": [
            {
              "id": "petit",
              "libelle": {
                "fr": "Petits",
                "en": "Small"
              },
              "valeur": "goblin"
            },
            {
              "id": "gros",
              "libelle": {
                "fr": "Gros",
                "en": "Big"
              },
              "valeur": "troll"
            }
          ]
        }
      ],
      "message": "{\"action\":\"spawn\",\"enemy\":\"{param.type}\",\"count\":{param.nombre},\"by\":\"{sender.name}\"}"
    }
  ]
}

L'architecture d'un outil compagnon : un chemin par action, un corps JSON facultatif.

{
  "id": "mon-outil-compagnon",
  "nom": "Mon outil compagnon",
  "protocole": "jeu",
  "mode": "http",
  "description": "Exemple : un programme que le joueur lance à côté du jeu, et qui expose une API HTTP locale (son adresse se saisit dans « URL de base », par exemple http://127.0.0.1:7777).",
  "actions": [
    {
      "id": "soin",
      "libelle": {
        "fr": "Soins : trousse",
        "en": "Health: medipack"
      },
      "effet": "aide",
      "method": "POST",
      "path": "/actions/soin"
    },
    {
      "id": "ennemi",
      "libelle": {
        "fr": "Ennemi : au choix",
        "en": "Enemy: pick one"
      },
      "effet": "gene",
      "params": [
        {
          "id": "quoi",
          "type": "choix",
          "defaut": "loup",
          "libelle": {
            "fr": "Ennemi",
            "en": "Enemy"
          },
          "valeurs": [
            {
              "id": "loup",
              "libelle": {
                "fr": "Loup",
                "en": "Wolf"
              }
            },
            {
              "id": "ours",
              "libelle": {
                "fr": "Ours",
                "en": "Bear"
              }
            }
          ]
        }
      ],
      "method": "POST",
      "path": "/actions/ennemi",
      "json": {
        "type": "{param.quoi}",
        "de": "{sender.name}"
      }
    }
  ]
}

{
  "id": "pratfall",
  "nom": "Pratfall",
  "protocole": "jeu",
  "mode": "mod",
  "jeu": {
    "steamAppId": 4244510
  },
  "actions": [
    {
      "id": "bombes",
      "libelle": {
        "fr": "Pluie de bombes",
        "en": "Bomb rain"
      },
      "effet": "gene",
      "params": [
        {
          "id": "nombre",
          "type": "entier",
          "libelle": {
            "fr": "Nombre de bombes",
            "en": "Number of bombs"
          },
          "min": 1,
          "max": 5,
          "defaut": 3
        },
        {
          "id": "cible",
          "type": "choix",
          "libelle": {
            "fr": "Qui",
            "en": "Who"
          },
          "defaut": "moi",
          "valeurs": [
            {
              "id": "moi",
              "libelle": {
                "fr": "Toi",
                "en": "You"
              }
            },
            {
              "id": "hasard",
              "libelle": {
                "fr": "Un joueur au hasard",
                "en": "A random player"
              }
            }
          ]
        }
      ]
    },
    {
      "id": "mine",
      "libelle": {
        "fr": "Mine foreuse",
        "en": "Digging mine"
      },
      "effet": "gene",
      "params": [
        {
          "id": "cible",
          "type": "choix",
          "libelle": {
            "fr": "Qui",
            "en": "Who"
          },
          "defaut": "moi",
          "valeurs": [
            {
              "id": "moi",
              "libelle": {
                "fr": "Toi",
                "en": "You"
              }
            },
            {
              "id": "hasard",
              "libelle": {
                "fr": "Un joueur au hasard",
                "en": "A random player"
              }
            }
          ]
        }
      ]
    }
  ]
}

{
  "id": "counter-strike-2",
  "nom": "Counter-Strike 2",
  "protocole": "jeu",
  "mode": "rcon",
  "jeu": {
    "steamAppId": 730
  },
  "actions": [
    {
      "id": "gravite",
      "libelle": {
        "fr": "Changer la gravité (triche)",
        "en": "Change gravity (cheat)"
      },
      "effet": "neutre",
      "params": [
        {
          "id": "gravite",
          "type": "entier",
          "libelle": {
            "fr": "Gravité (800 = normale)",
            "en": "Gravity (800 = normal)"
          },
          "min": 100,
          "max": 2000,
          "defaut": 200
        }
      ],
      "commandes": [
        "sv_gravity {param.gravite}"
      ]
    },
    {
      "id": "bunny_hop",
      "libelle": {
        "fr": "Bunny hop",
        "en": "Bunny hop"
      },
      "effet": "aide",
      "params": [
        {
          "id": "etat",
          "type": "choix",
          "libelle": {
            "fr": "État",
            "en": "State"
          },
          "defaut": "oui",
          "valeurs": [
            {
              "id": "oui",
              "libelle": {
                "fr": "Activé",
                "en": "On"
              },
              "valeur": "1"
            },
            {
              "id": "non",
              "libelle": {
                "fr": "Désactivé",
                "en": "Off"
              },
              "valeur": "0"
            }
          ]
        }
      ],
      "commandes": [
        "sv_enablebunnyhopping {param.etat}",
        "sv_autobunnyhopping {param.etat}"
      ]
    }
  ]
}

{
  "id": "tomb-raider-remastered",
  "nom": "Tomb Raider I-III Remastered",
  "protocole": "jeu",
  "mode": "http",
  "jeu": {
    "steamAppId": 2478970
  },
  "actions": [
    {
      "id": "small_medkit",
      "libelle": {
        "fr": "Soins : petite trousse de soins",
        "en": "Health: small medipack"
      },
      "effet": "aide",
      "method": "POST",
      "path": "/small_medkit"
    },
    {
      "id": "large_medkit",
      "libelle": {
        "fr": "Soins : grande trousse de soins",
        "en": "Health: large medipack"
      },
      "effet": "aide",
      "method": "POST",
      "path": "/large_medkit"
    }
  ]
}

Un cadeau personnalisé Hou.la à 100 pièces, un cadeau TikTok d'au moins 99 diamants, un Super Chat YouTube, 100 KICKs ou 100 bits Twitch : chacun fait apparaître le même creeper devant le streamer (plugin Minecraft). Twitch arrive bientôt dans Connect ; le pack est déjà prêt.

{
  "schema": 3,
  "rules": [
    {
      "id": "creeper",
      "label": "Creeper",
      "on": [
        {
          "type": "gift",
          "giftSlug": "ix_slot_01",
          "coinCost": 100,
          "group": "Pagaille"
        },
        {
          "type": "platform",
          "platform": "tiktok",
          "event": "gift",
          "min": 99
        },
        {
          "type": "platform",
          "platform": "youtube",
          "event": "superchat"
        },
        {
          "type": "platform",
          "platform": "kick",
          "event": "kicks",
          "min": 100
        },
        {
          "type": "platform",
          "platform": "twitch",
          "event": "bits",
          "min": 100
        }
      ],
      "do": [
        {
          "kind": "action",
          "id": "creeper",
          "effect": {
            "type": "jeu",
            "jeu": "minecraft",
            "action": "invoquer",
            "params": {
              "creature": "creeper",
              "position": "devant_3",
              "qui": "joueur"
            }
          }
        }
      ]
    }
  ]
}

Les likes de Hou.la et de TikTok passent par la même chaîne ; un switch sur hearts.palier choisit la réaction (trois fanfares à 10 000, avec repeat). Les partages lisent leur total. Un cadeau quelconque est routé selon coins, et repeat joue cinq klaxons quand la quantité atteint 5.

{
  "schema": 3,
  "rules": [
    {
      "id": "paliers-likes",
      "label": "Paliers de likes",
      "on": [
        {
          "type": "hearts",
          "milestones": [
            1000,
            5000,
            10000
          ]
        },
        {
          "type": "platform",
          "platform": "tiktok",
          "event": "like_total",
          "milestones": [
            1000,
            5000,
            10000
          ]
        }
      ],
      "do": [
        {
          "kind": "switch",
          "id": "selon-palier",
          "conditions": [
            {
              "all": [
                {
                  "left": "hearts.palier",
                  "op": ">=",
                  "right": 10000
                }
              ]
            },
            {
              "all": [
                {
                  "left": "hearts.palier",
                  "op": ">=",
                  "right": 5000
                }
              ]
            }
          ],
          "branches": [
            [
              {
                "kind": "repeat",
                "id": "trois-fanfares",
                "times": 3,
                "gapMs": 1500,
                "branches": [
                  [
                    {
                      "kind": "action",
                      "id": "fanfare",
                      "effect": {
                        "type": "sound",
                        "soundId": "34f7bfb4-b51f-11f1-a1b0-920007989f15",
                        "volume": 0.8
                      }
                    }
                  ]
                ]
              }
            ],
            [
              {
                "kind": "action",
                "id": "wow",
                "effect": {
                  "type": "sound",
                  "soundId": "2ebf44c5-b51a-11f1-a1b0-920007989f15"
                }
              }
            ]
          ],
          "else": [
            {
              "kind": "action",
              "id": "merci",
              "effect": {
                "type": "chat",
                "text": "{hearts.palier} likes, merci à tous !",
                "cooldownMs": 10000
              }
            }
          ]
        }
      ]
    },
    {
      "id": "paliers-partages",
      "label": "Paliers de partages",
      "on": {
        "type": "share_total",
        "milestones": [
          10,
          50,
          100
        ]
      },
      "do": [
        {
          "kind": "action",
          "id": "voix",
          "effect": {
            "type": "tts",
            "text": "{shares.total} partages, merci !"
          }
        }
      ]
    },
    {
      "id": "selon-montant",
      "label": "Selon le montant du cadeau",
      "on": {
        "type": "gift",
        "minCoins": 1
      },
      "do": [
        {
          "kind": "switch",
          "id": "selon-pieces",
          "conditions": [
            {
              "all": [
                {
                  "left": "coins",
                  "op": ">=",
                  "right": 500
                }
              ]
            },
            {
              "all": [
                {
                  "left": "coins",
                  "op": ">=",
                  "right": 100
                }
              ]
            }
          ],
          "branches": [
            [
              {
                "kind": "action",
                "id": "gros",
                "effect": {
                  "type": "sound",
                  "soundId": "34f7bfb4-b51f-11f1-a1b0-920007989f15"
                }
              }
            ],
            [
              {
                "kind": "repeat",
                "id": "klaxons",
                "times": 1,
                "gapMs": 600,
                "cases": [
                  {
                    "when": {
                      "all": [
                        {
                          "left": "quantity",
                          "op": ">=",
                          "right": 5
                        }
                      ]
                    },
                    "times": 5
                  }
                ],
                "branches": [
                  [
                    {
                      "kind": "action",
                      "id": "klaxon",
                      "effect": {
                        "type": "sound",
                        "soundId": "301b847c-b529-11f1-a1b0-920007989f15"
                      }
                    }
                  ]
                ]
              }
            ]
          ],
          "else": [
            {
              "kind": "action",
              "id": "petit",
              "effect": {
                "type": "chat",
                "text": "Merci {sender.name} pour {gift.name} !",
                "cooldownMs": 5000
              }
            }
          ]
        }
      ]
    }
  ]
}

/klaxon est gratuite, une fois toutes les 30 secondes par spectateur, et tire un son au hasard (70 / 30). /dis coûte 10 pièces et lit le texte du spectateur à voix haute. « !gg » est écouté sur les chats de Hou.la, TikTok, YouTube et Kick.

{
  "schema": 3,
  "rules": [
    {
      "id": "commande-klaxon",
      "label": "Klaxon",
      "on": {
        "type": "command",
        "name": "klaxon",
        "description": "Joue un klaxon au hasard",
        "perViewerMs": 30000
      },
      "enchainement": "ignorer",
      "do": [
        {
          "kind": "random",
          "id": "tirage",
          "weights": [
            70,
            30
          ],
          "branches": [
            [
              {
                "kind": "action",
                "id": "police",
                "effect": {
                  "type": "sound",
                  "soundId": "051db1d2-b523-11f1-a1b0-920007989f15",
                  "maxMs": 3000
                }
              }
            ],
            [
              {
                "kind": "action",
                "id": "dj",
                "effect": {
                  "type": "sound",
                  "soundId": "301b847c-b529-11f1-a1b0-920007989f15"
                }
              }
            ]
          ]
        }
      ]
    },
    {
      "id": "commande-dis",
      "label": "Dis-le à voix haute",
      "on": {
        "type": "command",
        "name": "dis",
        "description": "Le streamer lit ton message à voix haute",
        "coinCost": 10,
        "args": "texte",
        "who": "tous"
      },
      "do": [
        {
          "kind": "action",
          "id": "lire",
          "effect": {
            "type": "tts",
            "text": "{sender.name} dit : {commande.texte}"
          }
        }
      ]
    },
    {
      "id": "mot-gg",
      "label": "GG dans le chat",
      "on": {
        "type": "comment",
        "startsWith": "!gg",
        "platforms": [
          "houla",
          "tiktok",
          "youtube",
          "kick"
        ]
      },
      "enchainement": "ignorer",
      "do": [
        {
          "kind": "action",
          "id": "roulement",
          "effect": {
            "type": "sound",
            "soundId": "5703a3d3-b522-11f1-a1b0-920007989f15",
            "volume": 0.6
          }
        }
      ]
    }
  ]
}

Quatre cadeaux personnalisés (ix_slot_01 à 04), chacun avec son nom, son prix dans l'échelle fermée et son rayon, reliés aux actions du plugin Pratfall. L'icône d'un cadeau se règle ensuite dans le Lab.

{
  "schema": 3,
  "rules": [
    {
      "id": "bombes",
      "label": "Pluie de bombes",
      "on": {
        "type": "gift",
        "giftSlug": "ix_slot_01",
        "coinCost": 30,
        "group": "Pagaille"
      },
      "do": [
        {
          "kind": "action",
          "id": "bombes",
          "effect": {
            "type": "jeu",
            "jeu": "pratfall",
            "action": "bombes",
            "params": {
              "nombre": 3,
              "cible": "hasard"
            }
          }
        }
      ]
    },
    {
      "id": "soins",
      "label": "Soins",
      "on": {
        "type": "gift",
        "giftSlug": "ix_slot_02",
        "coinCost": 45,
        "group": "Coup de main"
      },
      "do": [
        {
          "kind": "action",
          "id": "soigner",
          "effect": {
            "type": "jeu",
            "jeu": "pratfall",
            "action": "soigner",
            "params": {}
          }
        }
      ]
    },
    {
      "id": "klaxon",
      "label": "Klaxon",
      "on": {
        "type": "gift",
        "giftSlug": "ix_slot_03",
        "coinCost": 5,
        "group": "Ambiance"
      },
      "do": [
        {
          "kind": "action",
          "id": "klaxon",
          "effect": {
            "type": "jeu",
            "jeu": "pratfall",
            "action": "klaxon",
            "params": {}
          }
        }
      ]
    },
    {
      "id": "resurrection",
      "label": "Résurrection",
      "on": {
        "type": "gift",
        "giftSlug": "ix_slot_04",
        "coinCost": 280,
        "group": "Coup de main"
      },
      "do": [
        {
          "kind": "action",
          "id": "ressusciter",
          "effect": {
            "type": "jeu",
            "jeu": "pratfall",
            "action": "ressusciter",
            "params": {
              "cible": "hasard"
            }
          }
        }
      ]
    }
  ]
}

Deux cadeaux qui pilotent Tomb Raider I-III Remastered par son plugin officiel en mode http ; la trousse répond aussi à la Rose de TikTok (giftId 5655).

{
  "schema": 3,
  "rules": [
    {
      "id": "trousse",
      "label": "Trousse de soins",
      "on": [
        {
          "type": "gift",
          "giftSlug": "ix_slot_01",
          "coinCost": 20,
          "group": "Coup de main"
        },
        {
          "type": "platform",
          "platform": "tiktok",
          "event": "gift",
          "giftId": "5655"
        }
      ],
      "do": [
        {
          "kind": "action",
          "id": "trousse",
          "effect": {
            "type": "jeu",
            "jeu": "tomb-raider-remastered",
            "action": "small_medkit",
            "params": {}
          }
        }
      ]
    },
    {
      "id": "trex",
      "label": "T-Rex",
      "on": {
        "type": "gift",
        "giftSlug": "ix_slot_02",
        "coinCost": 490,
        "group": "Pagaille"
      },
      "do": [
        {
          "kind": "action",
          "id": "annonce",
          "effect": {
            "type": "chat",
            "text": "{sender.name} lâche un T-Rex sur Lara !",
            "cooldownMs": 5000
          }
        },
        {
          "kind": "action",
          "id": "trex",
          "effect": {
            "type": "jeu",
            "jeu": "tomb-raider-remastered",
            "action": "trex",
            "params": {}
          }
        }
      ]
    }
  ]
}