配信で使う
Twitchのカテゴリ名を送ると、そのゲームで死ぬことがあるかどうかをお答えします。ボットはその答えを使って、デスカウンターのオン・オフを切り替えられます。
リクエスト
アドレスは2つあります。1つはチャットに投稿する文を、もう1つは答えだけを返します。どちらもアドレスの末尾にカテゴリ名を付けた1回のGETリクエストで、ゲームの照合方法も同じです。キーも登録も必要ありません。
チャット用
GET https://can-i-die.in/api/chat/<カテゴリ名>?lang=jaボットがそのまま投稿できる文です。現在はこう返します:
- https://can-i-die.in/api/chat/Baldur's%20Gate%203?lang=ja
バルダーズ・ゲートIIIでは死ぬことがあります。
- https://can-i-die.in/api/chat/Firewatch?lang=ja
ファイアー ウォッチでは死ぬことはありません。
- https://can-i-die.in/api/chat/Just%20Chatting?lang=ja
Just Chattingに死亡はありません。死亡カウンターは今日はお休みです。
?lang=と次のコードのいずれかを付けない限り、文は英語です:en, fr, es, de, ja, ko, zh, it, pl, ru, ar。このページのコマンドには、今読んでいる言語の指定がすでに入っています。答えの理由は、その言語で書かれている場合に付きます。
答えがない場合は、その旨を伝え、GitHubでの協力を呼びかける文を返します。Just Chattingのようにゲームではないカテゴリには、代わりに毎回違うジョークを返します。どちらの場合も、返事が空になることはありません。
自動化用
GET https://can-i-die.in/api/<カテゴリ名>答えだけを返します。Streamer.botで死亡カウンターをオン・オフするなど、答えに応じて動くツール向けです。
返答はプレーンテキストで、次の3つのいずれかです。
- true
- このゲームでは死ぬことがあります。
- false
- このゲームでは死ぬことがありません。
- 404
- 空の返答です。その名前のゲームがないか、まだ答えが登録されていません。
名前の代わりに、ゲームのスラッグも使えます。スラッグは、このサイトのゲームページのアドレスの最後の部分です(例:baldurs-gate-iii)。
ボットの設定
以下の例はどれも現在のカテゴリを読み取って問い合わせるので、ゲームを変えても答えが追従します。Nightbot、StreamElements、Fossabotはチャット用アドレスの文を投稿します。Streamer.botは答えだけを受け取り、それに応じて動きます。
Streamer.bot
アクションに、次の2つのサブアクションをこの順番で追加します。
- Twitch › User › Get User Info for Target:User Login を
%broadcastUserName%に設定します。これでカテゴリが%game%に入ります。アクションがTwitchのトリガーで始まらない場合は、その前に Add Broadcaster Information を置いてください。 - Core › Network › Fetch URL:Variable Name を
canDieに設定し、URLに次のアドレスを入れます。https://can-i-die.in/api/%game%
これで %canDie% に true か false が入ります。答えがない場合は空になります。If/Else サブアクションで判定してください。
Nightbot
チャットで次を送信すると、!candie コマンドが追加されます。
!commands add !candie $(urlfetch https://can-i-die.in/api/chat/$(querystring $(twitch $(channel) "{{game}}"))?lang=ja)StreamElements
チャットで次を送信します。
!command add !candie $(customapi https://can-i-die.in/api/chat/$(pathescape $(game))?lang=ja)Fossabot
次を応答とするコマンドを作成します。
$(customapi https://can-i-die.in/api/chat/$(pathencode $(game))?lang=ja)その他のツール
ウェブアドレスを取得できるツールなら何でも使えます。ブラウザソースやオーバーレイからも、どのサイトからでも呼び出せます。
curl "https://can-i-die.in/api/Pok%C3%A9mon%20Red%20Version"名前の照合方法
このサイトのゲーム名はIGDBから取得しており、Twitchのカテゴリも同じIGDBが元なので、ほとんどの名前はそのまま一致します。大文字・小文字、アクセント記号、句読点は無視され、続編の番号はどちらの書き方でも構いません。「3」で「III」が、「III」で「3」が見つかります。現在、いくつかの名前は次のように返されます。
| 送信した名前 | 返答 | 理由 |
|---|---|---|
| Firewatch | false | 単純な名前です。大文字・小文字は区別されないので、「firewatch」や「FIREWATCH」でも大丈夫です。 |
| Pokémon Red Version | true | アクセント記号は省略できます。「Pokemon Red Version」でも同じゲームが見つかります。 |
| Animal Crossing: New Horizons | false | 句読点は無視されるので、コロンは省略できます。 |
| Friday Night Funkin' | false | アポストロフィは省略できます。「Friday Night Funkin」でも大丈夫です。 |
| Baldur's Gate 3 | true | Twitchではこのカテゴリ名に「3」を使いますが、当サイトのデータでは「III」です。ローマ数字と通常の数字は同じものとして扱われるので、Twitchの名前でも見つかります。 |
| Forza Horizon V | false | 逆の場合も同じです。当サイトのデータでは、このゲームは「Forza Horizon 5」です。 |
| Fate/Grand Order | true | 名前にスラッシュが入っていても大丈夫です。そのままでも、%2F と書いても構いません。 |
| 100% Orange Juice | true | パーセント記号は %25 として送る必要があります。ボットのエンコード用変数を使えば、自動的に変換されます。 |
| Until Dawn | false | 同じ名前のゲームが複数あります。答えが登録されているもののうち、最も人気のあるものが返されます。 |
| Just Chatting | 404(空) | ゲームではないので、答えはありません。 |
| baldurs-gate-iii | true | スラッグです。このサイトのゲームページのアドレスから取ったもので、必ずそのゲームだけが見つかります。 |
カテゴリで何も見つからない場合は? メインの一覧でゲームを検索し、そのページのスラッグを代わりに使ってください。