互換性
Turboism リリース別の対応 Cubism Editor バージョン、ファーストパーティプラグインの対応範囲、マイナーライン別のケイパビリティカバレッジ、および証拠に基づくホスト境界。
Turboism における Cubism Editor のバージョン対応は、インストールする Turboism のリリースと、使用する個々のプラグインまたは SDK ケイパビリティの両方に依存します。対応する Cubism ホストプラットフォームは Windows x64 です。一覧にない Editor バージョンは互換性があるとは主張されず、利用できない adapter やケイパビリティは未検証の経路へフォールバックせず fail closed で失敗します。
Turboism リリース別の対応バージョン
各 Turboism リリースには、レビュー済みの Cubism Editor バージョン集合が組み込まれ、リリースメタデータで宣言されています。
- 現在の Stable
0.67.4は、すべての 0.67.x 安定版（0.67.0、0.67.1、0.67.2）と同様に、Windows x64 上の 5.0.00 から 5.3.04 までのレビュー済み全 20 の Cubism Editor バージョン（5.0.00–5.0.06、5.1.00–5.1.03、5.2.00–5.2.03、5.3.00–5.3.04）に対応しています。 - 以前の安定版
0.44.0は、正確なバージョン 5.2.03、5.3.02、5.3.03 のみに対応していました。履歴としてのみ記載しています。
| Turboism リリース | チャンネル | 対応する Cubism Editor バージョン | ホストプラットフォーム |
|---|---|---|---|
0.67.4 | Stable（安定版） | 5.0.00–5.3.04 (全 20 個のレビュー済みバージョン) | Windows x64 |
0.44.0 | Stable（安定版） | 5.2.03, 5.3.02, 5.3.03 (3 個の正確なレビュー済みバージョン) | Windows x64 |
turboism/Turboism リポジトリのコミット 5e0f8b02c におけるレビュー済み互換性データから生成（レビュー済み Cubism Editor 全 20 バージョン: 5.0.00–5.3.04）。
Beta および Nightly ビルドは、それぞれのリリースメタデータで独自のバージョン集合を宣言します。ダウンロードページでチャンネルごとに表示されます。
同一マイナーライン内のパッチ継続性
同一の Cubism Editor マイナーライン（5.0.x、5.1.x、5.2.x、または 5.3.x）内では、新しいパッチリリースは常に古いパッチリリースの上位集合です。5.x.y で許可されるケイパビリティと Editor コマンドは、すべての y' > y である 5.x.y' でも引き続き許可されます。同じマイナーライン内で新しいパッチへ更新しても、機能が失われることはありません。
マイナーラインを跨ぐ差異（たとえば 5.0.06 と 5.1.00、5.1.03 と 5.2.00、または 5.2.03 と 5.3.00 の間）は、Cubism Editor 側で基盤機能が追加・変更されたことによる実際のホスト境界であり、回帰ではありません。
ファーストパーティプラグインの互換性
以下の各行は、0.67.4 リリースコミット時点の Turboism ソースリポジトリにあるレビュー済み互換性マトリクスから生成されています。マトリクスには、開発専用の demo プラグインなど、リリースバンドルに含まれないリポジトリ内プラグインも含まれます。同梱されるプラグインについてはファーストパーティプラグインを参照してください。対応バージョンはプラグインの宣言ケイパビリティが解決されるレビュー済み Cubism Editor ビルドを示し、バージョン差分は一部のバージョンでのみ利用可能な機能を示します。
Cubism を FREE ライセンスで実行すると、保存は FREE のパラメータ数などの制限を受けます。PRO ライセンス（PRO トライアルを含む）ではこの制限はありません。Turboism プラグインのバージョン対応はライセンス階層とは無関係であり、制限はランタイムが許可する API ではなく、エディタが保存できる内容に適用されます。
| プラグイン | 対応バージョン | バージョン差分 | 実機検証 |
|---|---|---|---|
acp | 全レビュー済みバージョン（5.0.00–5.3.04） | — |
|
atlas-bitmask-nesting | 全レビュー済みバージョン（5.0.00–5.3.04） |
| — |
atlas-dalsoo-polygon | 全レビュー済みバージョン（5.0.00–5.3.04） |
|
|
atlas-folder-layout | 全レビュー済みバージョン（5.0.00–5.3.04） |
| — |
atlas-maxrects-bssf | 全レビュー済みバージョン（5.0.00–5.3.04） | — |
|
boundingbox-warp-mirror | 全レビュー済みバージョン（5.0.00–5.3.04） | — |
|
clipmask-viewer | 全レビュー済みバージョン（5.0.00–5.3.04） |
|
|
command-palette | 5.1.00–5.3.04 (それ以前の Cubism バージョンには機能自体がない) |
| — |
cubism-tab-filter | 全レビュー済みバージョン（5.0.00–5.3.04） | — | — |
demo | 全レビュー済みバージョン（5.0.00–5.3.04） | — | — |
external-psd-edit | 全レビュー済みバージョン（5.0.00–5.3.04） |
|
|
frame-animation-import | 全レビュー済みバージョン（5.0.00–5.3.04） |
| — |
history-panel | 全レビュー済みバージョン（5.0.00–5.3.04） | — | — |
mcp | 全レビュー済みバージョン（5.0.00–5.3.04） |
|
|
mesh-edit-mirror-axis-enhance | 全レビュー済みバージョン（5.0.00–5.3.04） |
| — |
model-import-3d | 全レビュー済みバージョン（5.0.00–5.3.04） | — | — |
palette-label-style | 全レビュー済みバージョン（5.0.00–5.3.04） | — | — |
parameter | 全レビュー済みバージョン（5.0.00–5.3.04） | — |
|
parameter-batch-transfer | 全レビュー済みバージョン（5.0.00–5.3.04） | — |
|
parameter-lock | 全レビュー済みバージョン（5.0.00–5.3.04） | — | — |
perf-stats | 全レビュー済みバージョン（5.0.00–5.3.04） | — |
|
physics-editor | 全レビュー済みバージョン（5.0.00–5.3.04） | — | — |
project-inspector | 全レビュー済みバージョン（5.0.00–5.3.04） | — | — |
protected-export | 5.1.00–5.3.04 (それ以前の Cubism バージョンには機能自体がない) |
|
|
psd-clip-mask-import | 全レビュー済みバージョン（5.0.00–5.3.04） | — |
|
recent-preview | 全レビュー済みバージョン（5.0.00–5.3.04） | — |
|
scene-palette-enhancer | 全レビュー済みバージョン（5.0.00–5.3.04） | — | — |
selection-brush | 全レビュー済みバージョン（5.0.00–5.3.04） |
|
|
texture-atlas-stats | 全レビュー済みバージョン（5.0.00–5.3.04） |
| — |
ui-theme | 全レビュー済みバージョン（5.0.00–5.3.04） | — |
|
warp-deformer-alt-symmetry | 全レビュー済みバージョン（5.0.00–5.3.04） | — |
|
webdav-backup | 全レビュー済みバージョン（5.0.00–5.3.04） |
|
|
実機検証列：validation/cubism-version-matrix/campaign-jobs.json のタスク×バージョン別最新 FINAL 結果を triage で分類したもの。インフラ再試行・プローブドリフト・不確定な結果は表示しません。プローブ未実施のバージョンは空欄で、静的レビューが常に基線です。
マイナーライン別のケイパビリティカバレッジ
Turboism はホスト機能を 37 個のケイパビリティグループ（合計 143 個のケイパビリティ）に分類しています。レビュー済み全 20 バージョン（5.0.00–5.3.04）のうち、143 個中 129 個のケイパビリティはすべてのバージョンで許可されています。カバレッジは 5.3.x で 100%、5.2.x で 97.9%、5.1.x で最大 95.1%、5.0.x で 90.2% です。37 グループ中 27 グループはすべてのバージョンで完全に許可されており、残りの 10 グループには Cubism Editor が該当サブシステムを導入したバージョンに応じた下限があります。したがって、バージョンが対応していても、すべての機能がすべてのバージョンで利用できるわけではありません。
| マイナーライン | レビュー済み範囲 | パッチ数 | 許可ケイパビリティ数 | ケイパビリティグループ内訳（全 37） |
|---|---|---|---|---|
5.0.x | 5.0.00–5.0.06 | 7 | 129 / 143 | 完全 27 · 部分 4 · 非対応 6 |
5.1.x | 5.1.00–5.1.03 | 4 | 135–136 / 143 | 完全 31 · 部分 4 · 非対応 2 |
5.2.x | 5.2.00–5.2.03 | 4 | 140 / 143 | 完全 35 · 部分 2 · 非対応 0 |
5.3.x | 5.3.00–5.3.04 | 5 | 143 / 143 | 完全 37 · 部分 0 · 非対応 0 |
凡例: ✓ グループ内の全ケイパビリティが許可 · ◐ 部分的に許可 · ✗ そのマイナーラインでは不許可。許可 = 静的検証レコードがそのバージョンでケイパビリティを認め、かつ縮小するセレクタコントラクト/クラスピンもそのバージョンを認める。
| ケイパビリティグループ | 5.0.x (5.0.00–5.0.06) | 5.1.x (5.1.00–5.1.03) | 5.2.x (5.2.00–5.2.03) | 5.3.x (5.3.00–5.3.04) |
|---|---|---|---|---|
| アニメーションとタイムライン | ◐ (4/6) | ◐ (4/6) | ✓ (6/6) | ✓ (6/6) |
| アートメッシュ | ✓ (7/7) | ✓ (7/7) | ✓ (7/7) | ✓ (7/7) |
| 自動揺れ読み取り | ✗ (0/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| 自動バックアップ | ✗ (0/2) | ✓ (2/2) | ✓ (2/2) | ✓ (2/2) |
| クリッピングマスク | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| Cubism Core | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| デフォーマ編集 | ✓ (5/5) | ✓ (5/5) | ✓ (5/5) | ✓ (5/5) |
| 編集レベル | ✓ (2/2) | ✓ (2/2) | ✓ (2/2) | ✓ (2/2) |
| 編集セッション | ✓ (6/6) | ✓ (6/6) | ✓ (6/6) | ✓ (6/6) |
| エディタ UI サーフェス | ◐ (9/10) | ✓ (10/10) | ✓ (10/10) | ✓ (10/10) |
| ジオメトリ読み取り | ✗ (0/1) | ✗ (0/1) | ✓ (1/1) | ✓ (1/1) |
| 編集履歴 | ✓ (3/3) | ✓ (3/3) | ✓ (3/3) | ✓ (3/3) |
| 統合ブリッジ | ✗ (0/2) | ◐ → ✓ 5.1.02+ (1–2/2) | ✓ (2/2) | ✓ (2/2) |
| メッシュツールセッション | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| メッシュツールバー贡献 | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| その他のモデルサーフェス | ◐ (22/23) | ◐ (22/23) | ◐ (22/23) | ✓ (23/23) |
| モデルインスタンス読み取り | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| モデリングカスタムツール | ✗ (0/1) | ✗ (0/1) | ✓ (1/1) | ✓ (1/1) |
| オブジェクト階層 | ✓ (4/4) | ✓ (4/4) | ✓ (4/4) | ✓ (4/4) |
| パラメータとバインド | ✓ (7/7) | ✓ (7/7) | ✓ (7/7) | ✓ (7/7) |
| パラメータキー編集 | ✓ (5/5) | ✓ (5/5) | ✓ (5/5) | ✓ (5/5) |
| パラメータ構造編集 | ✓ (9/9) | ✓ (9/9) | ✓ (9/9) | ✓ (9/9) |
| パーツとインスペクタ | ◐ (8/10) | ◐ (8/10) | ◐ (8/10) | ✓ (10/10) |
| パーツ・オブジェクト編集 | ✓ (8/8) | ✓ (8/8) | ✓ (8/8) | ✓ (8/8) |
| パフォーマンス統計 | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| 物理演算 | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| プラグイン UI サーフェス | ✓ (3/3) | ✓ (3/3) | ✓ (3/3) | ✓ (3/3) |
| プロジェクト読み取り | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| 保護付きエクスポート | ✗ (0/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| PSD raw 画像 | ✓ (3/3) | ✓ (3/3) | ✓ (3/3) | ✓ (3/3) |
| 選択編集 | ✓ (3/3) | ✓ (3/3) | ✓ (3/3) | ✓ (3/3) |
| 起動抑制 | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| テクスチャと raw 画像 | ✓ (3/3) | ✓ (3/3) | ✓ (3/3) | ✓ (3/3) |
| テクスチャアトラス | ✓ (5/5) | ✓ (5/5) | ✓ (5/5) | ✓ (5/5) |
| 元に戻す復帰 | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| ワープデフォーマミラー | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) | ✓ (1/1) |
| ワークスペース | ✓ (2/2) | ✓ (2/2) | ✓ (2/2) | ✓ (2/2) |
| ケイパビリティ ID | 対象機能 | 許可バージョン | 検証済みレコードなし |
|---|---|---|---|
cubism.autobackup.backup | 自動バックアップ作成 | 5.1.00–5.3.04 | 5.0.00–5.0.06 |
cubism.autobackup.settings | 自動バックアップ設定 | 5.1.00–5.3.04 | 5.0.00–5.0.06 |
cubism.editor-model.animation-eval | アニメーション評価パラメータベイク | 5.2.00–5.3.04 | 5.0.00–5.1.03 |
cubism.editor-model.animation-timeline.write | アニメーションタイムラインカーブ書き込み | 5.2.00–5.3.04 | 5.0.00–5.1.03 |
cubism.editor-model.auto-yure.read | 自動揺れ読み取り | 5.1.00–5.3.04 | 5.0.00–5.0.06 |
cubism.editor-model.moc-export.read | 公式 MOC 5.3 エクスポート設定 | 5.3.00–5.3.04 | 5.0.00–5.2.03 |
cubism.editor-model.part-inspector.write | パーツインスペクタ書き込み | 5.3.00–5.3.04 | 5.0.00–5.2.03 |
cubism.editor-model.part-opacity.write | パーツ不透明度書き込み | 5.3.00–5.3.04 | 5.0.00–5.2.03 |
cubism.editor-ui.top-menu | トップメニュー統合 | 5.1.00–5.3.04 | 5.0.00–5.0.06 |
cubism.geometry.read | メッシュジオメトリ読み取り | 5.2.00–5.3.04 | 5.0.00–5.1.03 |
cubism.integration.edit-api-bridge.dispatch | 編集プロトコルブリッジディスパッチ | 5.1.02–5.3.04 | 5.0.00–5.1.01 |
cubism.integration.external-app-settings.edit-toggle | 外部アプリ編集トグル | 5.1.00–5.3.04 | 5.0.00–5.0.06 |
cubism.modeling-tool.selection-brush | モデリング選択ブラシ | 5.2.00–5.3.04 | 5.0.00–5.1.03 |
cubism.protected-export.orchestration | 保護付きエクスポートオーケストレーション | 5.1.00–5.3.04 | 5.0.00–5.0.06 |
証拠に基づくバージョン境界
Turboism は、特定の Cubism Editor ビルドで機能が動作するかどうかを推測しません。実行時の許可は 3 つの層の証拠を組み合わせて判定されます。
- ハッシュ固定された静的検証レコード（
VERIFIED_STATIC） — 許可されたすべてのバージョンは、正確なLive2D_Cubism.jarおよびLive2DCubismCore.jarの成果物ダイジェストに紐付くレビュー済みバイトコードセレクタレコードを持ちます。 - セレクタコントラクトとクラスピンゲート — 特定の adapter やクラスピンテーブルが一部のバージョンにのみ配線されている場合、ランタイムコントラクトがケイパビリティを該当バージョン集合に絞り込みます。
- 確認済みホスト境界（
version-boundaries.json） — Cubism Editor のビルドに機能が存在しない場合、Turboism は Live2D Cubism の公式更新履歴とレビュー済み JAR バイトコードの両方で不在を検証したうえで確認済みホスト境界として記録します。未確認のギャップを「Editor 側に機能がない」と誤記することはありません。
5.0.00–5.3.04 における主なバージョン境界は次のとおりです。
5.0.x（5.0.00–5.0.06）には自動バックアップと保護付きエクスポートがない —CModelingDocument::getDocumentUID()（cubism.autobackup.backup、cubism.autobackup.settings、EditorAutoBackupServiceが依存するドキュメント UID 識別チェーン）はすべての5.0.xJAR に存在しません（5.0.xにはgetFileContentInstanceGuid()のみ存在）。保護付きエクスポート（cubism.protected-export.orchestrationとExportSettingsContributionService）も、ステージング出力コールバックとモーションシンク設定ソースが 5.1.00 で導入されたため5.0.xでは利用できません。トップメニューの外部アプリ統合（cubism.editor-ui.top-menu）、EditorCommandService、自動揺れ読み取り（cubism.editor-model.auto-yure.read）も 5.1.00 以降が対象です。- 編集プロトコル（
CubismFacade#edit()、cubism.integration.edit-api-bridge.dispatch）には5.1.02以降が必要 —5.0.xにはcom/live2d/cubism/doc/webSocketパッケージ自体が存在せず、5.1.00と5.1.01ではセッション検索メソッドが private であり外部アプリ認証マネージャの呼び出し形式も5.1.02+の契約と異なります。 - アニメーションタイムライン書き込みと通常ビューのモデリング選択ブラシには
5.2.00以降が必要 — タイムラインのカーブ種別書き込み（cubism.editor-model.animation-timeline.write）と評価済みパラメータベイク（cubism.editor-model.animation-eval）は 5.2.00 で導入されたトラック・カーブ API に依存します。通常ビューのモデリング選択ブラシ（cubism.modeling-tool.selection-brush、ModelingBrush、ModelingToolRegistry）も 5.2.00 で導入されたモデリングツールのビューコンテキストリスナー API を必要とします（5.3.00 でブラシの拡張/収縮および円/四角/線ブラシ形状が追加）。Core のデフォーマ/グルージオメトリ読み取り（cubism.geometry.read）、ポリゴン対応テクスチャアトラス配置（TextureAtlasPolygonLayoutService）、ネイティブ PSD 原画像のエクスポート/置き換え（ModelTextures#exportRawImagePsd()、replaceRawImagePsd()）も 5.2.00 以降が必要です。 - パーツ不透明度/インスペクタ書き込み、アルファ合成、公式 MOC 5.3 エクスポートには
5.3.00以降が必要 — パーツフォームの不透明度アクセサ（cubism.editor-model.part-opacity.write）、拡張パーツインスペクタのマスク/ブレンドモード書き込み（cubism.editor-model.part-inspector.write）、AlphaComposition、およびcubism.editor-model.moc-export.readは 5.3.00–5.3.04 でのみ利用できます。
実行時のケイパビリティ照会
プラグインは Cubism Editor のバージョン文字列で直接分岐せず、ケイパビリティの利用可否を照会してください。
CubismFacadeの各アクセサはisAvailable()を持つセンチネルを返し、現在のホストがそのケイパビリティを許可しているかを報告します。EditorCommand#supports(String)とsupportedVersions()は、コマンドごとの対応バージョン集合を実行時に公開します。@CubismEditor注釈付きの SDK サーフェスは、ホストが許可しない場合にCubismEditorApiUnavailableExceptionで fail closed します。
Turboism がバージョン固有のホストアクセスをどのように分離しているかについては、SDK API ガイドおよびマッピング層を参照してください。