V2 ドキュメント
v2 ドキュメント
ZMusic ヘルプドキュメントへようこそ。ここには必要なすべてのヘルプがあります。音声が再生されないなどの問題をトラブルシューティングする必要がある場合は、こちらをクリックしてください。
紹介
これは強力な音楽システムで、以下の機能をサポートしています。
- 全サーバーでのリクエスト
- 個別再生
- 歌詞表示
- 歌詞翻訳表示
- 複数の検索ソース(NetEase/Bilibili)
- キーワード検索
- 個人プレイリスト
- 全サーバープレイリスト
- プレイリスト再生(NetEase)
- 音量調整(1.12以降対応)
- BungeeCord 対応
クライアント Mod について
このプラグインを使用するには、クライアントに対応する Mod をインストールする必要があります
- 1.8-1.11 のクライアントの場合 AudioBuffer Mod をインストール
- 1.12.2-1.19 のクライアントの場合 ZMusic Mod をインストール
BungeeCord について
- BungeeCord 側のみに ZMusic-Plugin プラグインをインストールする必要があります(子サーバーには不要)
- BungeeCord は現在 1.9-1.19 のサーバーのみサポートしています
- BungeeCord は一時的に経済システムをサポートしていません
- 子サーバーで Papi 変数や進行状況表示などの機能を使用するには、子サーバーに ZMusic-Addon プラグインをインストールするだけです
動画
フィードバック
- Gitee または Github で Issues を提出
- QQ グループ:1032722724 でフィードバック
コマンド
メインコマンド
/zmメインコマンド/zm helpヘルプを表示/zm play音楽を再生/zm music全サーバーリクエスト/zm search音楽を検索/zm playlistプレイリストシステム/zm stop再生を停止/zm loginNetEase Cloud Music にログイン
再生
曲名で音楽を検索し、直接再生します
コマンド
/zm play [検索ソース] [曲名]
例
/zm play netease 你的猫咪
リクエスト
曲名で音楽を検索し、全サーバーに送信後、プレイヤーがクリックして再生
コマンド
/zm music [検索ソース] [曲名]
例
/zm music netease 你的猫咪
検索
曲名で音楽を検索し、10曲のリストを返します
コマンド
/zm search [検索ソース] [曲名]
例
/zm search netease 你的猫咪
プレイリスト
プレイリストをインポートしてサーバーに保存し、プレイリストの再生を便利にします。
コマンド
/zm playlist [プラットフォーム] [サブコマンド]
現在以下のプラットフォームをサポートしています
- netease/163 - NetEase Cloud Music
プラットフォームが type の場合、プレイリストの再生方法を設定します。 現在サポートしているもの
- normal - 順次再生
- loop - ループ再生
- random - ランダム再生
例: /zm playlist type random
プラットフォームが global の場合、グローバルプレイリストモードです。
- サブコマンドは通常モードと同じ
例: /zm playlist global netease list
サブコマンド 対応するプラットフォームのサブコマンド
importプレイリストのリンクを通じてプレイリストをインポート- パラメータ
プレイリストリンク対応するプラットフォームのプレイリストリンク
- パラメータ
list指定したプラットフォームのプレイリスト一覧を取得playプレイリスト ID でプレイリストを再生(list で取得可能)- パラメータ
プレイリストID指定したプラットフォームのプレイリスト ID
- パラメータ
例
インポート:
/zm playlist 163 import https://music.163.com/#/playlist?id=363046232
再生:
/zm playlist 163 play 363046232
管理者
管理者関連の操作、全サーバー強制再生、設定の再読み込みなど
コマンド
/zm playall [検索ソース] [曲名] 全サーバー強制再生 /zm stopAll 全サーバー再生を強制停止 /zm reload 設定ファイルを再読み込み
例
/zm playAll netease 你的猫咪
権限
一般プレイヤー権限
zmusic.use play, stop などの一般コマンドを使用可能
管理者権限
zmusic.admin playAll, stopAll などの管理者コマンドを使用可能
設定ファイル
{
// 設定ファイルのバージョン(変更しないでください)
"version": 11,
// アップデートを確認するかどうか
"check-update": true,
// プラグインのメッセージプレフィックス
"prefix": "&bZMusic &e>>> &r",
// デバッグモードを有効にするかどうか
"debug": false,
// API設定
"api": {
// NetEase Cloud Music APIアドレス
//
// オープンソースプロジェクトNeteaseCloudMusicApiを使用
// 自己デプロイを推奨、Node.js環境が必要
// URL: https://github.com/Binaryify/NeteaseCloudMusicApi
"netease": "https://ncm.zhenxin.me/"
},
// 作者のNetEase Cloud Musicアカウントをフォローするかどうか
"netease-follow": true,
// ZMusic VIP 設定
"vip": {
// 認証アカウント
"account": "1307993674",
// 認証シークレット
"secret": "none"
},
// リクエスト設定
"music": {
// リクエストで差し引かれるコイン(0に設定すると差し引かれません)
// zmusic.bypassを持つプレイヤーは差し引かれません
"money": 10,
// リクエストのクールダウン時間(0に設定するとクールダウンなし)
// zmusic.bypassを持つプレイヤーはクールダウンなし
"cooldown": 5
},
// 歌詞設定
"lyric": {
// 歌詞を有効にするかどうか
"enable": true,
// 歌詞翻訳を表示するかどうか
"showLyricTr": true,
// 歌詞の色
"color": "&b",
// 以下は表示方法の設定、同時に有効にできます
// BossBarで歌詞を表示するかどうか(1.8以下は非対応)
"bossBar": true,
// ActionBarで歌詞を表示するかどうか
"actionBar": false,
// Titleで歌詞を表示するかどうか
"subTitle": false,
// チャットメッセージで歌詞を表示するかどうか
"chatMessage": false,
// Hud 設定(1.12以降のみ対応)
"hud": {
// Hudを有効にするかどうか
"enable": true,
// 情報のX座標
"infoX": 2,
// 情報のY座標
"infoY": 12,
// 歌詞のX座標
"lyricX": 2,
// 歌詞のY座標
"lyricY": 72
}
}
}変数
%zmusic_playing_name%現在再生中の曲名を取得%zmusic_playing_singer%現在再生中の歌手を取得%zmusic_playing_lyric%現在の時間に表示される歌詞を取得%zmusic_time_current%現在再生中の音楽の時間を取得%zmusic_time_max%現在再生中の音楽の最大時間を取得%zmusic_playing_platform%- 現在再生中の音楽のプラットフォームを取得%zmusic_playing_source%- 現在再生中の音楽のソースを取得
前提プラグイン
全バージョンで使用
PlaceholderAPI[オプション] 上記の変数を使用する場合にインストールVault[オプション] リクエスト課金を使用する場合にインストール
1.5, 1.6 バージョンで使用
AudioBuffer[必須] 音楽再生に使用、スレッドに対応する Mod があり、クライアントにインストールが必要
1.4 以下のバージョンで使用
AudioBuffer[必須] 音楽再生に使用、スレッドに対応する Mod があり、クライアントにインストールが必要BossBarAPI[オプション] BossBar で歌詞を表示する場合にインストールActionBarAPI[オプション] ActionBar で歌詞を表示する場合にインストール
検索ソースの説明
検索ソース は音楽を検索するプラットフォームです 現在以下のプラットフォームをサポートしています
- netease/163 - NetEase Cloud Music
- kuwo - Kuwo Music
- bilibili - Bilibili Music
QQ Music API は完全に削除されました。Kugou Music は再生時に問題が発生する可能性があります
曲名 ID 化の説明
- 曲名を
-id:音楽IDに置き換えるだけ - 現在 NetEase と Bilibili Music をサポート
- 例:
/zm play bilibili -id:374305