エディタ完全ガイド

kaedevn エディタは、ノベル作品のシナリオをブロック単位で視覚的に組み立てる Web ベースの制作ツールです。テキスト・選択肢・条件分岐などの基本ブロックに加えて、画面フィルター・パーティクル・カメラ演出といった拡張ブロックにも対応しています。編集内容はその場で画面に反映されるので、結果を見ながら作品を組み立てられます。プログラミング知識は一切不要です。

エディタ画面の構成

エディタはレスポンシブ対応で、デバイスに応じてレイアウトが変化します。

• デスクトップ — 3カラム（ページ一覧 / ブロックリスト / インスペクター）
• タブレット — 2カラム（ブロックリスト / インスペクター）
• スマートフォン — 1カラム + ハンバーガーメニュー（縦持ちの幅で自動切り替え）

タッチターゲットは最小 44px を確保しており、スマートフォンでも快適に操作できます。

ヘッダー

• 保存ボタン: 現在の編集内容をサーバーに保存します（自動保存は60秒ごと）
• 再生ボタン: プレビューウィンドウが開き、作品をその場で確認できます
• アンドゥ / リドゥ: 最大50回分の操作履歴を辿れます
• 戻るボタン: マイページに戻ります（未保存の変更がある場合は警告表示）

タブナビゲーション

• ブロック — ブロックの追加・編集・並べ替え
• キャラクター — キャラクタークラスと表情差分の管理
• アセット — 背景・キャラクター立ち絵・音声などの素材管理
• フロー — シーン間の遷移を俯瞰
• レイアウト — 画面解像度プリセット（スマホ縦画面など）と UI 配置の調整
• 設定 — プロジェクト名などの基本設定

ブロックリスト

シナリオの構成要素がカード形式で縦に並びます。カードをタップすると右側にインスペクターが開き、詳細を編集できます。コンテキストメニュー（右クリック / 長押し）で複製・削除などの操作も可能です。

ブロック一覧

kaedevn エディタは多彩なブロックを提供します。基本的なテキスト表示から、条件分岐、画面フィルター、パーティクル、カメラ演出まで、すべてブロック操作で実現できます。

基本ブロック

• start ページの開始点（各ページに1つ、削除不可） — なし
• text セリフ・ナレーション — キャラクター名、テキスト、変数展開
• bg 背景画像の表示・切替 — アセット選択、フェード時間、トランスフォーム
• ch キャラクターの表示 — キャラクター、表情、位置（L/C/R）、フェード
• overlay 背景とキャラの間にオーバーレイ画像を重ねる — アセット選択、フェード時間

制御ブロック

• choice プレイヤーへの選択肢提示 — 選択肢テキスト、ジャンプ先、表示条件
• if 条件分岐（then / else ブロック） — 条件式、真偽それぞれのブロック群
• jump 別ページへの移動 — ジャンプ先ページ
• set_var 変数の代入・演算 — 変数名、演算子（=, +=, -=）、値

演出ブロック

• effect 視覚エフェクト — エフェクト型、強度、持続時間
• screen_filter 画面フィルター（46 種・8 カテゴリ） — フィルター名、強度
• filter_mix フィルター重ね掛け（2 スロット固定） — ベース層 + 動き層
• color_adjust 色調補正 — 明るさ・コントラスト・彩度・色温度
• particle パーティクルエフェクト — プリセット、強度、範囲、持続時間
• slash 斬撃の軌跡 — 三日月スプライト + 残像で振り抜きを表現
• camera カメラ演出 — ズーム・パン・回転

基本操作

ブロックの追加

ブロックリストの下部にある「+」ボタン（FAB）から追加したいブロック型を選びます。追加されたブロックはリストの末尾に配置されます。

ブロックの並べ替え

ブロックカードをドラッグ&ドロップで自由に順序を入れ替えられます。Start ブロックは常に先頭に固定されます。

ブロックの複製・削除

コンテキストメニューまたはカード右上のアイコンから操作できます。Start ブロックは削除できません。

元に戻す / やり直し

ヘッダーのアンドゥ・リドゥボタン、またはキーボードショートカットで操作できます。最大50回分の操作履歴を保持します。

自動保存

60秒ごとに自動保存が実行されます。ブラウザを閉じようとしたとき、未保存の変更がある場合は確認ダイアログが表示されます。

ページ管理

1つのプロジェクトには複数のページを作成できます。ページはシーンやチャプターに相当します。

• ページの追加: サイドバー上部の「+」ボタン
• ページの切り替え: サイドバーのページ一覧からクリック
• ページ間の移動: Jump ブロックまたは Choice ブロックでジャンプ先ページを指定

プレビュー

ヘッダーの再生ボタンを押すと、現在のプロジェクトがそのままプレイ可能な形に変換され、新しいタブでプレビューエンジンが起動します。

プレビューで確認できること:

