カスタムボット

カスタムボットとは

カスタムボットは、あなたが所有するボットトークンでNoxyrを動かすものです。メンバーに表示されるのはあなたの名前とアバターですが、コード、設定、データベースはNoxyrのものです。ダッシュボードで行った変更は両方のボットに反映され、何も複製されません。

Noxyrはノードのひとつでカスタムボットをホスティングします。サーバーごとに応答するボットは1つだけです。カスタムボットがいるサーバーではNoxyrは引き下がって応答を止め、いないサーバーではこれまで通り動きます。1つのDiscordアカウントにつきカスタムボットは1つで、管理しているサーバーなら何個でも同じボットを使えます。

必要なもの

Top.ggでの投票

Noxyrに投票すると、12時間のあいだセットアップフォームが使えるようになります。必要なのはこれだけで、有料プランはありません。

自分のアプリケーション

Discord Developer Portalで作成してください。Noxyr自身のトークンとユーザートークンは受け付けられません。

特権インテント2つ

Bot → Privileged Gateway Intents で、Server Members IntentとMessage Content Intentの両方をオンにしてください。ダッシュボードは、トークンを受け付ける前にこれを確認します。

サーバーにNoxyrがいること

カスタムボットはNoxyrの設定とデータベースで動くため、対象のサーバーにはNoxyrが参加し続ける必要があります。

管理者

ダッシュボードでそのサーバーを開ける人だけが、そのサーバーのカスタムボットを設定できます。

セットアップ手順

1. Top.ggでNoxyrに投票してから、サーバーのダッシュボードでカスタムボットを開いてください。
2. Developer Portalで「New Application」を押し、ボットの名前を付けます。Botタブでアバターを設定し、特権インテントを2つともオンにしてください。
3. 「Reset Token」を押し、トークンを一度コピーして、カスタムボットのページに貼り付けてください。トークンは暗号化して保存され、Noxyrのウェブサイトと、あなたのボットを動かすノードだけが読み取れます。
4. ホストを選びます(Automaticは空きのある最速のノードを選びます)。「Start my bot」を押してください。
5. ページに表示される招待リンクを使ってください。約20秒でボットがオンラインになり、Noxyrのコマンドをあなたのボット名で登録します。

トークンを貼り付けた本人だけが、後からトークンを差し替えられます。サーバーのほかの管理者はボットを見られますが、あなたの名前で別のトークンに入れ替えることはできません。

投票期間、猶予期間、リマインダー

1回投票すると、カスタムボットが12時間使えるようになります。これは、Top.ggで投票できる間隔でもあります。投票期間が終わると、74時間の猶予期間が始まります。その間もボットは動き続けますが、次に投票するまでカスタムボットのページはロックされます。

最後の投票から24時間後、つまり猶予期間に入って12時間後に、リマインダーのDMが届きます。DMには打ち切りまでのカウントダウンが表示されます。猶予期間も終わると、ボットはオフラインになり、サーバーからコマンドが削除されます。ただし何も削除されません。トークン、設定、チケット、商品、請求書はすべてそのまま残り、1回投票すればすべてすぐに戻ります。

投票期間

投票から12時間です。カスタムボットのページで両方のカウントダウンがリアルタイムに表示されます。

猶予期間

投票期間が終わってから74時間です。ボットは動いたまま、ダッシュボードはロックされます。

リマインダーのDM

1回の期間ごとに1回だけ送られ、投票から24時間後に届きます。

オフ

猶予期間が終わった後の状態です。もう一度投票すると、ボットは自動的に再開します。

投票せずに時間を増やす

カスタムボットを動かし続ける方法は、投票だけではありません。以下の方法はどれも、残っている時間に追加されるので、無駄になりません。カスタムボット → 「Get more time」ページでは、残り時間、各方法の進み具合、これまでに付与された時間をすべて確認できます。

Noxyr Rush

Webサイトのブラウザミニゲームです。1回のプレイで3,000点を取ると12時間もらえます。ゲーム時間は一度に12時間まで保有でき、使い切ったあとはまた獲得できます。時間を獲得できるのはカスタムボットを動かしているアカウントだけで、各プレイの結果はサーバーで検証されます。

友だちを招待する

「Get more time」ページで紹介リンクを共有してください。友だちが初めてカスタムボットをセットアップすると、2人とも12時間もらえます。紹介は友だち1人につき1回だけ数えられ、友だちのDiscordアカウントは作成から30日以上経っている必要があります。30日ごとに最大10人の友だちから獲得できます。

バグ報告と提案

サポートセンターから送信してください。Noxyrチームが承認すると、報告1件につき1回、12時間もらえます。

チームからの付与

Noxyrチームは、障害の後などに直接時間を付与することがあります。

サーバーからNoxyrが削除された場合

カスタムボットはNoxyrがサーバーにいることを前提に動いているため、Noxyrをキックすると、そのサーバーのカスタムボットは1分ほどで停止します。ボットは、Noxyrを削除した人に、その人がボットのオーナーでなければボットのオーナーにも、招待リンク付きのDMを送ります。

Noxyrをサーバーに招待し直すと、カスタムボットは自動的に再開します。この理由で停止している間は、投票期間を消費せずに一時停止されます。ただし、ほかにあなたのボットが動いている場合はこの限りではありません。

投票期間を別の人に譲る

投票する人と、ボットの持ち主が同じアカウントである必要はありません。カスタムボットのページから、残っている投票期間を、ユーザーIDで指定した別のDiscordユーザーに譲渡できます。全部でも、一部の時間数でも構いません。

譲渡された時間は、相手が既に持っている時間に加算されるため、譲渡によって相手が損をすることはありません。あなたの猶予期間は残るので、自分のボットが途中で止まることもありません。両者には、何が移動したかを知らせるDMが届きます。

譲渡できるのは有効な投票期間だけです。猶予期間に入ると譲れる時間は残っていません。5分未満の譲渡は受け付けられません。

トラブルシューティング

「Discord rejected this token」(ゲートウェイコード4004)

Developer Portalでトークンがリセットされたため、古いトークンは無効になっています。カスタムボットのページで「Reset Token」を押し、新しいトークンを貼り付けるまで、ボットはオフのままです。

「Discord refused the connection」(ゲートウェイコード4013 / 4014)

セットアップ後に特権インテントがオフにされています。Server Members IntentとMessage Content Intentを再びオンにしてから、ダッシュボードでボットを再度オンにしてください。

「Vote on Top.gg first」

投票期間が終了しています。投票してからもう一度お試しください。ページはすぐにロックが解除されます。

「That bot is already the custom bot for someone else's server」

1つのアプリケーションは1人のオーナーにしか属せません。自分用に新しいアプリケーションを作成してください。

「You already run …」

1アカウントにつきカスタムボットは1つです。このサーバーでも既存のボットを使うか(ページに選択肢が表示されます)、先に削除してください。

Change Nodeがグレーアウトしている

ノードを移動するたびにDiscordへの再ログインが必要で、移動の間には5分のクールダウンがあります。

ステータスが「suspended」と表示される

投票期間と猶予期間の両方が終わったか、サーバーからNoxyrが削除されています。ページのステータスメッセージに理由が表示されます。