ティラノスクリプトから kaedevn へ — 移行ガイド

ティラノスクリプト（TyranoScript）で制作してきた方が、Kaede Script（KS） をすぐ書けるようになるためのガイドです。まず「タグの対応表」を載せ、その下に書き方の違いと機能の差をまとめています。対応表だけ見れば、ほとんどのシーンは移植できます。

kaedevn のスクリプトはティラノ / KAG 系の書き味を受け継いでいます。@コマンド でシーンを宣言的に描写する感覚はそのままに、1 本の原作から Web でも Nintendo Switch でも出力できるのが大きな違いです。

---

1. まず押さえる 4 つの違い

ティラノと書き方が変わる点はこの 4 つだけです。ここを押さえれば対応表がそのまま読めます。

; ── kaedevn（KS）の基本形 ──
@bg classroom fade=1000
@ch 赤音 smile C
#赤音
おはよう！今日もいい天気だね。@l

choice {
    "一緒に帰る"   { @jump go_home }
    "図書館で勉強" { @jump library }
}

• 行末の @l（クリック待ち）・@p（改ページ）・@r（改行）だけはテキストに埋め込めます。ティラノの [l] [p] [r] と同じ役割です。
• コメントは ; または //。
• ラベルは *ラベル名（ティラノと同一）。

---

2. タグ対応表（ティラノの分類順）

◎ = ネイティブで対応（より強力）／ ○ = 対応 ／ △ = 別の経路で対応 ／ ✕ = 現状なし

テキスト・メッセージ操作

キャラクター（立ち絵）

背景・画像・レイヤー

トランジション（画面切替）

音楽・効果音・ボイス・動画

演出効果

分岐・ラベル・ジャンプ

選択肢・ボタン・リンク

変数・スクリプト

システム

kaedevn 独自（ティラノに無いもの）

ノベルに加えて、同じ記法で RPG／ソーシャルゲーム量産まで射程に入ります（RPG レイヤーは開発中・順次公開）。

---

3. 移行で「楽になる」ところ・「気をつける」ところ

楽になる（ティラノでプラグインが要った演出が標準装備）

• カメラ（パン・ズーム・揺れ）が @camera 一発。
• パーティクル / エフェクトが @particle @effect（JSON宣言型）で標準。
• 高品質フィルターが @filter / @filter_mix で専用シェーダ。CSS フィルターより表現が広い。
• Live2D がネイティブ、さらに VRM（3D キャラ） まで同じ書き味で扱える。
• 表情・口パク・モーションが 2D / Live2D / VRM 横断で同じコマンド（@ch_expr 等）。

気をつける（ティラノにあって現状 KS に無いもの）

[iscript] のような生 JS を持たないのは制約ではなく設計です。KS を一度プラットフォーム非依存の命令列（Op[]）にコンパイルすることで、同じシナリオが Web でも Nintendo Switch でも動くようにしています。複雑なロジックは型チェック付きの KSC に書けば、生 JS なしで同じことができます。

---

4. 仕組みの違い（読みたい人向け）

ティラノはスクリプトを 1 行ずつ解釈して実行するインタプリタ方式です。kaedevn の KS は、スクリプト全体を先に命令列（Op[]）へコンパイルしてから実行します。

.ks → Tokenizer → Parser → Transformer → Op[]（プラットフォーム非依存）→ 実行

この Op[] が「1 本の原作から複数媒体へ出力する」基盤になっています。ライト層はタグ記法（KS）、ロジック重めは型付きのコード記法（KSC）と、用途で書き分けられます。

---

5. はじめの一歩

1. ティラノの 1 シーンを、上の対応表でそのまま置き換えてみる
2. [bg]→@bg / [chara_show]→@ch / [glink]→choice{} の 3 つだけで、ほとんどの会話シーンが動く
3. 揺れ・カメラ・エフェクトは KS のネイティブコマンドで足していく

詳しい全コマンドは KS 仕様書、ロジックを書きたくなったら KSC 仕様書 へ。

関連ドキュメント

• Kaede Script 概要
• KS（タグ記法）仕様書
• KSC（コード記法）仕様書
• エンジンの仕組み