Evalia BOT を、使いこなす。

Evalia BOT とは

Evalia BOT は Discord サーバー向けの多機能管理 Bot です。経済システム・複数通貨・ショップ・チケット・ログ・VC 自動生成・高級宿・カジノ・XP・マッチング・SNS パネルなど、サーバー運営に必要な機能をひとつの BOT にまとめています。

ダッシュボードへアクセス

ダッシュボードは BOT が起動している間、以下の URL で利用できます。

1. BOT を起動し、コンソールに Dashboard: http://127.0.0.1:8080 と表示されることを確認します。
2. ブラウザで表示された URL にアクセスします。クラウド環境（Render / Fly.io など）では公開 URL が割り当てられます。
3. Discord OAuth または Evalia ID でログインします。
4. サーバー一覧から設定したいサーバーを選択します。管理者権限のあるサーバーのみ表示されます。
5. 各セクションを編集し、画面下に出る「変更を保存」を押すと設定が即時反映されます。

/settings から操作する

/settings は Discord 上から BOT のほぼ全機能を操作できる**汎用パネル**です。ダッシュボードを開かずに、その場で設定変更・パネル設置・誕生日登録・ショップ購入・給料配布等を完結できます。 すべての操作は ephemeral（自分にしか見えない）で進行します。

1. Discord で /settings を実行します（管理者専用 — 一部の操作は権限不要で誰でも使用可）。
2. 2 ページにわたる セレクトメニューから、操作したいカテゴリを選択します。
3. カテゴリに応じた Modal（入力フォーム）またはサブビューが開きます。
4. 入力 → 送信で反映。すべての変更は即時保存されます。

通貨設定（複数通貨対応）

1 サーバー内で複数の通貨を併用できます。ロールごとに使用する通貨を割り当て、通貨間の為替レートも設定可能です。/pay で異なる通貨同士の送金時に自動換算されます。

ショップ管理

通貨を使って購入できるアイテム・ロール・期間延長などを販売できるショップ機能です。サイドバーの「ショップ管理」から専用ページにアクセスできます。

ロール付与アイテムの詳細オプション：

給料設定

ロール別の給料額を定義し、Discord 上の /settings から手動配布できます。複数エントリを並べて、対象ロール・支給額を自由に設定。

デイリー報酬

毎日 /daily で受け取れるデイリーボーナス。連続ログインでボーナスが増えていきます。受け取り間隔は 20 時間以上空ける必要があります。

インセンティブ設定

指定カテゴリ内の VC に滞在しているメンバーへ、自動で通貨を付与します。毎分または毎時間の間隔で加算でき、ロール・カテゴリ単位で複数エントリを設定可能です。

ユーザー所持金一覧

サーバー全メンバーの残高を一覧表示します。サイドバーの「ユーザー所持金」から開けます。

• 順位表示：所持金が多い順に並び、上位 3 名はメダルアイコンで表示。
• 検索フィルター：ユーザー名 / ID で絞り込み可能。
• 通貨フィルター：複数通貨設定時は、特定の通貨だけを表示できます。
• サマリーカード：登録ユーザー数・総流通量・平均所持金を一目で確認。

チケット設定

テキストチャンネルベースのサポートチケットシステムです。カテゴリを複数作成し、ユーザーが選択してチケットを開けます。パネルは「セレクトメニュー型」と「ボタン型」から選択可能。

1. ダッシュボードで「＋ パネル追加」、または /settings → 🎟 チケット パネル設定でパネルを作成。設置チャンネル・タイトル・説明文・種別を設定。
2. カテゴリ追加：ダッシュボードか /settings → 🎟 チケット カテゴリ追加から、カテゴリ名・閲覧可能ロールを設定。
3. /settings → 📌 パネル設置 → 🎟 チケットパネルでパネルを Discord に設置。
4. ユーザーがパネルから種別を選ぶとチケットチャンネルが自動作成されます。
5. チケット内の「クローズ」「削除」ボタンで運用できます。

フォーラムチケット設定

フォーラムチャンネルのスレッドに対してチケット管理パネルを設置する機能です。スレッドごとに個別対応チャンネルを作成できます。

