kaedevn - ノベルゲームを作れるプラットフォーム

kaedevn で作った作品は、Web ブラウザだけでなく、Android、PC、そして将来的には Nintendo Switch でもプレイできるようになります。これを支えるのが、プラットフォームごとに差し替え可能な「抽象レイヤー」の設計と、C++ で書かれたネイティブエンジンです。

1つの作品が、どこでも動く理由

kaedevn のエンジンは4つの抽象インターフェースを定義しています。

IInput — すべての入力を統一的に受け取る。Web: PixiJS ポインタ / キーボード / ネイティブ: SDL_Event（Joy-Con / タッチ / キーボード）
IAudio — BGM / SE / VOICE の再生制御。Web: Web Audio API / ネイティブ: SDL_mixer
IStorage — セーブ / ロードの抽象化。Web: IndexedDB / ネイティブ: ファイルシステム（JSON）
IOpHandler — Op 命令の実行（210行のインターフェース定義）。Web: WebOpHandler (PixiJS) / ネイティブ: SDL2Engine (OpenGL)

スクリプトエンジン（VM）はこれらのインターフェースだけを使って動作します。「画面にキャラクターを表示する」「BGM を再生する」といった処理は、プラットフォームごとの実装に委譲されます。

Web: PixiJS エンジン（完全対応）

現在のメイン環境です。PixiJS（WebGL）による高速な 2D 描画で、4層のレイヤー構造を持ちます。

Layer 3: UI（テキストウィンドウ、選択肢、メニュー）
Layer 2: Overlay（エフェクト画像）
Layer 1: Character（立ち絵 L/C/R）
Layer 0: Background（背景画像）

搭載機能:

GPU アクセラレーション（WebGL）による滑らかな描画
テキストの1文字ずつ表示（タイプライター効果）
フェード、画面揺れ、ズーム、パンなどのカメラ制御
46 種の画面フィルター（時間帯・天候・パーティクル・季節感・雰囲気・色調・特殊効果・レトロ）
レスポンシブ対応（PC / スマートフォン両対応）

ゲームシステム:

セーブ / ロード（IndexedDB、複数スロット）
バックログ（テキスト履歴の閲覧）
設定画面（テキスト速度、音量、フルスクリーン）
ギャラリー（CG / シーン回想）
インベントリ（アイテム管理）
デバッグ画面（変数ウォッチ、ブレークポイント）

ネイティブエンジン: SDL2 + C++（実機動作確認済み）

SDL2（Simple DirectMedia Layer）を使った C++ ネイティブエンジンが実装されています。約 1,100 行のインタプリタコードと約 800 行のエンジンモジュールで構成されます。

エンジンの構成

Event Loop → SDL2Engine (157行)
    ├── TextureManager (55行) ── 画像ロード + LRU キャッシュ
    ├── FontManager (52行) ──── SDL_ttf テキストレンダリング
    ├── AudioManager (61行) ─── SDL_mixer BGM/SE/Voice
    ├── Shader (55行) ────── GLSL フィルター
    ├── FileStorage (40行) ──── JSON セーブ/ロード
    ├── HistoryManager (60行) ─ 選択履歴
    ├── AssetProvider (41行) ── アセットID→ファイルパス変換
    └── Interpreter ──────── KS スクリプト VM
        ├── Tokenizer (91行) ── 字句解析
        ├── Parser (136行) ──── AST 生成
        ├── Evaluator (85行) ── 式評価
        └── GameState (73行) ── 変数・フラグ管理

Web ↔ ネイティブの機能対応表

描画 — Web: PixiJS (WebGL) / ネイティブ: SDL2 + OpenGL
テクスチャ — Web: PIXI.Texture / ネイティブ: SDL_Texture + LRU キャッシュ
音声 — Web: Web Audio API / ネイティブ: SDL_mixer
フォント — Web: PIXI.Text / ネイティブ: SDL_ttf
ストレージ — Web: IndexedDB / ネイティブ: ファイルシステム (JSON)
入力 — Web: Pointer / Keyboard events / ネイティブ: SDL_Event
スクリプト — Web: KscRunner + VM (TypeScript) / ネイティブ: C++ Interpreter
シェーダー — Web: PixiJS Filter / ネイティブ: GLSL 直接コンパイル

対応プラットフォーム

Web（ブラウザ） — 完全対応。技術: PixiJS / WebGL
Android — ビルド成功・実機動作確認済み。技術: SDL2 + NDK + JNI
PC（Mac / Linux） — ビルド成功・動作確認済み。技術: SDL2 + CMake
iOS — 検証中。技術: SDL2
Windows — 検証中。技術: SDL2
Nintendo Switch — 2026年下半期予定。技術: SDL2 + DevkitPro

Android 版は JNI ブリッジ（Java ↔ C++）を介して SDL2 エンジンを呼び出します。Gradle ビルド設定済みです。

入力の統一: Action マップ

すべてのプラットフォームで、入力は「Action」という共通の単位に変換されます。Web では優先度ベースの入力システム（GAME / UI / MODAL の3レベル）で、モーダルが開いているときにゲーム入力が誤発火しない設計です。

OK — テキスト送り、決定。Web: クリック / Enter / Switch: A ボタン
Back — キャンセル、戻る。Web: Escape / Switch: B ボタン
Menu — メニュー表示。Web: M キー / Switch: + ボタン
SkipToggle — スキップ切替。Web: S キー / Switch: ZR
AutoToggle — オート切替。Web: A キー / Switch: ZL
Log — バックログ。Web: L キー / Switch: - ボタン
QuickSave — クイックセーブ。Web: F5 / Switch: L
QuickLoad — クイックロード。Web: F9 / Switch: R
Screenshot — スクリーンショット。Web: P キー / Switch: 撮影ボタン
HideWindow — UI非表示。Web: H キー / Switch: X ボタン

作者はプラットフォームごとのボタン配置を意識する必要はありません。「OK が押されたらテキストを進める」というロジックだけを書けば、Web でも Switch でも正しく動作します。

解像度とセーフエリア

kaedevn は論理解像度 1280x720 を基準に設計されています。

TV出力（Switch）: セーフエリア5%（64px 水平 / 36px 垂直）を確保し、画面端が切れても重要な UI が隠れない
スマートフォン: アスペクト比を維持しつつスケーリング
PC ブラウザ: ウィンドウサイズに追従

UI の配置はアンカーベースの相対座標で定義されるため、ハードコードされたピクセル値に依存しません。

作者にとってのメリット

一度作れば全プラットフォーム: スクリプトもアセットも共通
移植作業は不要: エンジン側が各プラットフォームに対応
品質が保証される: 281 行の C++ ユニットテスト + 107 の TypeScript テストで動作を検証
将来性: 新しいプラットフォームが追加されても、作品はそのまま動く

マルチプラットフォーム — SDL2 で広がる世界