🚀 クイックスタート

NovelCraftを使って最初のノベルゲームを作るまでの流れを説明します。5分もかかりません。

💡

プログラミング知識は不要です。すべての操作はGUIで行えます。

インストール

  1. ダウンロードページから使用OSのファイルをダウンロード
  2. Windows: NovelCraft-Setup-0.9.2.exe を実行してインストーラーの指示に従う
  3. macOS: NovelCraft-0.9.2.dmg を開き、アプリケーションフォルダにドラッグ
  4. NovelCraftを起動するとホーム画面が表示されます
🏠
スクリーンショット:ホーム画面
起動直後のホーム画面 → assets/screenshots/home-screen.png に保存

最初のプロジェクト

  1. ホーム画面の「新規プロジェクト」をクリック
  2. プロジェクト名とゲームタイプを選択
  3. 保存先フォルダを選んで「作成」をクリック
  4. メインエディタが開くので「シーン1」をダブルクリックして編集開始

🖥️ エディタ概要

NovelCraftのエディタは5つのパネルで構成されています。

🖥️
スクリーンショット:エディタ全体(5パネル)
assets/screenshots/editor-full.png に保存
できれば各パネルが見えるように広げた状態で撮影してください
パネル名場所役割
シナリオツリー左側チャプター・シーンの階層管理
シナリオエディタ中央上テキスト・コマンドの入力・編集
プレビュー右側リアルタイムプレビュー表示
リソースマネージャ左下画像・音楽・動画の管理
プロパティパネル右下選択中コマンドの詳細設定

シナリオエディタ

コマンドブロックをドラッグ&ドロップで配置・並び替えできます。

📝
スクリーンショット:シナリオエディタ
コマンドブロックが並んでいる状態 → assets/screenshots/scenario-editor.png

フローチャートビュー

上部の「フローチャート」タブでシーンの分岐構造をノード形式で確認・編集できます。

🌿
スクリーンショット:フローチャートビュー
assets/screenshots/flowchart.png

リソース管理

対応フォーマット:

  • 画像: PNG, JPG(背景・立ち絵・スチル)
  • 音声: MP3, OGG(BGM・SE・ボイス)
  • 動画: MP4, WebM(OP/ED・ムービー)

💬 テキスト・台詞

text — テキスト表示

キャラクターの台詞やナレーションを表示します。最も基本的なコマンドです。

パラメータ説明
namestringキャラクター名(省略でナレーション) optional
textstring表示するテキスト required
speednumber文字表示速度 0〜100(デフォルト: 50) optional
voicestringボイスファイル名 optional
windowstringnormal / full / transparent optional
// キャラクターの台詞
text(name: "明日葉", text: "あなたも…ここに来るんですね")

// ナレーション
text(text: "夕暮れに染まった屋上で、彼女は一人佇んでいた。")

🖼️ 背景・演出

background — 背景変更

パラメータ説明
imagestring背景画像ファイル名 required
transitionstringfade / crossfade / wipe / instant optional
durationnumberトランジション時間(ms) optional
background(image: "bg_classroom.png", transition: "fade", duration: 800)
effect(type: "shake", intensity: 5, duration: 600)

👤 キャラクター

showChara / moveChara / hideChara

showChara(id: "asaba", expression: "surprised", position: "right", fade: 300)
moveChara(id: "asaba", to: "center", duration: 600)
hideChara(id: "all", fade: 500)

🎵 BGM・SE・ボイス

コマンド主なパラメータ説明
playBGMfile, loop, volume, fadeInBGMを再生(デフォルトでループ)
stopBGMfadeOutBGMをフェードアウトして停止
playSEfile, volume効果音を再生

🔀 選択肢・分岐

choice([
  { label: "「ええ、よくここで考えごとを」", jump: "route_a" },
  { label: "「あなたこそ、何を見ているの?」", jump: "route_b" },
  { label: "「…何でもない」", jump: "route_c" }
])

if / else / endif

if (love_point >= 80)   jump("good_ending")
else if (love_point >= 40) jump("normal_ending")
else                      jump("bad_ending")
endif

📊 変数・フラグ

setVar(name: "love_point", value: 0)
setVar(name: "love_point", value: 10, op: "add")
setVar(name: "flag_met",   value: true)

⚙️ システムコマンド

コマンドパラメータ説明
waitms: number指定ミリ秒待機
jumplabel: string指定ラベルにジャンプ
labelname: stringジャンプ先ラベルを定義
saveセーブ画面を開く
loadロード画面を開く
endシナリオ終了

📦 エクスポート

メニューバーの「Export」からゲームを書き出せます。

形式出力物配布方法
Windows EXE配布フォルダ一式ZIPで圧縮して配布
macOS App.app バンドル.dmg化して配布
HTML5 Webhtml フォルダWebサーバーにアップロード
📦
スクリーンショット:エクスポートダイアログ
assets/screenshots/export-dialog.png

🗺️ ロードマップ

機能状態バージョン目標
基本テキスト・背景・キャラクター✓ 実装済みv0.9.x
セーブ/ロード・バックログ✓ 実装済みv0.9.x
HTML5エクスポート✓ 実装済みv0.9.x
AIアシスト機能🔨 開発中v1.0
プラグインシステム🔨 開発中v1.0
Android APK出力📅 予定v1.1
共同編集機能📅 予定v1.2+