🍁 kaedevn
/← トップ
← ドキュメント一覧

ブロック型リファレンス

kaedevn エディタでシナリオを構成するブロック型のプロパティ一覧です。基本ブロックに加え、パーティクル・フィルター重ね掛け・カメラ演出などの拡張ブロックがあります。各ブロックは作品データの一部として保存され、編集と画面表示はその場で連動します。

基本ブロック

Start ブロック

ページの開始地点を示すブロックです。各ページに1つだけ存在し、削除や移動はできません。

  • id string — ブロックID（自動生成）
  • type "start" — 固定値

Text ブロック

セリフやナレーションを表示します。テキストは1文字ずつタイプライター表示されます。

  • id string — ブロックID
  • type "text" — 固定値
  • text string — 表示するテキスト
  • characterId string? — 発言キャラクターのID（省略時はナレーション）
  • characterName string? — 表示名（characterIdから自動解決）

テキスト内では {変数名} の記法で変数を展開できます。

BG ブロック

背景画像を切り替えます。

  • id string — ブロックID
  • type "bg" — 固定値
  • assetId string — 背景画像のアセットID
  • effect string? — 切替エフェクト（"fade" など）
  • fadeMs number? — フェード時間（ミリ秒）
  • transform object? — 位置・スケール・回転の変換

CH ブロック

キャラクターの立ち絵を表示・変更します。

  • id string — ブロックID
  • type "ch" — 固定値
  • characterId string — キャラクターのslug
  • expressionId string — 表情のslug
  • pos "L" / "C" / "R" — 画面上の位置（左・中央・右）
  • fadeMs number? — フェードイン時間（ミリ秒）

CH Hide ブロック

画面上のキャラクターを非表示にします。

  • id string — ブロックID
  • type "ch_hide" — 固定値
  • characterId string — 非表示にするキャラクターのslug
  • fadeMs number? — フェードアウト時間（ミリ秒）

Overlay ブロック

キャラクターレイヤーの上にオーバーレイ画像を重ねます（Layer 2）。

  • id string — ブロックID
  • type "overlay" — 固定値
  • assetId string — オーバーレイ画像のアセットID
  • fadeMs number? — フェード時間

制御ブロック

Jump ブロック

別のページへシナリオの進行を移動します。

  • id string — ブロックID
  • type "jump" — 固定値
  • toPageId string — ジャンプ先のページID

Choice ブロック

プレイヤーに選択肢を提示します。各選択肢に条件を設定でき、条件を満たさない選択肢は非表示になります。

  • id string — ブロックID
  • type "choice" — 固定値
  • choices ChoiceItem[] — 選択肢の配列

ChoiceItem

  • text string — 選択肢のラベル
  • toPageId string — 選択時のジャンプ先ページID
  • condition string? — 表示条件（変数式、例: affection >= 10）

If ブロック

条件式に基づいてシナリオを分岐します。then / else それぞれにブロック群をネストできます。

  • id string — ブロックID
  • type "if" — 固定値
  • condition string — 条件式（例: affection >= 10）
  • thenBlocks Block[] — 条件が真のとき実行されるブロック群
  • elseBlocks Block[]? — 条件が偽のとき実行されるブロック群

Set Var ブロック

変数の値を設定・変更します。

  • id string — ブロックID
  • type "set_var" — 固定値
  • varName string — 変数名
  • operator "=" / "+=" / "-=" — 演算子
  • value string / number — 設定する値

演出ブロック

Effect ブロック

画面に視覚エフェクト（FX）を適用します。

  • id string — ブロックID
  • type "effect" — 固定値
  • effect string — エフェクト種別（shake / flash / fade_black / black_in / fade_white / white_in / vignette / blur）
  • intensity number? — 強度（1〜5、整数、デフォルト 3）。フェード系（fade_black / fade_white / black_in / white_in）と flash は強度を持たず非表示
  • duration number? — 持続時間（ms、100〜5000、デフォルト 500）。vignette / blur は duration の経過で自動解除される

Screen Filter ブロック

画面全体にシェーダーフィルターを適用します。46 種・8 カテゴリのプリセット（時間帯・天候・パーティクル・季節感・雰囲気・色調・特殊効果・レトロ）が用意されています。

  • id string — ブロックID
  • type "screen_filter" — 固定値
  • filterName string — フィルター名（Bloom, CRT, Glitch, GameBoy, Famicom, Night, Rain, Autumn, Winter 等）
  • params object? — フィルター固有のパラメータ（大きさ・色ピッカー・色ばらつき・風 など）
  • durationMs number? — 適用にかかる時間

Camera ブロック

背景・キャラレイヤーに対してカメラのパン・ズームを適用します。

  • id string — ブロックID
  • type "camera" — 固定値
  • x number? — 画面中心の X オフセット
  • y number? — 画面中心の Y オフセット
  • scale number? — ズーム倍率（1.0 で等倍）
  • durationMs number? — 遷移時間

Filter Mix ブロック

スクリーンフィルターを 2 スロット固定（ベース層 + 動き層）で重ね掛けします。同種フィルターの衝突を防ぐため、各スロットに置けるフィルター種別は UI 側で誘導されます。

  • id string — ブロックID
  • type "filter_mix" — 固定値
  • layers FilterLayer[] — フィルターレイヤー配列（常に長さ 2。空スロットは filterType: ''）
    • layers[0]（ベース層） — 色調・雰囲気・季節感・レトロなど画面全体のトーン
    • layers[1]（動き層） — 雨・雪・桜・蛍など粒の動きが入るフィルター