1. ダッシュボード「＋ フォーラム追加」、または /settings → 🧵 フォーラムチケット追加で対象フォーラムを選択。
2. パネルタイトル・説明文・対応ロールを設定して保存。
3. /settings → 📌 パネル設置 → 🧵 フォーラムチケットパネルでフォーラム内全スレッドにパネルを設置。
4. 新規スレッドが作成されると、自動的にパネルが投稿されます。

匿名掲示板設定

ユーザーが匿名 / 非匿名で投稿できる掲示板パネルを設置します。荒らし対策と本音の発信を両立できます。

匿名相談窓口

ユーザーが匿名で運営に相談できる窓口を設置します。相談スレッドは指定フォーラムに作成され、運営とのやり取りはDM ベースで行われるためユーザーの匿名性が保たれます。

自動 VC 生成設定

指定した「トリガー VC」に入室すると、自動で個人 VC が作成されます。全員退出すると自動削除されます。複数のトリガー VC を設定可能。

高級宿設定

メンバーが通貨を支払って一定時間の専用 VC（高級宿）を借りられる機能です。期限が切れると自動削除されます。ロール別の特別プランも設定可能。

タイムカード設定

VC 通話時間をロール・カテゴリ単位で記録し、毎日深夜 0 時に指定チャンネルへ自動送信します。複数のタイムカードを並列運用できます。

マッチング設定

個通募集パネルを設置し、申請からプライベート VC 作成までを自動化します。性別ロールを使った男女別募集にも対応。

サーバー基本設定

サーバー全体の基本パラメータを設定します。

ログ設定

各イベントのログを指定チャンネルへ自動送信します。イベントごとに有効 / 無効・送信先チャンネル・埋め込みカラーを個別設定できます。

ロール管理

ダッシュボードから Discord ロールの作成・編集ができます。BOT の権限範囲内でロールの名前・カラー・権限を変更できます。

評価ロール設定

サーバー内のメンバー評価ロールを定義します。/trial_grant 等の運営コマンドで使用されます。

誕生日設定

誕生日当日にお祝いメッセージと報酬を自動配布。ユーザーは /settings → 🎂 誕生日を登録、または専用パネルから自分の誕生日を登録します。

ロールパネル設定

絵文字リアクションで役職を付与・剥奪するパネルを設置します。複数パネルを設置でき、サーバー絵文字にも対応。

試用期間フォーラム設定

/trial_grant 実行時に、説明会通過メンバーごとのスレッドを指定フォーラムへ自動投稿します。期間終了時の通知も自動化できます。

テンプレートチャンネル設定

自己紹介などのテンプレート文を常時表示するチャンネルを作成します。ユーザーが返信するたびに古いテンプレートを削除して再投稿。投稿者へのロール自動付与／没収や、メッセージからニックネーム自動設定も可能です。

リンクフィルター

外部サーバーの Discord 招待リンク（discord.gg 等）を含むメッセージを自動削除し、送信者にタイムアウトやロール付与を実行します。自サーバーの招待リンクや一般 URL（YouTube・X 等）は許可。管理者・サーバー所有者は除外。

XP / レベリング設定

VC 通話時間とテキスト送信量に応じて XP を付与し、レベルを管理します。/settings → ⭐ XP/レベリング 基本設定 / XP カテゴリ制限 / XP ロール制限からも設定できます。

カジノ設定

サーバー内でカジノゲームを提供する機能です。チンチロ・コインフリップ・スロット・ブラックジャック・ルーレット・競馬に対応。/server_info kind:casino でゲーム別の統計も確認できます。

SNS パネル設定

指定チャンネル/スレッドに SNS リンク投稿パネルを設置します。ユーザーがボタンを押して URL を入力すると、BOT が SNS 種別（X/Instagram/TikTok/YouTube/...）を自動判定し、対応する Webhook へ ユーザーアイコン・名前・メンション＋URL を送信。

サーバー統計

過去 7 / 14 / 30 / 60 / 90 日間のサーバーアクティビティを可視化します。ダッシュボードのサイドバー「サーバー統計」、または Discord で /server_info kind:server から開けます。

• VC 参加数（合計／平均）：期間内の VC 参加イベント数。
• VC 参加時間（合計／平均）：通話時間の総計。
• テキスト送信（合計／平均）：メッセージ送信数。
• 時系列グラフ：日別の推移を 1 枚の画像で表示。

パネル設置一覧

/settings → 📌 パネル設置から、以下のパネルを Discord チャンネルに設置できます。専用のスラッシュコマンドは存在しません。

