サーバー設定 — 管理者が決めること
ヨンヒ ボットには、サーバー設定用のスラッシュコマンドはありません。サーバー管理者が触る設定は、すべてウェブダッシュボードの 설정（設定）画面にあります。
このページでは、その設定画面への入り方と、DJ 권한（DJ 権限）と 기본 권한（基本権限）の2つのセクションを詳しく説明します。ほかの項目には、それぞれ別のドキュメントがあります。
何を決められるか
| 決められること | どこで決めるか | 詳しい内容 |
|---|---|---|
| DJ として認めるロール | ダッシュボードの設定画面 | このページの下 |
| 8種類の操作の権限レベル | ダッシュボードの設定画面 | このページの下 |
| コントローラーメッセージを表示するチャンネル | ダッシュボードの設定画面 | コントローラーメッセージのチャンネル固定・統合 |
| サーバーの音量と音量の同期 | 再生画面・コマンド、同期は運営チーム | 音量ポリシーと音量の同期 |
| プレミアム（サブボット）を使うかどうか | 運営チームに依頼 | プレミアム（サブボット）を有効にする |
| 誰がダッシュボードを開けるか | Discord のロール | ダッシュボードを使える人 |
コマンドごとの使用そのものを特定のロールにだけ許可したいときは、ヨンヒの設定ではなく、Discord の サーバー設定 → 連携サービス（Integrations）→ ヨンヒ で行います。
設定画面への行き方
- ダッシュボードに Discord アカウントでログインします。
- 左のサイドバーで、設定するサーバーを選びます。
- ヘッダー右のアバターを押してユーザーメニューを開き、설정（設定）を選びます。
設定の項目はサイドバーにはなく、ユーザーメニューにしかありません。そして、そのサーバーで管理者（Administrator）の権限がないと、メニューの項目そのものが表示されません。 設定画面を開いたまま管理者ではないサーバーに切り替えると、画面は自動で「지금 재생」（再生中）に戻ります。
TIP
「設定メニューが見えません」という問い合わせのほとんどは、サーバー管理（ManageGuild） の権限しか持っていない場合です。ヨンヒの設定画面は、サーバー管理ではなく管理者の権限を必要とします。詳しいアクセスの条件は ダッシュボードを使える人 を見てください。
8種類の操作 × 4段階の権限
基本権限のセクションは、8つの操作それぞれに4段階のうち1つを指定する格子状の表です。画面のラベルと初期値は次のとおりです。
| 画面のラベル | 初期値 | 説明 |
|---|---|---|
| 볼륨 조절（音量調整） | DJ 이상（DJ 以上） | サーバー全体の音量を変える |
| 다음 곡（次の曲） | 신청자 이상（リクエストした人以上） | 現在の曲を飛ばす |
| 이전 곡（前の曲） | 신청자 이상 | 直前の曲に戻る |
| 일시정지/재생（一時停止/再生） | 모두（全員） | 再生状態を切り替える |
| 정지（停止） | DJ 이상 | 再生を止めてキューを片づける |
| 탐색（シーク） | DJ 이상 | 再生位置を移す |
| 반복 모드（リピートモード） | DJ 이상 | 1曲/キューのリピートを切り替える |
| 셔플（シャッフル） | DJ 이상 | キューの順番を並べ替える |
一度も触っていないサーバーは、上の初期値で動作します。音量とシークを使う側からどう見えるかは、/볼륨 · /탐색 にまとめています。
4段階が実際にどう判定されるか
上から順番に判定します。
- 管理者の権限があれば、設定に関係なく通ります。 管理者を「관리자만」（管理者のみ）で止めることはできません。
- レベルが 모두（全員）なら通ります。
- レベルが DJ 이상（DJ 以上）なら、DJ ロールを1つでも持っている必要があります。
- レベルが 신청자 이상（リクエストした人以上）なら、DJ ロールがあるか、いま再生中の曲をリクエストした本人である必要があります。
- レベルが 관리자만（管理者のみ）なら、1番で通らなかった人はすべて断られます。
ここでいう「リクエストした人」の基準は、操作しようとした時点で再生中の曲をリクエストした人です。キューにあるほかの曲を自分が入れていても、いま流れている曲がほかの人の曲なら、「신청자 이상」に設定された操作は使えません。
TIP
「관리자만」は、実際には「管理者の権限を持つ人だけ」と同じです。管理者以外に特定の人だけを許可したいときは、その人に DJ ロールを付けて、レベルを DJ 이상 にしておくのが適切です。
DJ ロールの登録
DJ 権限のセクションに、サーバーのロールがチップとして並びます。押してオン・オフを切り替えます。複数を同時に指定でき、そのうち1つでも持っていれば DJ として認められます。
一覧に出てこないロールが2種類あります。
@everyone- ほかのボットや連携サービスが自動で作ったロール — ニトロブースターのロールや、ほかのボット専用のロールがこれにあたります。
WARNING
DJ ロールを指定したのに誰も DJ として認められないときは、指定したロールがそのあいだに削除された可能性が高いです。設定画面を開き直したときにオンだったチップが消えていれば、そのロールはもうサーバーにありません。新しいロールを作って、もう一度指定してください。
この設定は Discord とダッシュボードに同じように当てはまります
権限の設定はダッシュボード専用ではありません。スラッシュコマンド、コントローラーのボタン、ダッシュボードのボタンが、すべて同じ基準で判定されます。
ダッシュボードのキュー操作には別の項目がなく、既存の8種類にまとめられています。
| ダッシュボードの動作 | 必要な権限 |
|---|---|
| キューをすべて消す | 정지（停止） |
| キューから1曲を削除 | 다음 곡（次の曲） |
| キューの順番を変える | 다음 곡 |
| 特定の曲にジャンプ | 다음 곡 |
権限の設定では止められない操作
8種類の基本権限は、すでに再生中の音楽を操作する動作だけを扱います。ボットを呼んだり退出させたりする動作と、曲を追加する動作には設定の項目がありません。
WARNING
/들어와（参加）· /나가（退出）· /재생（再生）· /검색（検索）· /다음재생（次に再生）は、権限の設定の影響を受けません。未対応 そのため、「정지」を DJ 이상 にしても、同じボイスチャンネルにいる人は /나가 でボットを退出させられます。これらのコマンドを特定のロールにだけ許可したいときは、Discord の サーバー設定 → 連携サービス（Integrations）→ ヨンヒ で、コマンドごとの使用権限を制限してください。
操作の経路ごとに違う追加の条件
権限レベルを通っても、経路によって条件がもう1つ付きます。この違いのせいで、「Discord ではできるのに、ダッシュボードではできない」という問い合わせが生まれます。
| 経路 | ボイスチャンネルにいる必要があるか | ボットと同じチャンネルにいる必要があるか |
|---|---|---|
| スラッシュコマンド | 必要 | 自分がいるチャンネルを基準に、対象のボットを選びます |
| コントローラーのボタン | 不要 | 不要 |
| ダッシュボードの操作 | 必要 | 必要 |
TIP
コントローラーメッセージは、ボイスチャンネルの外からでも押せます。誰でも入れるチャンネルにコントローラーがあると、「停止」が何度も押されることがあります。コントローラーを特定のチャンネルに固定し、そのチャンネルの閲覧権限を制限するのが実際的な対策です。コントローラーメッセージのチャンネル固定・統合 を見てください。
저장（保存）ボタンを押すと反映されます
チップやボタンを押しても、その時点では画面の中で変わるだけです。右上に 저장되지 않음（保存されていません）が表示され、저장（保存）ボタンを押すと実際に適用されます。
保存すると、コントローラーメッセージが削除されてから作り直されます。権限だけを変えても、コントローラーがチャンネルのいちばん下にまた出てくるので、驚く必要はありません。
WARNING
保存していない変更は、サーバーを切り替えた瞬間に警告なしで消えます。 サイドバーでほかのサーバーを選んだときも、自分がボイスチャンネルを移ってダッシュボードが自動でサーバーを切り替えたときも、どちらもリセットされます。症状は「チップをいくつか押しておいて、ほかのサーバーを見てから戻ったら、저장됨（保存済み）に戻っていた」というものです。ヘッダー右に 저장되지 않음 が表示されているあいだは、サーバーを切り替えずに、先に 저장 を押してください。