FilterLayer

  • filterType string — フィルター名（空文字でスロット無効）
  • intensity number? — 強度（0.0〜1.0）
  • params object? — フィルター固有パラメータ

Color Adjust ブロック

画面全体の色味をスライダーで微調整します。フィルタープリセットでは表現できない細かい調整用。

  • id string — ブロックID
  • type "color_adjust" — 固定値
  • brightness number — 明るさ（-100 〜 +100、デフォルト 0）
  • contrast number — コントラスト（-100 〜 +100）
  • saturation number — 彩度（-100 〜 +100、0 でモノクロ）
  • temperature number — 色温度（-100 寒色 〜 +100 暖色）
  • target "scene" / "bg" / "ch" — 適用対象（省略時 "scene" = 両方）

Particle ブロック

戦闘・演出系のパーティクルを発生させます。雪・桜・蛍などの環境系は Screen Filter 側（パーティクル カテゴリ）にあり、こちらの Particle ブロックは戦闘・ガチャ向けの粒子演出を扱います。プリセットを重ねる場合は emitters に追加します。

  • id string — ブロックID
  • type "particle" — 固定値
  • preset string — プリセット名（バトル系: fire_sparks / ice_crystal / explosion / heal、ガチャ系: gacha_burst / gacha_rainbow / gacha_stars の 7 種）
  • x number? — 発生位置 X
  • y number? — 発生位置 Y
  • s number? — 粒子サイズ倍率（0.1〜5.0、デフォルト 1.0）
  • range number? — 発生範囲倍率（shape の radius / width / height にかかる、0.1〜5.0、デフォルト 1.0）
  • intensity number? — 強度（発生量、1〜3）
  • blendMode "normal" / "add" — 合成モード
  • duration number? — 持続時間（ms、省略で無限）
  • emitters ParticleEmitter[]? — 追加エミッター（2 つ目以降）

Slash ブロック

斬撃の軌跡（三日月スプライト + 残像）を 1 振り再生します。Particle とは別ライフサイクルで、剣戟・斬撃エフェクト専用です。

  • id string — ブロックID
  • type "slash" — 固定値
  • x number — 弧の中心 X（px）
  • y number — 弧の中心 Y（px）
  • angle number — 振りの中心角（度）。0 = 右水平、-30 = 斜め下右、90 = 下
  • length number — 振り幅（px）
  • duration number — 振り抜き時間（ms）
  • width number — 三日月スプライトの scale 倍率
  • color string — "#RRGGBB" 形式（runtime で 0xRRGGBB に変換）
  • blendMode "normal" / "add" — 合成モード

キャラクターブロック（拡張）

VRM 3D キャラブロック

VRM 3D モデルを立ち絵として表示します。14 種の表情、髪・スカートの自然な揺れ、アニメ調のトゥーン表現に対応します。

  • id string — ブロックID
  • type "vrm" — 固定値
  • modelId string — VRM モデル識別子（例: "hero"）
  • pos "L" / "C" / "R" — 表示位置（左・中央・右）
  • fadeMs number — フェード時間（ms）
  • expression string — 表情名（neutral / happy / angry / sad / relaxed / surprised ほか計 14 種）
  • pose "aPose" / "idle" — ポーズプリセット
  • rotY number — Y 軸回転（度）
  • visible boolean — 表示/非表示
  • x / y / scale number? — X/Y オフセット・スケール（ImageTransform）

VRM 0.x / 1.0 の両方に対応。プロパティパネルでスライダーを動かすとエディタ上にライブプレビューが表示されます。

Live2D Character ブロック

Live2D モデルを表示します。静止画では表現できないまばたき・呼吸・リップシンクなどの自然な動きを演出できます。

  • id string — ブロックID
  • type "live2d_ch" — 固定値
  • modelId string — モデル識別名（hiyori / mao / haru / mark / natori / rice / wanko）
  • modelPath string — model3.json のパス
  • motionGroup string — モーショングループ名（Idle / TapBody など）
  • motionIndex number — グループ内のモーションインデックス
  • x number — X 位置（0〜1280）
  • y number — Y 位置（0〜720）
  • scale number — スケール（0.05〜0.5）
  • visible boolean — 表示/非表示

音声ブロック

BGM ブロック

BGM の再生を制御します。

  • id string — ブロックID
  • type "bgm" — 固定値
  • assetId string — BGM アセットID
  • volume number? — 音量（0-100）
  • fadeMs number? — フェードイン時間

SE ブロック

効果音を1回再生します。

  • id string — ブロックID
  • type "se" — 固定値
  • assetId string — SE アセットID
  • volume number? — 音量（0-100）

Wait ブロック

指定時間またはクリックまで進行を一時停止します。

  • id string — ブロックID
  • type "wait" — 固定値
  • mode "click" / "timeout" / "voiceend" — 待機条件
  • timeMs number? — タイムアウト時間（mode が timeout のとき）

レイヤー描画順序

ブロックが生成する視覚要素は、以下の順序でレンダリングされます。

Layer 3 (最前面): UI ── テキストウィンドウ、選択肢、メニュー
Layer 2:          Overlay ── overlay ブロック
Layer 1:          Character ── ch ブロック（L/C/R）
Layer 0 (最背面): Background ── bg ブロック

ブロック ID の命名規則

ブロック ID は {type}-{Date.now()} の形式で自動生成されます（例: text-1709712345678）。手動で変更する必要はありません。

関連ドキュメント

Ad: inContent (336x280)
Ad: stickyBottom (728x90)
kaedevn - ノベルゲームを作れるプラットフォーム