トラブルシューティング / Troubleshooting
ここでは、Commander API の使用中に発生する可能性のある一般的な問題とその解決方法について説明します。 ここで紹介するトラブルシューティングの手順を試しても問題が解決しない場合は、GitHub の IssueまたはDiscord サーバーでサポートを求めてください。
Commander API が正しく動作しない
ベータAPI が無効になっている
ワールド設定 > 実験的 > ベータAPI を有効にしてください。
Commander API が最新バージョンに更新されていない
マイクラのアップデート直後に発生することがあります。
Commander API が最新のマイクラに対応しているか確認し、必要に応じて最新バージョンに更新してください。
一部機能（EventやScriptEvent）が動作しない
設定で無効化されている
/scriptevent capi:config コマンドで設定メニューを開き、該当するイベントや機能が有効になっていることを確認してください。初期化すると、すべてのイベントが有効になります。
設定を移行していない
Commander API のアップデート後に、設定を移行する必要がある場合があります。
/scriptevent capi:config コマンドで設定メニューを開き、設定の移行 ボタンをクリックして設定を移行してください。
コマンドブロックを無効にしている
/gamerule commandblocksenabled true
ゲームルールが正しく設定されていない
/gamerule maxcommandchainlength 65536
マクロが正しく動作しない
Commander API のScriptEvent内で動かしていない。
以下のようなコマンドでは、マクロは動作しません。
/title @a actionbar <!name>
マクロは、必ず /scriptevent capi:<イベント名> の中で使用してください。
/execute as @a run scriptevent capi:actionbar <!name>
/execute as @p run scriptevent capi:run title @a actionbar <!name>
プレイヤーが基準になっていない
以下のようなコマンドでは、どのプレイヤーの名前を表示すれば良いか分からないため、マクロは動作しません。
/scriptevent capi:run title @a actionbar <!name>
マクロを使用する場合、必ず /execute as <プレイヤー> などで、基準となるプレイヤーを指定してください。
/execute as @a run scriptevent capi:run title @s actionbar <!name>
Scoreマクロが正しく動作しない
そのプレイヤーのスコアが設定されていない
Scoreマクロは、指定されたスコアが存在しない場合、展開されません。
Calcマクロが正しく動作しない
中身が式でない場合、Calcマクロは展開されません。
例えば、以下のような場合、Calcマクロは展開されません。
/scriptevent capi:actionbar <!calc=100>
Calcマクロを使用する場合、必ず中身が式であることを確認してください。
/scriptevent capi:actionbar <!calc=50 + 50>
チャットを送信できない
チャットのキャンセルで誤った正規表現パターンを設定している
機能を無効にするか、正しい正規表現パターンを設定してください。
他のアドオンと競合している
チャット関連の機能は他のアドオンと競合することがあります。
競合が疑われる場合は、以下の対処法を実行してください。
- アドオンの順序を変更する
- チャットのキャンセルを無効にする
- Commander API のチャット関連の機能を全て無効にする
- 競合するアドオンの使用を諦める
- 喋ることを諦める