トラブルシューティング / Troubleshooting
ここでは、Commander API の使用中に発生する可能性のある一般的な問題とその解決方法について説明します。 ここで紹介するトラブルシューティングの手順を試しても問題が解決しない場合は、GitHub の IssueまたはDiscord サーバーでサポートを求めてください。
Commander API が正しく動作しない
ベータAPI が無効になっている
ワールド設定 > 実験的 > ベータAPI を有効にしてください。
Commander API が最新バージョンに更新されていない
マイクラのアップデート直後に発生することがあります。
Commander API が最新のマイクラに対応しているか確認し、必要に応じて最新バージョンに更新してください。
一部機能（EventやScriptEvent）が動作しない
設定で無効化されている
/scriptevent capi:config コマンドで設定メニューを開き、該当するイベントや機能が有効になっていることを確認してください。初期化すると、すべてのイベントが有効になります。
設定を移行していない
Commander API のアップデート後に、設定を移行する必要がある場合があります。
/scriptevent capi:config コマンドで設定メニューを開き、設定の移行 ボタンをクリックして設定を移行してください。
./Config/#最新バージョンの設定に移行
./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>
デバッグモードを有効にする
./Config/#基本設定
./Config/#基本設定
テストを実行する
./Config/#基本設定
./Config/#基本設定
test
./ScriptEvent/test