TopV × Discord

TopV Bot

私のDiscordに追加すべてのコマンドを見る ↓
133 512 Discord members reached
始める前に

必要なもの

  • 次の権限を持つDiscordサーバー: サーバー管理 (通常はオーナーまたは管理者)。
  • 既に作成済みのTopVサーバープロフィール — /setup-server まだない場合。
  • 約2分。セットアップは一度で完了。
1インストール

BotをあなたのDiscordに追加

下のボタンをクリック。Discordが権限リクエストを開きます — 承認してください。Botは最小限の権限でサーバーに参加します(メンバーとロールの読み取り、選択したチャンネルへのメッセージ送信)。それ以上は何もしません。

私のDiscordに追加
Discord — Authorize prompt
An external application
TopV wants to access your Discord server
ADD TO SERVER
R
My RP Server
Botがいることを確認
ポップアップが閉じたら、Discord右側のメンバーリストにTopVが表示されるはずです。Botがオンラインのとき緑のドットが付きます。
Discord — Member list
Welcome to your server. Type / to see commands.
ONLINE — 12
TopVAPP
D
Damien (you)
I
ic3d_
S
speXtrum
2認証

BotをTopVサーバーにリンク

テキストチャンネルで入力:

/topv-link
Discord — Slash command picker
TopV8 commands
/topv-linkこのDiscordをTopVサーバーまたはクリエイタープロフィールにリンク
Enter ↵
/topv-link

DiscordがTopVプロフィールのスラッグを尋ねます — URLの後の部分: topv.gg/servers/。例:プロフィールがtopv.gg/servers/saga-rpなら、次を入力 saga-rp.

所有権チェック
BotはDiscordアカウントがTopVプロフィールを登録したアカウントと同じ場合のみリンクを受け入れます。アンチスクワット内蔵。
確認
/topv-status をいつでも実行してリンク状態を確認できます。
Discord — Reply (only visible to you)
TopVAPPToday at 21:42(only visible to you)
✅ Saga RP が 🏠 Server Saga RP にリンクされました

https://topv.gg/servers/saga-rp

6時間ごとに自動sync。即時resyncには /topv-sync。
3ロール

スタッフとロリストロールを選択

これでBotはチームメンバーとロールプレイヤーを識別。TopVダッシュボードを開く:

ダッシュボードを開く

サーバーの編集ページに移動し、次のセクションまでスクロール: Discordロール で必要なロールにチェック。

  • スタッフロール — 管理者、モデレーター、チーム。アバター+ロールバッジ付きで表示、自動sync。
  • ロリストロール — このロールを持つメンバーは自分のTopVプロフィール(キャラ、プロジェクト、トロフィー、レビュー)を取得。永久保持。
TopV Dashboard — Discord roles
⚙️

Discord Roles

2 selected

Pick the Discord roles that represent your staff team and your players (rolistes). Staff will appear on your public profile, and rolistes will automatically get a player profile on TopV.

🛡️I SAST
⭐I LSCSO
EMS
👤I Animateur
🎮I Streamer
✓
👥I Partenaire
Staff▾
✓
Citoyen
Roleplayer▾
Staff
Roliste
オンデマンドresync
/topv-sync をいつでも実行してrefreshを強制。Botがメンバーを再スキャンし、プロフィール + 個人プロフィールを更新。
4通知

通知チャンネルを選択

Botの投稿先を決定:sync結果、新トロフィー、レビュー、Weekly Spotlight リマインダー。実行:

/topv-channel #your-channel
Discord — Slash command (autocomplete)
/topv-channelchannel:
Text channel
général
staff-only
rolistes
annonces
↑↓navigate↵selectesccancel
+
/topv-channelchannel:|
Discord — Reply (only visible to you)
TopVAPPToday at 21:42(only visible to you)
✅ TopV通知は #salon-staff に送信されます

プロのヒント:プライベートなスタッフ専用チャンネルを選択 — メッセージのほとんどはあなたとチーム向け。

必要な権限
Botが選択したチャンネルで読み書きできることを確認。できない場合は /topv-status でエラーを表示。
5RPトロフィー

トロフィーシステムを有効化

このステップは任意。コミュニティが素晴らしいRPの瞬間を報酬付けたい場合:

