スラッシュコマンド一覧
ヨンヒがすべてのサーバーに登録するスラッシュコマンドは 18個です。ここにない名前は使えないコマンドです。 /음악 재생 のように2段階で入るコマンドはなく、すべて1段階ですぐに実行されます。
ひと目で見る
| コマンド | オプション | できること |
|---|---|---|
/재생（再生） | 검색어（検索ワード、必須）、소스（ソース） | 曲または再生リストをキューの後ろに追加し、止まっていればすぐに再生をはじめます |
/검색（検索） | 검색어（必須）、소스 | 結果を最大10曲まで選択メニューで表示し、選んだものだけをキューに入れます |
/다음재생（次に再生） | 검색어（必須）、소스 | /재생 と同じですが、キューのいちばん前に割り込ませます |
/현재곡（再生中の曲） | — | いまの曲のタイトル・アーティスト・経過時間・ソース・音量・リピートモードを表示します |
/대기열（キュー） | — | いまの曲と次の曲の一覧を表示します |
/일시정지（一時停止） | — | 再生を止めます |
/다시재생（再開） | — | 止めた再生を続きから再開します |
/정지（停止） | — | 再生を止めて、キューをすべて空にします |
/스킵（スキップ） | — | 現在の曲を飛ばします |
/들어와（参加） | — | 自分がいるボイスチャンネルにボットを呼びます（曲は入れません） |
/나가（退出） | — | ボットをボイスチャンネルから退出させます |
/반복（リピート） | 모드（モード、必須） | リピートモードを変えます |
/섞기（シャッフル） | — | キューに残っている曲の順番をランダムに並べ替えます |
/볼륨（音量） | 값（値） | 値を入れると音量を変え、空けると現在の音量だけを知らせます |
/탐색（シーク） | 시간（時間、必須） | 現在の曲の特定の位置に移動します |
/음악노드_확인（音楽ノードの確認） | — | 音楽再生サーバーの接続状態を表示します |
/cmd_dashboard_name | — | ウェブダッシュボードへのリンクボタンを表示します（下記参照） |
/정보（情報） | — | ボット全体の状態と応答速度、このサーバーの再生状況を表示します |
応答はすべて自分にだけ表示されるメッセージで届きます。キューに曲を入れても、チャンネルには何も残りません。
オプションの詳細
| オプション名 | 使うコマンド | 必須 | 入力の形 |
|---|---|---|---|
검색어（検索ワード） | /재생 /검색 /다음재생 | はい | 自由入力。曲名か公式リンク |
소스（ソース） | /재생 /검색 /다음재생 | いいえ | 決まった選択肢4つ |
모드（モード） | /반복 | はい | 決まった選択肢3つ |
값（値） | /볼륨 | いいえ | 整数 0 〜 100 |
시간（時間） | /탐색 | はい | 自由入力。時間の形式の文字列 |
オプションにオートコンプリートはありません。 검색어 を入力している途中で候補が表示されることはなく、すべて入力してから Enter を押すと検索がはじまります。
소스 の選択肢
YouTube · YouTube Music · SoundCloud · Spotify の4つです。 空けておくと、リンクでない限り YouTube の検索になります。それぞれのソースが実際にどう違うかは 検索とソースの選び方 で説明しています。
모드 の選択肢
꺼짐（オフ）· 현재 곡（現在の曲）· 대기열（キュー）の3つです。それぞれのモードの意味は キュー・リピート・シャッフル にあります。
시간 の入力
1:23、1:02:03、90s、2m、1h、500ms、そして数字だけを書くと秒として読みます。 読み取れないときは次のメッセージが出ます。
❌ 시간을 이해하지 못했어요. `1:23`, `90s`, `2m`처럼 입력해주세요（「時間を読み取れませんでした。1:23、90s、2m のように入力してください」という意味です。）
詳しいルールは /탐색 の時間の入力形式 を見てください。
応答の例
| 状況 | ボットが送る文言 |
|---|---|
| 曲を1つ追加 | ✅ (곡 제목 - 아티스트)을(를) 대기열에 추가했어요（（曲名 - アーティスト）をキューに追加しました） |
/다음재생 で追加 | ✅ (곡 제목 - 아티스트)을(를) 다음 곡으로 추가했어요（（曲名 - アーティスト）を次の曲として追加しました） |
| 再生リストを追加 | ✅ (목록 이름)에서 12곡을 대기열에 추가했어요（（リスト名）から12曲をキューに追加しました） |
/일시정지 | ⏸️ 재생을 일시정지했어요（再生を一時停止しました） |
/다시재생 | ▶️ 음악을 다시 재생해요（音楽を再開します） |
/정지 | ⏹️ 재생을 정지하고 대기열을 비웠어요（再生を停止してキューを空にしました） |
/스킵 | ⏭️ 현재 곡을 건너뛰었어요（現在の曲を飛ばしました） |
/섞기 | ✅ 대기열을 섞었어요（キューをシャッフルしました） |
/반복 | 🔁 반복 모드가 (모드 이름)(으)로 변경되었어요（リピートモードが（モード名）に変わりました） |
/볼륨（値なし） | 현재 볼륨: 60%（現在の音量: 60%） |
/볼륨 값: 60 | 🔊 볼륨을 60%로 설정했어요（音量を60%に設定しました） |
/탐색 成功 | 🎛️ 1:23 위치로 이동했어요（1:23 の位置に移動しました） |
/들어와 | (채널 이름)에 연결했어요!（（チャンネル名）に接続しました） |
/나가 | 음성 채널에서 나갔어요（ボイスチャンネルから退出しました） |
誰が何を使えるか
コマンドごとに必要な権限が違います。次の表は、サーバーの設定を変えていないときの初期値です。
| 操作 | 初期の権限 | 対象のコマンド |
|---|---|---|
| 一時停止 / 再開 | 誰でも | /일시정지 /다시재생 |
| スキップ | その曲を入れた人または DJ | /스킵 |
| 前の曲 | その曲を入れた人または DJ | コントローラーの ⏮️ ボタン |
| 音量 | DJ | /볼륨 |
| 停止 | DJ | /정지 |
| シーク | DJ | /탐색 |
| リピート | DJ | /반복 |
| シャッフル | DJ | /섞기 |
- サーバー管理者の権限を持つ人は、上の表に関係なくすべて使えます。
- 「DJ」は、サーバー管理者が指定した DJ ロールを持つ人のことです。指定されたロールがなければ、管理者以外は DJ の操作を使えません。
- 権限がないと
이 조작을 사용할 권한이 없어요（この操作を使う権限がありません）が出ます。 - 上の表にないコマンド（
/재생/검색/다음재생/들어와/나가/현재곡/대기열/정보/음악노드_확인）は誰でも使えます。 このうち/재생/검색/다음재생/들어와/나가はボイスチャンネルに入っている必要があり、/현재곡/대기열/정보/음악노드_확인はボイスチャンネルの外でもそのまま使えます。 /볼륨は値を入れたときだけ権限を確認します。値なしで現在の音量を尋ねるだけなら、誰でもできます。
WARNING
/나가 も誰でも使えます。同じボイスチャンネルにいる人なら、再生中の音楽を止めてボットを退出させることができ、 誰がやったかはボットは知らせません。これが困るサーバーでは、Discord のサーバー設定の連携サービス（Integrations）画面で ヨンヒの /나가 コマンドを特定のロール・チャンネルに制限しておいてください。
知っておくとよい違い
/정지 と /나가
/정지 は再生を止めてキューを空にしますが、ボットはボイスチャンネルに残ります。コントローラーカードは空のカードに変わります。 すぐに退出させたいときは /나가 を使ってください。そのままにしておくと、しばらくしてボットが自分で退出します — 詳しい条件は ボットが自動で止まったり退出したりする場合 にあります。
/스킵 とコントローラーの ⏭️ ボタン
同じ動作ですが、確認の手順が違います。コントローラーの ⏭️ ボタンは、キューに次の曲がないと 대기열에 다음 곡이 없어요（キューに次の曲がありません）と先に知らせて、何もしません。/스킵 にはその確認がありません。
/음악노드_확인 と /정보
どちらも状態を見るコマンドで、誰でも使えます。 /음악노드_확인 は、音楽再生サーバーが正常に接続されているか、いま何か所で再生中かを表示します。 /정보 は、ボット全体の状況（再生中のサーバー数、起動していた時間）、応答速度、そしてこのサーバーの現在の曲・キュー・音量・リピートモードを表示します。 音が途切れたり再生できなかったりするときは、まず /음악노드_확인 を試すと、ボットの問題かどうかがわかりやすくなります。
ダッシュボードのリンクのコマンド
ウェブダッシュボードへのリンクボタンを表示するコマンドが1つあります。
NOTE
現在このコマンドは /cmd_dashboard_name という名前で表示されます。コマンド一覧で /대시보드（ダッシュボード）を探しても出てこないので、 /cmd_dashboard_name を探してください。応答に表示されるリンクボタンは、正常にダッシュボードにつながります。
コマンドを使わずにダッシュボードに入る方法もあります。
- ブラウザのアドレス欄にダッシュボードのアドレスを直接入力します。アドレスはサーバー管理者に尋ねると教えてもらえます。
- 再生中なら、コントローラーカードの下にあるリンクボタンを押しても同じところに行けます。
入ったあとに何ができるかは ウェブダッシュボードをはじめる にあります。 プレイリスト、歌詞、再生履歴、キューの編集のように Discord のコマンドにはない機能は、ダッシュボードで使います — ダッシュボード画面の見方 を見てください。