TurboWarp TM Extension ID 移行ガイド
Copyright © 2026 Hiroya Kubo. この文書はCC BY-SA 4.0で提供します。
対象: TurboWarp-Kamishibai 4.0 系列と、TurboWarp TM を使う SB3 / DSL 4.0 配布物
関連Issue: TurboWarp TM #79、TurboWarp-Kamishibai #661、sb3-toolchain #50
日本語
TurboWarp TM の現行 Extension ID は kubohiroyatm です。TurboWarp-Kamishibai と TurboWarp紙芝居文書では、製品名を
TurboWarp-Kamishibai / TurboWarp紙芝居、認識拡張名を TurboWarp TM、repository slug を turbowarp-kamishibai-app として扱います。
DSL 4.0の固定公開基準は v4.0.0-rc.8 で、current migrationはこの固定snapshotへ注記を重ねる形で扱います。
| 区分 | 現行表記 | 用途 |
|---|---|---|
| Product name | TurboWarp-Kamishibai | 英語本文、公開サイト、repository説明 |
| 日本語一般名称 | TurboWarp紙芝居 | 日本語本文、ワークショップ以外の通常文書 |
| Recognition | TurboWarp TM | ポーズ認識拡張の人間向け名称 |
| Extension ID | kubohiroyatm |
SB3内のextension identifier |
| Opcode prefix | kubohiroyatm_... |
SB3内のblock opcode |
| Current repository | turbowarp-kamishibai-app |
GitHub repository、Pages、文書内リンク |
| Docs repository | turbowarp-kamishibai-docs |
この文書repository |
| Samples repository | turbowarp-kamishibai-samples |
サンプル台本と実行可能作品 |
変更対象
移行対象は SB3 内の extension identifier と opcode prefix です。JavaScript artifactを差し替えるだけでは、
既存SB3のblock opcode、extension entry、monitor、変数参照が古い識別子を参照したまま残るため不十分です。
sb3-toolchain の移行planで SB3を解析し、変換対象を一覧化してから更新します。
version boundary
kubohiroyatm は TurboWarp TM #79 で確定した現行IDです。TurboWarp-Kamishibai #661 はこのIDへ追随するruntime /
artifact migrationを扱います。固定済みの3.2 / 4.0 prerelease snapshotやrelease historyは履歴として維持し、
current guideでは新しいIDだけを案内します。
手順
- 対象SB3と対応するTurboWarp-Kamishibai versionを固定する
sb3-toolchainのmigration planで extension entry、opcode、monitor、変数参照を列挙する- 変換結果で Extension ID が
kubohiroyatm、opcode prefix がkubohiroyatm_へ揃ったことを確認する - 変換後SB3を TurboWarp Editor と Web Preview の両方で開く
- カメラ許可、モデル読み込み、認識結果、scene transition、rollback用の旧release再生を確認する
確認方法
- SB3内の extension list に
kubohiroyatmが一度だけ現れる - TurboWarp Editor の拡張パレットに TurboWarp TM のblockが表示される
- 認識結果が Async Input と runtime transitionへ届く
turbowarp-kamishibai-appPages、turbowarp-kamishibai-docsPages、turbowarp-kamishibai-samplesPagesのリンクが現在URLを指す
rollback
問題があれば、移行前SB3と対応するTurboWarp-Kamishibai releaseへ戻します。文書側はこのguideとcurrent annotationを revertすればよく、固定済みのsource snapshot、release history、workshop配布物は変更しません。
English
The current Extension ID for TurboWarp TM is kubohiroyatm. TurboWarp-Kamishibai documentation uses TurboWarp-Kamishibai as the
English product name, TurboWarp紙芝居 as the Japanese product name, TurboWarp TM as the recognition extension name, and
turbowarp-kamishibai-app as the current repository slug.
The migration target is the SB3 extension identifier and opcode prefix. Replacing the JavaScript artifact alone is not
enough because existing SB3 files still contain extension entries, block opcodes, monitors, and variable references.
Use the sb3-toolchain migration plan to inspect each SB3 first, then rewrite the identifiers.
The new boundary is defined by TurboWarp TM #79 and followed by the TurboWarp-Kamishibai runtime / artifact migration in
TurboWarp-Kamishibai #661. Versioned 3.2 and 4.0 prerelease snapshots remain historical records; current guides should point
to kubohiroyatm only.
Verification requires the converted SB3 to contain one kubohiroyatm extension entry, use the kubohiroyatm_ opcode
prefix, show TurboWarp TM blocks in the TurboWarp Editor, pass camera/model recognition, and deliver recognition events
to Async Input and scene transitions.
Rollback uses the pre-migration SB3 and its matching TurboWarp-Kamishibai release. Documentation rollback should revert this current guide and annotations only; historical source snapshots, release history, and workshop distributions remain unchanged.