/topv-trophy-setup
Discord — Bot reply
TopVAPPToday at 21:42
⚙️ トロフィー設定
トロフィー報酬が公開発表されるチャンネルを選択し、確認をクリック。\n\n*誰が `/eval` を使えるかは、Discord ネイティブ権限で管理(サーバー設定 → 統合 → TopV)。*
✅ 設定を確認

Botは /eval に適切なチャンネルとどのロールが使えるかを尋ねます(通常はスタッフ+シニアロリスト)。アンチ不正内蔵:

  • 同じ作成者からの2つの /eval 間のクールダウン。
  • 評価者ごとの日次上限(アンチフラッド)。
  • ロールベースゲーティング — 設定されたロールのみ /eval を使用可能。
  • 完全なaudit log:全トロフィーポイントが評価者とチャンネルまで追跡可能。

有効化されると、適切なロールを持つメンバーが入力可能: /eval @player 適切なチャンネルで。ポイントはプレイヤーのTopVランキングに加算。

Discord — Slash command picker
TopV8 commands
/evalこのプレイヤーのRPを評価
Enter ↵
/evalplayer:@Dr Stone
Discord — Bot reply
IppoJinEvoVerse Académie | FAused/eval
TopVAPPToday at 21:42
TopV — トロフィーシステム
🏆 RP評価
@Dr Stone のRPスキルをボタンクリックで評価。\n\n各ポイントは TopV.gg での進捗とランクに貢献。
評価者: IppoJin · EvoVerse Académie | FA
🎭Fear RP
🎬RPコヒーレンス
🎪シアター
😰Pain RP
🗣️Improvisation
👑ピラー
リファレンス

すべてのスラッシュコマンド

/topv-link

このDiscordサーバーをTopVサーバープロフィールにリンク。

/topv-sync

新しい staff + rolistes sync を強制。ロール変更後に。

/topv-status

認証ステータス、リンクされたTopVスラッグ、最終syncを表示。

/topv-channel

sync、トロフィー、レビュー、Weekly Spotlight リマインダー用チャンネルを選択。

/topv-trophy-setup

/eval のトロフィーチャンネルと対象ロールを設定。任意。

/eval @player

ロールプレイヤーにトロフィーポイント1を付与。設定されたチャンネル内のみ。

/topv-help

すべてのコマンドとRPトロフィーシステムの概要を表示。

/topv-unlink

このサーバーとTopVプロフィールのリンクを削除。

信頼

権限とプライバシー

Botができること

  • メンバーリストを読む(Privileged GUILD_MEMBERS intent — Discord承認済み)。
  • ロール割り当てを読み取り(読み取り専用)— スタッフとロリスト識別。
  • /topv-channel で設定したチャンネルにメッセージ送信。
  • アクセス権のあるチャンネルでスラッシュコマンドを受信。

Botができないこと

  • メンバーをban、kick、timeout。
  • チャンネルの作成、編集、削除。
  • ロール変更 — 読み取り専用。
  • メンバーにDMを送信。
  • メッセージ内容を読む(MESSAGE_CONTENT intent なし)。
ヘルプ

トラブルシューティング & FAQ

›/topv-link が「認証されていません」と言う

Discordアカウントが対象TopVプロフィールの所有者ではありません。正しいアカウントでTopVにログインするか、/dashboard で所有権を移転。

›スタッフリストがプロフィールに表示されない

ダッシュボードで少なくとも1つのロールを「staff」としてマークし、/topv-sync を実行。それでも空なら、Botがそのロールを見られるか確認。

›ロリストプロフィールが作成されない

同じロジック — ダッシュボードで少なくとも1つのロールを「roliste」としてマークし、/topv-sync を実行。メンバーはそれらのロールのうち少なくとも1つを持つ必要があります。プロフィールは数秒で作成。

›/eval がチャンネルが対象外と言う

/topv-trophy-setup を再実行し、現在のチャンネルを対象リストに追加。ポイントは明示的に承認されたチャンネルからのみカウント。

›後でBotをアンインストールできますか?

はい、いつでも。まず /topv-unlink を実行してリンクを切断(プロフィールがサーバーが接続されていないことを認識)、その後Botをキック。検証記録以外のデータは保持されません。

›費用はかかりますか?

いいえ。Botは無料であり、無料のままです。関連するupsellはありません。Premium TopVプラン(ランキングでの可視性、Weekly Spotlightなど)は存在しますが、Botとは完全に独立しています。

1コマンド。スタッフ認証済み、プレイヤーリスト化、トロフィー集計済み。

私のDiscordに追加ホームに戻る