• テキストの1文字ずつ表示（タイプライター効果）
• 背景・キャラクター・オーバーレイの切替とフェード
• BGM / SE / ボイスの再生
• 選択肢の分岐
• 46 種の画面フィルター（時間帯・天候・パーティクル・季節感・雰囲気・色調・特殊効果・レトロ）
• フィルター重ね掛け（ベース層 + 動き層の 2 スロット）
• 色調補正（明るさ/コントラスト/彩度/色温度）
• 戦闘・演出系パーティクル + 斬撃の軌跡
• カメラ演出（ズーム・パン・回転）

修正後に再度再生ボタンを押せば、最新の状態が反映されます。

KSC エディタ（上級者向け）

より本格的なスクリプト開発には、専用の KSC エディタが用意されています。VS Code と同じ Monaco Editor を搭載し、以下の機能を提供します。

• 構文ハイライト: KSC キーワード、コマンド、文字列、コメントを色分け
• リアルタイム診断: 入力中にエラーや警告をインラインで表示
• 自動補完: コマンド名、パラメータ、変数名の候補を提示
• ファイルブラウザ: .ksc ファイルの作成・リネーム・削除
• ライブプレビュー: 編集中のスクリプトをそのままプレビュー実行

画面フィルター（46 種・8 カテゴリ）

エディタからブロック操作で適用できるスクリーンフィルターの一覧です。

1枚の背景画像から、フィルターだけで多彩なシーンを演出できます。

時間帯（5種）

• Morning — 朝の柔らかい光
• Sunset — 夕焼けのオレンジ
• Twilight — 黄昏の青紫
• Night — 夜の暗さと青み
• Moonlight — 月明かりの銀色

天候（2種）

• Rain — 雨の効果
• Overcast — 曇り空の重さ

パーティクル（5種）

• Snow — 降り積もる雪（大きさスライダー対応）
• Sakura — 舞い散る花びら（大きさスライダー対応）
• Firefly — 光の粒（蛍）— 色ピッカー・色のばらつき・補色アクセント対応
• Sparkle — キラキラ — 色ピッカー・色のばらつき・補色アクセント対応
• Dust — 漂う塵（大きさ・風スライダー対応）

季節感（2種）

• Autumn — 紅葉（葉が舞う秋）
• Winter — 冬（青みと積雪感）

雰囲気（8種）

• Dreamy — ほんわか / 夢の中
• Tense — 緊張感
• Melancholy — 哀愁
• Nostalgia — 懐かしさ
• Romantic — ロマンチック
• Horror — ホラー
• Mysterious — ミステリアス
• Peaceful — 穏やか

色調（9種）

• Sepia — セピア
• Grayscale — モノクロ
• Desaturate — 色褪せ
• Warm — 暖色
• Cool — 寒色
• Vivid — 鮮やか
• Muted — くすみ
• Bright — 明るく
• Dark — 暗く

特殊効果（10種）

• Blur — ぼかし
• Vignette — 周辺減光
• FocusBlur — 焦点ぼかし
• Noise — ノイズ
• Glitch — グリッチ
• Chromatic Aberration — 色収差
• OldFilm — 古いフィルム風
• Bloom — 光のにじみ
• ColorTint — 色調変更
• Underwater — 水中効果

レトロ（5種）

• PC-98 — レトロPC風
• GameBoy — ゲームボーイ風4色
• Famicom — ファミコン風（限定パレット）
• CRT — ブラウン管風
• Pixelate — ドット絵風

フィルター重ね掛け（Filter Mix）

ベース層 + 動き層の 2 スロット固定 で重ね掛けします。

• スロット 1（ベース層） — 色調・雰囲気・季節感・レトロなど画面全体のトーンを決めるフィルター
• スロット 2（動き層） — 雨・雪・桜・蛍などの天候・パーティクル系（粒の動きが入るフィルター）

同種の重複（例: 夜 + 朝）を防ぐため、スロット 2 に置けるのは動き系のみ。組み合わせは UI 側で許容セットを誘導します。

色調補正

フィルタープリセットとは別に、明るさ・コントラスト・彩度・色温度をスライダーで自由に微調整できます。

Live2D キャラクター

Live2D モデルを使って、まばたき・呼吸・リップシンクなど自然な動きのあるキャラクターを表示できます。

• モデル選択 — プロジェクトに追加した Live2D モデルから選択
• モーション — Idle / TapBody などのモーショングループとインデックスを指定
• 位置・サイズ — X / Y 座標とスケールをスライダーで調整
• 表示 / 非表示 — シーンに応じてキャラクターの出し入れ

関連ドキュメント

• KS スクリプト仕様書 — タグベーススクリプトの文法と全コマンド
• KSC スクリプト仕様書 — 高機能スクリプトの文法と型システム
• ブロック型リファレンス — 各ブロックのプロパティ一覧
• アセット管理ガイド — 素材のアップロードと管理方法
• キャラクター設定ガイド — キャラクターと表情差分の設定方法