🚀 サーバーへの初期導入手順
Botをサーバーに追加したら、まず以下の手順で初期設定を行ってください。
1
Botをサーバーに招待する
招待リンクからBotをサーバーに追加します。
↓
2
登録ボタンを設置する（/g99_setbutton）
メンバーが登録しやすいチャンネルで実行します。登録・確認ボタンが投稿されます。初回のみ実行してください。
任意で notify_channel を指定すると、メンバーが登録した際にそのチャンネル/スレッドへ通知が届きます。後から変更する場合は /g98_setnotify を使用してください。
↓
3
メンバーにSNS情報を登録してもらう
設置したボタンまたは /a01_register からSNS情報を登録してもらいます。
必要であれば案内文のテンプレートをご利用ください。
【お知らせ】
このサーバーにYouTube概要欄作成Botを導入しました。
**配信・コラボに参加される方は、SNS情報の登録をお願いいたします。**
別のサーバーですでに登録している場合は登録不要です。
**登録状況確認ボタンで確認してください。**
📌 **登録方法**
#チャンネル名 にある「**登録する**」ボタンを押すか、/a01_register コマンドを実行してください。
✅ 登録できる情報
・表示名（YouTube名など）
・X（旧Twitter）
・YouTube
・Twitch
・その他SNS（最大2つ）
ご不明な点があればお気軽にお知らせください。
詳しい説明はこちらをご覧ください。
https://MizumiyaRuon.github.io/mizulab/
※ #チャンネル名 はご自身のサーバーのチャンネル名に置き換えてください。
※ 案内の例ですので、自分の言葉に置き換えて投稿してください。
↓
4
参加者一覧を生成する（/g01_chdesc または /g11_roledesc）
未登録者の確認・登録促進・参加者一覧の生成がコマンド一つで完結します。
📋 通常運用の流れ
初期設定完了後、概要欄を作成する際はこの流れで進めます。
1
チャンネル/スレッド指定の場合
/g01_chdesc を実行 → 未登録確認 → 概要欄作成
↓ または
2
ロール指定の場合
/g11_roledesc @ロール を実行 → 未登録確認 → 概要欄作成
⚙️ 管理者コマンドまとめ
| コマンド | 内容 | 頻度 |
|---|
/g01_chdesc | チャンネル/スレッドの未登録確認＋概要欄作成 | 概要欄作成前 |
/g11_roledesc | 指定ロールの未登録確認＋概要欄作成 | 概要欄作成前 |
/g91_unregistered | サーバー全体の未登録メンバーを確認 | 必要時 |
/g98_setnotify | 登録通知チャンネル/スレッドを設定・解除 | 必要時 |
/g99_setbutton | 登録ボタンをチャンネルに設置 | 初回のみ |
📋 コマンドまとめ（全員）
| コマンド | 内容 |
|---|
/a01_register | 自分のSNS情報を登録・更新する |
/a02_myprofile | 自分の登録情報を確認する |
/a03_profile @ユーザー | このサーバー内のメンバーの登録情報を確認する（他のサーバーの人には見られません） |
/a04_delete | 自分の登録情報を削除する |
登録ボタンを押すか /a01_register を実行すると入力フォームが表示されます。
1枚目：基本情報の入力
- 「表示名」を入力（任意・空欄の場合はDiscordの名前を使用）
- 「X URL」を入力（必須）
- 「YouTube URL」を入力（任意）
- 「Twitch URL」を入力（任意）
- 「送信」を押す
twitter.com のURLを入力した場合は自動的に x.com に変換されます。
1枚目送信後に表示されるボタン
| ボタン | 説明 |
|---|
| 追加URLを入力する | ニコニコ・Bluesky などを登録する（2枚目フォームが開く） |
| 登録情報を確認する | 現在の登録内容を確認する（自分にだけ見える） |
| サブ垢として登録する | このアカウントをサブ垢として設定する（参加者一覧に表示されなくなる） |
2枚目：追加URLの入力（任意）
- 「追加URL① 名前」にサービス名を入力（例：ニコニコ）
- 「追加URL① URL」にURLを入力
- 追加URL②も同様に入力（任意）
- 「送信」を押す（入力不要な場合はそのまま送信でOK）
名前とURLは必ず両方入力してください。片方だけ入力した場合、参加者一覧に表示されません（データは保存されます）。
1枚目送信後の「サブ垢として登録する」ボタンを押すと設定できます。
- サブ垢に設定すると参加者一覧に表示されなくなります
- もう一度ボタンを押すと「メイン垢に戻す」ことができます
- /a02_myprofile でサブ垢かどうか確認できます
| コマンド | 説明 |
|---|
/a02_myprofile | 自分の登録情報を確認する（自分にだけ見える） |
/a03_profile @ユーザー | このサーバー内のメンバーの登録情報を確認する（自分にだけ見える） |
自分の登録情報を削除します。確認ボタンを押すと削除されます。
- 削除後も
/a01_register で再登録できます
- 削除中は参加者一覧に表示されません
- /a02_myprofile で削除済みであることが確認できます
📋 コマンドまとめ（管理者）
| コマンド | 内容 |
|---|
/g01_chdesc [#ch/#thread] | チャンネル/スレッドの未登録確認＋概要欄作成 |
/g11_roledesc @ロール | 指定ロールの未登録確認＋概要欄作成 |
/g91_unregistered | サーバー全体の未登録メンバーを確認 |
/g98_setnotify | 登録通知チャンネル/スレッドを設定・解除 |
/g99_setbutton | 登録・確認ボタンをチャンネルに設置（初期設定） |
未登録者の確認から概要欄の作成までを1コマンドで行えます。
| 使い方 | 説明 |
|---|
/g01_chdesc | 実行したチャンネル/スレッドのメンバーで処理 |
/g01_chdesc #チャンネル | 指定したチャンネルのメンバーで処理 |
/g01_chdesc #スレッド | 指定したスレッドのメンバーで処理 |
全員登録済みの場合
- 「✅ 全メンバーが登録済みです！概要欄を作成しますか？」と表示される
- 「📋 概要欄を作成する」ボタンを押すと参加者一覧が投稿される
未登録者がいる場合
- 未登録者一覧が自分にだけ表示される
- 「📢 登録を促す」または「📋 このまま概要欄を作成する」を選択する
- 「登録を促す」を押すと未登録者にメンション＋登録ボタンが送信される
別チャンネルを指定した場合、メンションは指定したチャンネルに送信されます。20人以上の場合は確認ボタンが表示されます。
指定したロールのメンバーで未登録確認から概要欄作成まで行えます。
全員登録済みの場合
- 「✅ 全メンバーが登録済みです！概要欄を作成しますか？」と表示される
- 「📋 概要欄を作成する」ボタンを押すと参加者一覧が投稿される
未登録者がいる場合
- 未登録者一覧が自分にだけ表示される
- 「📋 このまま概要欄を作成する」または「❌ キャンセル」を選択する
未登録者は名前のみ表示されます。20人以上の場合は確認ボタンが表示されます。
サーバー全体でSNS情報を登録していないメンバーの一覧を確認できます（自分にだけ見える）。
大人数のサーバーでは処理に時間がかかる場合があります。通常は /g01_chdesc または /g11_roledesc の使用を推奨します。
メンバーがボタンから簡単に登録できるようになります。初回のみ実行してください。
- ボタンを設置したいチャンネルで /g99_setbutton を実行
- 「SNS情報を登録・更新する」「登録情報を確認する」のボタンが投稿される
- メンバーはボタンを押すだけで登録できる
ボタンはBot再起動後も有効なまま維持されます。
実行時に notify_channel オプションで通知先チャンネル/スレッドを指定すると、メンバーが登録した際に通知が届きます（任意）。
メンバーが登録した際に、指定したチャンネルまたはスレッドへ「○○さんが登録しました。」と通知します。
- /g99_setbutton 実行時に notify_channel を指定した場合は設定不要です
- 後から設定・変更する場合は /g98_setnotify #チャンネル（またはスレッド）を実行
- 通知を解除する場合は /g98_setnotify をオプションなしで実行
チャンネル・スレッドどちらでも指定できます。