📋 コマンドパネル設定

スラッシュコマンドをボタン化して Discord チャンネルに設置できる機能です。 ユーザー向け・管理者向けの 2種類のパネルを分けて配置でき、含めるコマンドはダッシュボードのチェックボックスで自由に選択可能。

設定手順

1. ダッシュボードの左メニューから「📋 コマンドパネル」を開きます（⌘K検索でも即ジャンプ可能）。
2. ユーザー向けパネル / 管理者向けパネルそれぞれで送信先チャンネルを指定します。
3. チェックボックスで含めたいコマンドを選びます（ユーザーカテゴリと管理者カテゴリで別々）。
4. 「今すぐ送信」 ボタンで Components v2 の美しいパネルがチャンネルに投稿されます。

収録コマンド

🚀 起動ログチャンネル

BOT を再起動するたび、指定したチャンネルへ詳細な起動完了レポートをリッチな Embed で自動投稿できます。 運用状況の可視化とダウンタイム検知に便利です。

設定方法

1. ダッシュボード「⚙️ サーバー設定」 → ブースト報酬カード内の「🚀 起動ログチャンネル」でチャンネルを指定。
2. 「保存」で完了。次回 BOT 再起動時から自動的にレポートが投稿されます。

投稿される情報

🏇 競馬（カジノ）

12頭の馬プールから毎レース抽選、Playwright 描画によるアニメGIFで結果を演出するカジノゲームです。 ダッシュボードの「🎰 カジノ」設定内で有効化・オッズ調整・出走頭数を管理できます。

ゲームロジック

• 馬プール: 12頭（サンダーボルト・シャドウダンサー・クリムゾンエース 等）から毎レース n頭を抽選。基礎速度 × 終盤スタミナ補正でシミュレーション。
• オッズ計算: 総合力の4乗を正規化し、ハウスエッジ（デフォルト 15%）を控除して単勝オッズを算出。
• レース描画: Playwright（Chromium）で HTML トラックを描画 → 各フレーム PNG キャプチャ → Pillow で GIF エンコード。
• ephemeral表示: 結果 GIF はプレイヤー本人のみ閲覧可能。

ダッシュボード設定項目

🎛 ダッシュボード新機能（v4 Command Console）

ダッシュボードは v4 で情報階層と操作性が刷新されました。全モジュールの共通機能をまとめます。

全コマンド一覧

実装されているスラッシュコマンドは 14 個のみ。それ以外の操作はすべて /settings またはパネル経由です。

経済コマンド

モデレーション

ロール操作 / 試用期間

VC オーナーコマンド

自動生成 VC のオーナーが使用できるコマンドです。自分が作成した VC に入っている状態で実行してください。

/settings 詳細

/settings はサーバー設定のほぼ全機能の入口です。2 ページのセレクトメニューから操作カテゴリを選びます。すべて ephemeral で進行。

XP / ランクコマンド

統計コマンド

匿名相談コマンド

自動ログ

ダッシュボードのログ設定で有効にしたイベントは、BOT が自動的に検知して指定チャンネルへ埋め込みメッセージを送信します。コマンド操作は不要です。

自動 VC 生成

ダッシュボードの「自動 VC 生成設定」でトリガー VC を設定すると、入室時に個人 VC が自動作成されます。

高級宿 期限管理

BOT 起動中、定期的に期限チェックを実行します。期限切れの高級宿 VC は自動削除されます。

タイムカード自動記録

VC 入退室を検知して通話時間を自動記録します。毎日深夜 0 時に集計結果を送信し、翌日分をリセットします。

リンクフィルター 自動削除

リンクフィルターが有効な場合、外部 Discord 招待リンクを含むメッセージを自動削除し、設定に応じてタイムアウト・ロール付与・ログ送信を行います。

誕生日自動配布

登録済みユーザーの誕生日当日（JST 基準）に、設定されたメッセージと報酬を自動配布します。通知チャンネルに祝いメッセージを送信し、ユーザーの口座に通貨を自動付与します。

インセンティブ自動加算

設定された加算間隔（毎分 / 毎時間）で、対象カテゴリの VC に滞在しているメンバーに通貨を自動付与します。ロール条件・カテゴリ条件は AND 評価で、条件を満たしたエントリの金額がすべて累積加算されます。