Nutze es in deinem Stream
Schick uns den Namen deiner Twitch-Kategorie, und wir sagen dir, ob man in diesem Spiel sterben kann. Dein Bot kann mit der Antwort einen Todeszähler ein- oder ausschalten.
Die Anfragen
Es gibt zwei Adressen: Eine liefert einen Satz für den Chat, die andere nur die Antwort. Jede ist eine einzige GET-Anfrage, mit dem Kategorienamen am Ende. Beide erkennen Spiele auf dieselbe Weise, und du brauchst weder Schlüssel noch Anmeldung.
Für den Chat
GET https://can-i-die.in/api/chat/<Kategoriename>?lang=deEin Satz, den dein Bot so posten kann, wie er ist. Gerade lautet er:
- https://can-i-die.in/api/chat/Baldur's%20Gate%203?lang=de
Du kannst in Baldur's Gate III sterben.
- https://can-i-die.in/api/chat/Firewatch?lang=de
Du kannst in Firewatch nicht sterben.
- https://can-i-die.in/api/chat/Just%20Chatting?lang=de
In Just Chatting stirbt nichts, außer vielleicht das Gespräch.
Der Satz ist auf Englisch, außer du hängst ?lang= und einen dieser Codes an: en, fr, es, de, ja, ko, zh, it, pl, ru, ar. Die Befehle auf dieser Seite fragen schon nach der Sprache, in der du sie liest. Der Grund für die Antwort steht dabei, wenn wir ihn in dieser Sprache geschrieben haben.
Haben wir keine Antwort, sagt der Satz das und bittet auf GitHub um Hilfe. Eine Kategorie, die kein Spiel ist, wie Just Chatting, bekommt stattdessen einen Witz, jedes Mal einen anderen. Leer ist die Antwort also nie.
Für Automatisierung
GET https://can-i-die.in/api/<Kategoriename>Nur die Antwort, für ein Werkzeug, das darauf reagiert, etwa Streamer.bot, das einen Todeszähler ein- oder ausschaltet.
Die Antwort ist reiner Text und eine von drei Möglichkeiten:
- true
- In diesem Spiel kann man sterben.
- false
- In diesem Spiel kann man nicht sterben.
- 404
- Eine leere Antwort. Kein Spiel trägt diesen Namen, oder wir haben noch keine Antwort dafür.
Statt des Namens funktioniert auch der Slug eines Spiels. Der Slug ist der letzte Teil der Adresse der Spielseite hier, zum Beispiel baldurs-gate-iii.
Deinen Bot einrichten
Jedes Beispiel unten liest deine aktuelle Kategorie und fragt danach, sodass die Antwort mitkommt, wenn du das Spiel wechselst. Nightbot, StreamElements und Fossabot posten den Satz von der Chat-Adresse. Streamer.bot bekommt nur die Antwort, um darauf zu reagieren.
Streamer.bot
Füge einer Aktion diese beiden Sub-Actions hinzu, in dieser Reihenfolge:
- Twitch › User › Get User Info for Target, mit User Login auf
%broadcastUserName%gesetzt. Damit steht deine Kategorie in%game%. Wird die Aktion nicht durch einen Twitch-Trigger gestartet, setze Add Broadcaster Information davor. - Core › Network › Fetch URL, mit Variable Name auf
canDiegesetzt und dieser Adresse als URL:https://can-i-die.in/api/%game%
%canDie% enthält dann true, false oder nichts, wenn es keine Antwort gibt. Prüfe es mit einer If/Else-Sub-Action.
Nightbot
Sende das in deinem Chat, um einen !candie-Befehl anzulegen:
!commands add !candie $(urlfetch https://can-i-die.in/api/chat/$(querystring $(twitch $(channel) "{{game}}"))?lang=de)StreamElements
Sende das in deinem Chat:
!command add !candie $(customapi https://can-i-die.in/api/chat/$(pathescape $(game))?lang=de)Fossabot
Lege einen Befehl mit dieser Antwort an:
$(customapi https://can-i-die.in/api/chat/$(pathencode $(game))?lang=de)Alles andere
Jedes Werkzeug, das eine Webadresse abrufen kann, funktioniert. Auch Browserquellen und Overlays können sie aufrufen, von jeder Website aus.
curl "https://can-i-die.in/api/Pok%C3%A9mon%20Red%20Version"Wie Namen erkannt werden
Unsere Spielnamen stammen von IGDB, woher auch Twitch seine Kategorien bezieht, daher passen die meisten Namen unverändert. Groß- und Kleinschreibung, Akzente und Satzzeichen werden ignoriert, und die Nummer einer Fortsetzung kann auf beide Arten geschrieben werden: „3“ findet „III“, und „III“ findet „3“. Das liefern einige Namen im Moment:
| Gesendeter Name | Antwort | Warum |
|---|---|---|
| Firewatch | false | Ein einfacher Name. Groß- und Kleinschreibung spielt keine Rolle: „firewatch“ und „FIREWATCH“ funktionieren auch. |
| Pokémon Red Version | true | Akzente sind optional. „Pokemon Red Version“ findet dasselbe Spiel. |
| Animal Crossing: New Horizons | false | Satzzeichen werden ignoriert, der Doppelpunkt kann also wegfallen. |
| Friday Night Funkin' | false | Apostrophe sind optional. „Friday Night Funkin“ funktioniert ebenfalls. |
| Baldur's Gate 3 | true | Twitch schreibt diese Kategorie mit einer 3, in unseren Daten steht III. Römische und normale Zahlen werden gleich behandelt, der Twitch-Name findet das Spiel also trotzdem. |
| Forza Horizon V | false | Dasselbe andersherum. In unseren Daten heißt dieses Spiel „Forza Horizon 5“. |
| Fate/Grand Order | true | Ein Schrägstrich im Namen funktioniert, so geschrieben oder als %2F. |
| 100% Orange Juice | true | Ein Prozentzeichen muss als %25 gesendet werden. Bots erledigen das für dich, wenn du ihre Kodierungsvariable verwendest. |
| Until Dawn | false | Mehrere Spiele tragen diesen Namen. Du bekommst das, für das wir eine Antwort haben, und davon das beliebteste. |
| Just Chatting | 404, leer | Kein Spiel, also gibt es keine Antwort. |
| baldurs-gate-iii | true | Ein Slug, aus der Adresse der Spielseite hier. Er findet immer genau dieses Spiel. |
Deine Kategorie findet nichts? Suche das Spiel in der Hauptliste und nimm stattdessen den Slug von seiner Seite.