NeoJukeProの使い方

概要

NeoJukeProはJavaで構成されたDiscordのための音楽Botプログラムです。
より使いやすく、高機能で安定して動作する事を意識して開発しています。
比較的簡単に誰でもホストできる他、開発元による公式ホスト版の提供もあります。

ダウンロードとホスト版の追加

ダウンロード

最新版をGithub Releaseからダウンロードすることができます。

Release NeoJukePro v1.7.0 · nafu-at/NeoJukePro
NeoJukePro v1.7.0 New Features Added the function to play from the specified time when a timed YouTube link is specified. If a timed track exists in the list, ...

公式ホスト版

Stable版は以下のリンクからサーバーに参加させる事ができます。

Discord - A New Way to Chat with Friends & Communities
Discord is the easiest way to communicate over voice, video, and text. Chat, hang out, and stay close with your friends and communities.

使い方

自分でホストする場合

NeoJukeProを動作させるには以下のソフトウェアが必要です。

  • Java 11以降の実行環境
  • MySQL 5.5以降 もしくは MariaDB 5.5以降

公式ホスト版を使用する場合

上記リンクからサーバーにBotを追加することにより使用を開始できます。

コマンド

BotコマンドはBotに予め設定された接頭辞の後にコマンドを指定することにより実行できます。
例えば公式ホスト版の接頭辞は ;; です。

CommandAliasDescription
helphコマンドのヘルプを表示します。
settingssetギルド固有の設定を変更します。
statusstatsプレーヤーの現在の状態を表示します。
joinjBotを音声チャネルに接続します。
leavelvBotを音声チャンネルから切断します。
nowplayingnp現在再生中のトラックに関する詳細情報を表示します。
listlBotに登録されているキューの一覧を表示します。
playpBotにキューを追加します。
searchseキーワードをYouTubeで検索します。
replayre現在再生中のトラックをもう一度再生します。
interruptinキューへトラックを割り込ませます。
pause再生中のトラックを一時停止します。
stopst, sプレーヤーを終了します。
skipskトラックをスキップします。
seek現在再生中のトラックをシークします。
volumevolプレーヤーの音量を変更します。
repeatrepプレーヤーの繰り返し設定を変更します。
shuffleshプレーヤーのシャッフル設定を変更します。
deletecleanBotによって投稿された最新の100メッセージを削除します。

Playコマンド

Playコマンドの基本形はコマンドの後ろにURLを指定します。

;;play https://youtu.be/RsOBIlmCHqI

PlayコマンドではYouTubeのプレイリストも指定できます。

;;play https://www.youtube.com/playlist?list=PL1NeGg1woXqlISJkxjgwHKgB8LmR7tk92

Playコマンドで指定できるURLは以下のサービスです。

  • YouTube
  • SoundCloud
  • BandCamp
  • Vimeo
  • Twitch
  • HTTP
  • Local FIle (Botが動作しているサーバー内のファイル)

PlayコマンドはSearchコマンドで検索した動画を再生する際にも使用します。

Searchコマンド

Searchコマンドの基本形はコマンドの後ろに検索したいキーワードを指定します。

;;search Cutie Panther

検索を実行すると候補が表示されます。
目的の動画が見つかったらPlayコマンドを使用して検索を終了します。

目的の動画が見つからない場合はページをめくることができます。

;;search next

また、めくったページを戻すこともできます。

;;search prev

Interruptコマンド

Interruptコマンドの基本形はコマンドの後ろに割り込む位置とURLを指定します。

;;interrupt 3 https://youtu.be/V10UuEWM1k8

InterruptコマンドもPlayコマンド同様プレイリストを指定できます。
この場合プレイリストの中身全てが指定されたトラック以降に追加されます。

;;interrupt 2 https://www.youtube.com/playlist?list=PLXuGkVLvpfdpcSKTh6BTjqcy3rTOVCoY8

Settingsコマンド

SettingsコマンドはBotのギルド固有の設定を変更できます。

SettingDescriptionValue
prefixBotがメッセージをコマンドとして認識するための接頭辞を設定します。String
robotBotからのメッセージをコマンドとして認識する機能の有効無効を切り替えます。Bool
autoplayキューの最後がYouTube動画の場合、
自動的に関連動画を続けて再生する機能の有効無効を切り替えます。
Bool

Settingsコマンドの基本形はコマンドの後ろに変更する設定と設定値を指定します。

;;settings prefix !!
;;settings autoplay true

接頭辞を忘れてしまった場合や、他のBotと被っていて操作ができない場合は
接頭辞と同じようにメッセージの先頭にBot宛のメンションを付けると同様に操作可能です。

AutoPlayはBotの設定で関連動画検索機能が有効化されている場合にのみ使用可能です。
この機能は多くのAPIリソースを消費するため、常時有効化はおすすめしません。

その他の機能

Playコマンドメッセージ自動削除

BotにMessageManage権限が付与されている場合は、
Playコマンドが実行された際に自動的に送信されたPlayコマンドメッセージを削除します。
Searchコマンドと組み合わせて実行された場合はSearchコマンドも同時に削除します。

無人時自動退出

ボイスチャンネルにBot以外のユーザーが居なくなった場合、
ボイスチャンネルから自動的に退出します。
この時再生中のトラックは一時停止されます。


高度な使い方

Module機能

あなたがBotのホストである場合、
Moduleを追加してBotの挙動を変更したり機能を追加することができます。
NeoJukeProのモジュールはJavaの知識があればとても簡単に作成することができます。

NeoJukeProのModuleを作る 【準備中】

タイトルとURLをコピーしました