ユーザーガイド

RTの導入手順や操作方法等をここには書き記します。

RTをサーバーに入れる

まずはRTをサーバーに入れなければ何も始まりません。
このリンクを開いたところでサーバーを選択して、そのサーバーにRTを入れることができます。

サーバーを選択する

認証を押す

認証をする

導入成功

これで導入成功しました！

RTの操作方法

定義

DiscordではRT関係なくコマンドという言葉が頻繁にでてきます。
これは、Botを操作するための文書のことを言います。
コマンドは命令という意味で名前通りBotを命令するためのものです。

スラッシュコマンド

スラッシュコマンドというのは、Discord公式が用意しているBotを操作するための方法です。
例えば、テキストチャンネル等で/pingと入力してみましょう。
すると、RTのアイコンと/pingと書かれた選択肢が恐らくでてくるはずです。
(出てこない場合はネットが遅いか何かしらのバグが起きています。)
その/pingと出てきた項目を押してメッセージを送信してみましょう。
すると、RTが返信してくれるはずです。
このように、RTに何かを指示するには大抵の場合、コマンド(命令)を書きメッセージで送る必要があります。

メッセージコマンド

メッセージコマンドはとてもスラッシュコマンドと似ています。
これは、スラッシュを使わないDiscord公式ではない非公式なBotの命令方法です。
スラッシュと違い、普通のメッセージを送信して、RTがそのメッセージの内容を見てコマンドを実行するというものです。
例えば、スラッシュコマンドの時に実行したpingコマンドを実行する場合は以下のようになります。

rt!ping

/pingの/がrt!となっただけです。
このやり方は大昔からあるやり方で、今もRT以外でもこのやり方で操作するBotが恐らく残っています。
スラッシュコマンドの場合は、補完という途中まで入力した文字に似たコマンドを表示してくれる機能があったりします。
ですので、大抵の場合はスラッシュコマンドの方が操作しやすいと思います。
ちなみに、この例ではrt!が最初についていますが、これ以外にもRt!やりつ！等でも呼び出すことができます。

コマンドの存在を知る方法

といっても、何のコマンドがどんなことをするのかわからないと、RTを操ることはできません。
もちろん、それを教えるための取扱説明書なるものが存在します。
それはヘルプコマンドというものです。
/help(またはrt!help)と実行してみてください。
すると、選択ボックスが二つついたメッセージをRTが送信します。
この選択ボックスでカテゴリーとコマンドを選択することで、コマンドの説明(使用方法)を見ることができます。
二つの選択ボックスのうち上にあるのが、コマンドの種類を表すカテゴリーの選択ボックスです。
下にある選択ボックスが、そのカテゴリーに分類されているコマンドの選択ボックスとなります。
試しに、先ほどから実行しているpingコマンドを見てみましょう。
pingコマンドはRTカテゴリーに分類されるので、上の選択ボックスからRTを探してRTを選択してみましょう。
すると、メッセージが編集されてたくさん文章が出てきたと思います。
出てきた文章は今選択したRTカテゴリーにあるコマンドの一覧です。
そこに一覧されているコマンドを下の選択ボックスから選択します。
そのコマンド一覧にpingがあるはずです。
下の選択ボックスからpingを選択してみましょう。
すると、一覧が消えて短い文章がでてきたはずです。
それがpingコマンドのヘルプ(説明)です。
他のコマンドも同じようにして説明を閲覧することができます。

コマンドの引数

引数というのはコマンド(命令)に入れる追加情報です。
例えば、RTに「あなたが嫌いなの」または「あなたが好きなの。(NYN姉貴風)」と言わせるためのコマンド/loveがあるとします。
あなたはRTに「あなたが好きなの」と言わせたいと思い、その言わせるコマンドを実行しようとするとします。
ですが、その言わせるコマンドは好きではなく嫌いと言わせることもできます。
あなたは同然嫌いとは言われたくありません。
なので、RTにして欲しいことを伝える必要があります。
もちろん、そのコマンドではそれを伝えることができます。
そういったものが引数で用意されています。
今回の場合はコマンドの後ろに好きか嫌いをつければいいようです。
そして、あなたは/love 好きと実行して、無事好きと言われました！
先ほど説明したヘルプコマンドの/helpも、同じように引数を受け取ることができます。
その引数に渡すことができる値(もの)はコマンドの名前か検索ワードです。
例えば、先ほどから実行しまくっている/pingコマンドのヘルプを、/helpの引数を使って選択ボックスを用いずにみてみましょう。
勘のいい人はもうわかると思います。
この場合は/help pingを実行することでできます。
RTにヘルプコマンド(助けてくれ命令)に引数(追加情報)としてpingを付け加えています。
ここで注意ですが、瞬時に/help pingとは入力しないでください。
コマンドを入力すると引数の選択肢がでてくるので(/helpの場合はword)、それを押してから引数の内容(ここではping)を入力してください。 実行すると、pingのヘルプが出てきたと思います。

引数の説明の見方

ヘルプでの引数の見方をここでは説明していきます。
ヘルプコマンドのヘルプを例としてここでは解説するので、/help helpでヘルプコマンドのヘルプを表示してください。

まず

# 使い方

という見出しの項目を見てください。

メッセージ: rt!help [word=None]
スラッシュ: /help [word=None]

と書かれていますね。
[]でかか壊れている部分が引数となります。
=の左にあるのが引数の名前で、右にあるのがデフォルトの値です。
デフォルトの値というのは、引数が未入力の時に代わりに渡される値です。
今回のデフォルトの値はNone(空という意味)になっています。
ヘルプコマンドは引数を指定しない/helpだけでも動くようになっているので、デフォルト値がNone(空)なのは納得ですね。
そして、その下には引数の説明がかかれています。

word : 文字列, オプション
検索ワードまたはコマンド名

ヘルプコマンドの場合は上記のように書かれています。
先ほどの引数wordの説明が書かれてますね。
はい、RTのヘルプではコマンドと引数の名前を並べたものと、その引数の名前に対応するものを下に書き、それの説明を記載します。
その引数の説明の書き方は以下のように書かれます。

引数名 : 引数が取る値の種類, (オプション(省略可能)かどうか)
    引数の説明

ヘルプの説明の詳細についてはこちらをご覧ください。

コンテキストメニュー

コンテキストメニューとは、メッセージをPCのDiscordでは右クリック、スマホやタブレットでは長押しした際にでるメニューのことです。
ユーザーにも右クリック(スマホやタブレットではタッチ)で、メニューがでてきます。
RTは、これで選択したメッセージやユーザーに対してなにかしらできるようになっています。
RTの項目はコンテキストメニューの「アプリ」というところにあります。
例えば、メッセージのコンテキストメニューのアプリと言う欄に、RTのアイコンとTranslateというものがあるはずです。
英語のメッセージを選択して、このTranslateを押してみてください。
すると、選択したメッセージが翻訳されます。
このように選択したメッセージまたはユーザーに対して何かしらのアクションを行う機能がコンテキストメニューです。
ヘルプでは、コンテキストメニューの〇〇のように書かれると思います。
また、Discordではこのコンテキストメニューは最大五つまでしか登録できないようになっています。
そのため、五つ以上登録できるように、Otherと言う選択肢を作りました。
この選択肢を押すと、登録しきれなかったコンテキストメニューを選択するように要求されます。
もし、コンテキストメニューにないのに、ヘルプにはコンテキストメニューにあると書かれている場合は、このOtherを押してみてください。
ちなみに、Otherと言う単語はその他という意味です。