よくある質問 (V2)
注意: この FAQ は V2 バージョンにのみ適用されます。V4 については よくある質問 を確認してください。
音楽再生時に音が出ません
KCauldron を使用している場合、申し訳ありませんがサポートしていません。
それでも Mod サーバーで ZMusic を使いたい場合、よくある方法は 2 つあります。
- BungeeCord または WaterFall のようなプロキシサーバーを使用する
- Arclight、LoliServer、Mohist、Uranium など、このプラグインで 動作する可能性がある Mod サーバーコアを使用する
Spigot、Paper、Yatopia、Sugarcane などの通常のプラグインサーバー を使用している場合、次の条件を満たしているか確認してください。
- クライアントに ZMusic Mod（1.7.10、1.12 以上）または AudioBuffer Mod（1.12 以下）がインストールされている
- サーバーに ZMusic プラグインが正しくインストールされている
- サーバー側には ZMusic Mod ではなく ZMusic 系プラグインをインストールしている
- クライアントは純粋なバニラではなく Fabric または Forge を使用し、AudioBuffer か ZMusic Mod が入っている
- ネットワーク接続が安定している
- 使用している音楽ソースが NetEase Cloud Music である
どれか 1 つでも満たしていない場合は、まず環境を見直してください。
すべて満たしていても再生できない場合は、外部 API を設定せず NetEase Cloud Music でテストすることを勧めます。
実際には、自分で管理できるサーバー環境で運用することも推奨します。
サーバー起動後に /zm コマンドを使うと「プラグインの読み込みが完了するまで待ってください」と表示されます
この問題が発生した場合は、ZMusic を最新バージョンに更新してください。
プラグインが読み込めず、AllMusic/AudioBuffer を削除するように表示されます
サーバーの plugins フォルダから AllMusic/AudioBuffer プラグインを削除してください。
新しい ZMusic では BossBarAPI、ActionBarAPI、AudioBuffer を廃止しており、Mod 通信チャンネルの競合を防ぐためです。
再生成功後にクライアント側で非常に長い経過時間が表示されますが、実際の再生時間は短いです
同じリクエストボタンを短時間に連続でクリックすると、内部スレッドの処理が追いつかず誤った経過時間が表示されることがあります。実際の再生には影響しません。
NetEase Cloud Music へのログイン時に java.net.UnknownHostException が発生します
多くの場合、設定ファイルの外部 API ドメインが誤っています。
ドメインが正しい場合は、サーバーの DNS が正常か確認するか、DNS キャッシュをフラッシュしてください。
パネル型ホスティングでは通常この問題は起こりません。
プラグイン読み込み時に java.lang.NoClassDefFoundError com/google/gson/xxx が発生します
サーバーに gson ライブラリが含まれていません。gson を同梱したプラグインを入れてください。
曲のリクエスト成功後、コンソールに黄色い警告が出続けます
2.5 以降、旧来の進行表示コールバックは廃止されています。最新バージョンへ更新してください。
ZMusic を導入した後、クライアントが起動しません (Fabric)
- ダウンロードした Mod の種類が正しいか確認してください。たとえば Fabric を使っているのに
zmusic-forge-X.X.X-X.X.X.jarを入れると動作しません。 - Fabric 版を使う場合は
Fabric-APIがインストールされているか確認してください。 - この Mod は
CardBoardと互換性がありません。
プラグイン起動後に「プラグインの読み込みが完了するまで待ってください」というエラーが出ます
次の点を確認してください。
- 最新版のプラグインを使用しているか
ZMusicプラグインディレクトリに書き込み権限があるか- サーバーが非同期スレッドをサポートしているか
ZMusicディレクトリ内にlanguageフォルダを作成し、リポジトリのmasterブランチにあるzh_cn.jsonを配置してから再読み込みまたは再起動する
1.7.10 はサポートされていますか？
1.7.10 の利用は推奨していません。どうしても使う場合は次を理解してください。
Mohist/Uraniumサーバーコアのみ対応Uraniumはdev-4-b210のみ検証Mohistは1.7.10-42のみ検証- 歌詞表示はチャット以外基本的に利用不可（Uranium を除く）
- Uranium 用 Mod を併用すると Title/ActionBar 表示が使える場合がある
1.7.10に関する不具合報告は受け付けていない
プラグインはサーバーを重くしますか？
ラグが起きる場合、たまたま別のプラグインが同じタイミングで負荷を出していることがほとんどです。
大悲咒をリクエストするとサーバーが落ちるという噂もあります。
もし本当に上記のようなクラッシュが起きたなら、クラッシュ前に表示された赤いスタックトレースを送ってください。できるだけ早く調査します。
安全のため、プロキシ構成なら ZMusic はプロキシ側のプラグインディレクトリに置くことを勧めます。
DeluxeMenu/TrMenu などのメニュープラグインから ZMusic コマンドを実行できません (BungeeCord/WaterFall)
これはプロキシ構成でよくある制限です。ZMusic のコマンドはプロキシコア側に登録されますが、メニュープラグインは Spigot/Paper 側のコマンドしか実行できません。
現実的な回避策は、ユーザーに自分でコマンドを入力してもらうことです。
zmusic.use 権限があるはずなのに権限不足と表示される
BungeeCord/Waterfall を使用している場合は、プロキシ側に LuckPerms-Bungee を入れ、/lpb で権限を付与してください。
[Sponge] サーバー側でオンライン音楽を読み込めません
このプラグインは Sponge をサポートしていません。3.0 をお待ちください。現在の 3.0 テスト版でも Sponge は部分対応のみです。
上記に該当する問題が見つかりません
コミュニティに参加してください。エラーメッセージがある場合は、コンソール出力を mclo.gs にアップロードし
リンクを共有してください。
ドキュメントは継続的に改善中です。