トラブルシューティングとフィードバック

Turboism が起動しない

• 意図した Preview directory と Turboism home を使用していることを確認します。
• Preview が所有する、または home が所有する log directory にある Java Agent と Runtime のログを確認します。
• 使用中の Cubism インストールがサポート対象の Preview envelope と一致することを確認します。
• identity failure を回避するために Cubism JAR、DLL、BAT ファイル、ライセンスコンポーネントを置き換えないでください。

プラグインが表示されない

次を確認してください。

• マネージド JAR のインストールが再起動後に完了している、または手動の JAR が <turboism.home>/plugins/ のルート直下にある（サブディレクトリにない）。
• 両方の起動で同じ Turboism home が使われている。
• 同じ plugin ID の古い JAR が残っていない（重複 ID は DUPLICATE_PLUGIN_ID で失敗する）。
• JAR に META-INF/turboism/plugin.json が正確に 1 つある。
• マニフェストが schema version 2 を使用している。
• entrypoint class が存在し、public で、TurboismPlugin を実装し、public no-argument constructor を持つ。
• Turboism API range と required dependencies が解決される。
• plugin ID が disabled または重複していない。
• environment.requiresCubism が現在の environment と一致する。

JAR が拒否される

マネージド JAR は、シンボリックリンクまたは通常ファイルでない source、16 MiB 上限を超える size、壊れた path、duplicate entry、special file、META-INF/turboism/plugin.json の欠落または重複などを理由に拒否されることがあります。

descriptor の ID/version/API 不一致、コピーされた SDK/Runtime/Live2D class、native または installer payload、nested JAR、missing entrypoint、undeclared resource も拒否されます。

現在の plugin source から JAR を再ビルドしてください。アーカイブを手動で編集したり、inspection を無効にしたりしないでください。上記の理由はマネージド preflight の説明です。手動コピーはこれをスキップし、startup validation で強制される違反のみが Runtime の startup diagnostics に現れます。

操作が pending のままになる

プラグインの install、replacement、enable、disable、uninstall 操作は Cubism の再起動後に適用されます。

• Cubism が完全に終了し、再起動されたことを確認します。
• 両方の起動で同じ turboism.home が使われていることを確認します。
• Runtime state とログを確認します。
• Turboism の実行中に plugin、config、pending-state ファイルを編集しないでください。

ホスト capability が利用できない

これは多くの場合、host version、Cubism ファイルの識別情報、mapping verification、Provider availability、safe mode、stale object generation が原因で意図的に fail-closed になった結果です。

正確な Cubism version、Cubism ファイルの識別情報、operation、diagnostic code を記録してください。リフレクションやホストへの直接アクセスで失敗を迂回しないでください。

フィードバック

フィードバックと機能要望から、Discord、GitHub、メールでバグを報告したり、フレームワークやプラグインの機能を提案したりできます。