Skip to content

コンフィグレーション

エンジンのコンフィグレーションは複数の ScriptableObject アセットに保存されており、Assets/NaninovelData/Resources/Naninovel/Configuration フォルダーにあります。 これらはUnityエディターで対応するコンフィグメニューを初めて開いたときに、自動的に生成されます。

コンフィグメニューへは Naninovel -> Configuration または Edit -> Project Settings -> Naninovel でアクセスします。

全てのコンフィグメニューは Unityのプリセット機能 ↗ をサポートしています。異なるプラットフォーム(モバイル、スタンドアロン、コンソールなど)を対象にデプロイする場合、いくつかのコンフィグプリセットを作成すると便利です。

cover

実行時にコンフィグオブジェクトを変更し、新しいカスタムコンフィグを追加して、実行時にオブジェクトにアクセスする方法を変更することができます(たとえば、コンフィグをリモートホストに保存されているJSONファイルから読み取る)。詳細については、カスタムコンフィグ ガイドを参照してください。

NOTE

このコンフィグレーションリファレンスは Naninovel v1.10 ↗ で有効です。

Audio

プロパティデフォルト値説明
Audio LoaderAudio- (Addressable, Project)オーディオ(BGMとSFX)リソースで使用されるリソースローダーの構成。
Voice LoaderVoice- (Addressable, Project)ボイスリソースで使用されるリソースローダーの構成。
Default Master Volume1ゲーム開始時に設定するマスターボリューム。
Default Bgm Volume1ゲーム開始時に設定するBGMのボリューム。
Default Sfx Volume1ゲーム開始時に設定するSFXのボリューム。
Default Voice Volume1ゲーム開始時に設定するボイスボリューム。
Enable Auto VoicingFalse有効になっていると、それぞれの PrintText コマンドは VoiceResourcesPrefix/ScriptName/LineIndex.ActionIndex にあるボイスクリップの再生を試みます。
Voice Overlap PolicyPrevent Overlapボイス同時再生の処理方法を指示します:
• Allow Overlap — 同時ボイスは制限なしで再生されます。
• Prevent Overlap — 新しいボイスクリップを再生する前に、再生中のボイスクリップを停止し、ボイスの同時再生を防ぎます。
• Prevent Character Overlap — 同じキャラクターのボイス同時再生を防ぎます。異なるキャラクターのボイス(自動ボイシング)と任意の数の @voice コマンドを同時に再生できます。
Custom Audio MixerNullオーディオグループを制御するオーディオミキサー。指定されていない場合はデフォルトのものを使用します。
Master Volume Handle NameMaster Volumeマスターボリュームを制御するミキサーのハンドル名(公開パラメーター)。
Bgm Group PathMaster/BGMマスターボリュームを制御するミキサーのグループのパス。
Bgm Volume Handle NameBGM Volumeバックグラウンドミュージックの音量を制御するためのミキサーのハンドル名(公開パラメーター)。
Sfx Group PathMaster/SFXバックグラウンドミュージックの音量を制御するミキサーグループのパス。
Sfx Volume Handle NameSFX Volume効果音の音量を制御するミキサーのハンドル名(公開パラメーター)。
Voice Group PathMaster/Voiceボイスの音量を制御するミキサーグループのパス。
Voice Volume Handle NameVoice Volumeボイスの音量を制御するミキサーのハンドル名(公開パラメーター)。

Backgrounds

プロパティデフォルト値説明
Default MetadataObject Ref背景アクターを作成するときデフォルトで使用するメタデータ。また作成したアクターIDが存在しないときのカスタムメタデータ。
MetadataObject Ref指定したIDで背景アクターを作成するときのメタデータ。
Scene Origin(0.5, 0.0)シーンにアクターを配置するときに参照する起点。
Z Offset100アクターの作成時に設定する、アクターからカメラへの初期Z軸オフセット(深さ)。
Z Step0.1アクターが作成されたときにアクター間に設定するZ軸による距離。 Zファイティングの問題を防ぐために使用されます。
Default EasingLinearアクター変更時の全てのアニメーション(外観、位置、色合いの変更など)にデフォルトで使用するイージング関数。
Auto Show On ModifyTrue変更コマンドの実行時にアクターを自動的に表示するかどうか。

Camera

プロパティデフォルト値説明
Reference Resolution(1920, 1080)参照解像度は、適切なレンダリング寸法を評価するために使用されます。これによりスプライトアセット(背景やキャラクターなど)はシーンに正しく配置されます。一般的に、ゲーム用に作成する背景テクスチャの解像度と同じに設定します。
Auto Correct Ortho SizeTrue現在のディスプレイのアスペクト比に基づいてカメラの正投影サイズを自動的に修正して、背景とキャラクターが正しく配置されるようにするかどうか。
Default Ortho Size5.35自動修正が無効になっているときにデフォルトで設定する正投影サイズ。
Initial Position(0.0, 0.0, -10.0)カメラの初期ワールド位置。
OrthographicTrueカメラをデフォルトで正投影(有効)モードまたは遠近法(無効)モードのどちらでレンダリングするか。 カスタムカメラプレハブが割り当てられている場合は効果がありません。
Custom Camera PrefabNullレンダリングに使用するカメラコンポーネントが追加されたプレハブ。指定しない場合はデフォルトを使用します。カメラプロパティ(背景色、FOV、HDRなど)を設定する場合、または後処理スクリプトを追加する場合は、希望のカメラ設定でプレハブを作成し、このフィールドにプレハブを割り当てます。
Use UI CameraTrue別のカメラでUIをレンダリングするかどうか。 これにより、メインカメラとUIカメラに個別の構成を使用できるようになり、後処理(画像)エフェクトがUIに影響するのを防ぎますが、多少のレンダリングオーバーヘッドが発生します。
Custom UI Camera PrefabNullUIレンダリングに使用するカメラコンポーネントを備えたプレハブ。指定しない場合はデフォルトになります。UseUICamera が無効になっている場合は効果がありません。
Default EasingLinearカメラ変更時(ズーム、ポジション、回転など)の全てのアニメーションにデフォルトで使用するイージング関数。
Thumbnail Resolution(240, 140)ゲームの保存スロットのプレビューサムネイルをキャプチャする解像度。
Hide UI In ThumbnailsFalseサムネイルのキャプチャ時にUIレイヤーを無視するかどうか。

Characters

プロパティデフォルト値説明
Auto Arrange On AddTrue位置を指定せずに新しいキャラクターを追加するときに、X軸でキャラクターを均等に配分するかどうか。
Default MetadataObject Refキャラクターアクターを作成するときデフォルトで使用するメタデータ。また作成したアクターIDが存在しないときのカスタムメタデータ。
MetadataObject Ref指定したIDでキャラクターアクターを作成するときのメタデータ。
Avatar LoaderCharacter Avatars- (Addressable, Project)キャラクターアバターテクスチャリソースで使用されるリソースローダーの構成。
Scene Origin(0.5, 0.0)シーンにアクターを配置するときに参照する起点。
Z Offset50アクターの作成時に設定する、アクターからカメラへの初期Z軸オフセット(深さ)。
Z Step0.1アクターが作成されたときにアクター間に設定するZ軸による距離。 Zファイティングの問題を防ぐために使用されます。
Default EasingSmooth Stepアクター変更時の全てのアニメーション(外観、位置、色合いの変更など)にデフォルトで使用するイージング関数。
Auto Show On ModifyTrue変更コマンドの実行時にアクターを自動的に表示するかどうか。

Choice Handlers

プロパティデフォルト値説明
Default Handler IdButton Listデフォルトで使用する選択肢ハンドラーのID。
Default MetadataObject Ref選択肢アクターを作成するときデフォルトで使用するメタデータ。また作成したアクターIDが存在しないときのカスタムメタデータ。
MetadataObject Ref指定したIDで選択肢アクターを作成するときのメタデータ。
Default EasingLinearアクター変更時の全てのアニメーション(外観、位置、色合いの変更など)にデフォルトで使用するイージング関数。
Auto Show On ModifyTrue変更コマンドの実行時にアクターを自動的に表示するかどうか。

Custom Variables

プロパティデフォルト値説明
Predefined VariablesObject Refデフォルトで初期化する変数のリスト。グローバル変数( G_ または g_ で始まる名前)は、最初のアプリケーションの起動時に初期化され、その他は状態がリセットされるたびに初期化されます。

Engine

プロパティデフォルト値説明
Generated Data PathNaninovel Data自動生成されたアセットを格納するための、アプリケーションデータディレクトリへの相対パス。
Override Objects LayerFalseすべてのエンジンオブジェクトに特定のレイヤーを割り当てるかどうか。エンジンのカメラは、カリングマスクのレイヤーを使用します。これを使って、Naninovel オブジェクトを他のカメラによるレンダリングから分離します。
Objects Layer0Override Objects Layer が有効の場合に、指定したレイヤーが全てのエンジンオブジェクトに割り当てられます。
Async Exception Log TypeErrorUniTask関連の例外に使用するログタイプ。
Initialize On Application LoadTrueアプリケーションの起動時にエンジンを自動的に初期化するかどうか。
Show Initialization UITrueエンジンの初期化中にロード中UIを表示するかどうか。
Custom Initialization UINullエンジンの初期化中に表示するUI(有効な場合)。指定しない場合はデフォルトを使用します。
Show Title UITrueエンジンの初期化後にタイトル画面のUI(メインメニュー)を自動的に表示するかどうか。UIカスタマイズ機能を使用して、タイトルUIを変更できます(詳細については、オンラインガイドを参照してください)。
Enable Development ConsoleTrue開発コンソールを有効にするかどうか。
Toggle Console KeyBack Quote開発コンソールの切り替えに使用するキー。タッチスクリーンを使用する場合、マルチ(3以上)タッチに切り替えることもできます。

Input

プロパティデフォルト値説明
Spawn Event SystemTrue初期化時にイベントシステムを生成するかどうか。
Custom Event SystemNull入力処理のために生成する、EventSystem コンポーネントを含むプレハブ。指定されていない場合、デフォルトを生成します。
Spawn Input ModuleTrue初期化時に入力モジュールを生成するかどうか。
Custom Input ModuleNull入力処理のために生成する、InputModule コンポーネントを含むプレハブ。指定されていない場合、デフォルトを生成します。
Touch Frequency Limit0.1タッチ入力の頻度を制限。秒単位。
Process Legacy BindingsTrueレガシー入力バインディングを処理するかどうか。Unityの新しい入力システムを使用していて、入力アクションに加えてレガシーバインディングを機能させたくない場合は、無効にします。
BindingsObject Ref入力を処理するためのバインディング。

Localization

プロパティデフォルト値説明
LoaderLocalization- (Addressable, Project)ローカライゼーションリソースで使用されるリソースローダーの構成。
Source LocaleEnソースプロジェクトリソースのロケール(プロジェクトアセットが作成されている言語)。
Default LocaleNullゲームを初めて実行するときにデフォルトで選択されるロケール。指定しない場合は Source Locale が選択されます。

Managed Text

プロパティデフォルト値説明
LoaderText- (Addressable, Project)管理テキストドキュメントリソースで使用されるリソースローダーの構成。

Movies

プロパティデフォルト値説明
LoaderMovies- (Addressable, Project)動画リソースで使用されるリソースローダーの構成。
Skip On InputTrueユーザーが キャンセル キーをアクティブにしたときにムービーの再生をスキップするかどうか。
Skip FramesTrue現在の時間に追いつくためにフレームをスキップするかどうか。
Fade Duration1ムービーの再生を開始/終了する際、フェードイン/フェードアウトする時間。秒単位。
Custom Fade TextureNullフェード中に表示するテクスチャ。指定しない場合は、シンプルな黒のテクスチャを使用します。
Play Intro MovieFalseエンジンの初期化後、メインメニューを表示する前に、ムービーを自動的に再生するかどうか。
Intro Movie NameNullイントロムービーリソースへのパス。

Resource Provider

プロパティデフォルト値説明
Resource PolicyStaticスクリプトの実行中にリソースをロードおよびアンロードする時の指示:
• Static — スクリプトの実行に必要なすべてのリソースが、再生の開始時にプリロードされ(ロード画面でマスクされます)、スクリプトの再生が終了したときにのみアンロードされます。このポリシーはデフォルトで、ほとんどの場合に推奨されます。
• Dynamic — 次の Dynamic Policy Steps コマンドに必要なリソースのみがスクリプトの実行中にプリロードされ、未使用のすべてのリソースはすぐにアンロードされます。 このモードは、対象プラットフォームのメモリ制限が厳しく、naninovelスクリプトを適切に構成することができない場合に使用します。ゲームの進行中にリソースがバックグラウンドでロードされると、一時的な障害が発生することが予想されます。
Dynamic Policy Steps25動的リソースポリシーが有効な場合に、プリロードするスクリプトコマンドの数を定義します。
Optimize Loading PriorityTrue動的リソースポリシーが有効の場合に、Unityのバックグラウンドロードスレッドの優先度が低に設定され、スクリプトの再生中にリソースをロードするときに問題が発生しなくなります。
Log Resource LoadingFalseロード画面でリソースのロード操作をログに記録するかどうか。
Enable Build ProcessingTrueNaninovelリソースとして割り当てられたアセットを処理するためのカスタムビルドプレーヤーハンドルを登録するかどうか。

注意: この設定を有効にするには、Unityエディターを再起動する必要があります。
Use AddressablesTrueAddressable アセットシステムがインストールされている場合にこのプロパティを有効にすると、アセット処理ステップが最適化され、ビルド時間が改善されます。
Auto Build BundlesTrueプレーヤーの構築時に Addressable アセットバンドルを自動的に構築するかどうか。 Use Addressables が無効になっている場合は効果がありません。
Allow Addressable In EditorFalseエディターで Addressable プロバイダーを使用するかどうか。Naninovelのリソースマネージャーでリソースを割り当てずに Addressable アドレスを介してリソースを手動で公開する場合に有効にします。これを有効にすると、リソースがリソースマネージャーと Addressable アドレスの両方に登録し、名前の変更や複製をした場合に問題が発生する可能性があります。
Extra LabelsNullAddressable プロバイダーは、Naninovel ラベルに加えてラベルが割り当てられているアセットでのみ機能します。カスタム基準(HDとSDテクスチャなど)に基づいてエンジンが使用するアセットをフィルタリングするのに使用されます。
Local Root Path%DATA%/Resourcesローカルリソースプロバイダーのパスルート。リソースが配置されているフォルダーへの絶対パス、または以下の起点を含む相対パスを指定できます:
• %DATA% — ターゲットデバイス上のゲームデータフォルダー (UnityEngine.Application.dataPath).
• %PDATA% — ターゲットデバイス上の永続的なデータディレクトリ (UnityEngine.Application.persistentDataPath).
• %STREAM% — StreamingAssets フォルダー (UnityEngine.Application.streamingAssetsPath).
• %SPECIAL{F}% — OS専用フォルダ (F は System.Environment.SpecialFolder の値).
Project Root PathNaninovelnaninovel固有のアセットが配置されている Resources フォルダーへの相対パス。
Google Drive Root PathResourcesGoogleドライブリソースプロバイダーに使用するパスルート。
Google Drive Request Limit2Googleドライブ APIに接続するときに許可される同時リクエストの最大数。
Google Drive Caching PolicySmartリソースをダウンロードする際のキャッシュポリシー。Smart は、Changes API を使用してドライブの変更を確認します。PurgeAllOnInit は、プロバイダーが初期化されるときにすべてのリソースを再ダウンロードします。

Script Player

プロパティデフォルト値説明
Skip Time Scale10スキップ(早送り)モードのときに使用するタイムスケール。
Min Auto Play Delay3自動再生モード中、次のコマンドを実行するまで待機する最小秒数。
Show Debug On InitFalseエンジンの初期化時にプレーヤーのデバッグウィンドウを表示するかどうか。

Scripts

プロパティデフォルト値説明
LoaderScripts- (Addressable, Project)naninovel スクリプトリソースで使用されるリソースローダーの構成。
Initialization ScriptNullエンジンの初期化直後に再生するスクリプトの名前。
Title ScriptNullタイトルUIを表示するときに再生するスクリプトの名前。 タイトル画面のシーン(背景、音楽など)の設定に使用できます。
Start Game ScriptNull新しいゲームを開始するときに再生するスクリプトの名前。指定しない場合、最初の利用可能なスクリプトが使用されます。
Auto Add ScriptsTrue作成したnaninovelスクリプトをリソースに自動的に追加するかどうか。
Hot Reload ScriptsTrueビジュアルエディターまたは外部エディターで変更されたスクリプトを再読み込みし、再生を再開せずにプレイモード中に変更を適用するかどうか。
Count Total CommandsFalseサービスの初期化ですべてのnaninovelスクリプトに存在するコマンドの数を計算するかどうか。naninovelスクリプト式でスクリプトマネージャーの TotalCommandsCount プロパティと CalculateProgress 関数を使用しない場合は、無効にしてエンジンの初期化時間を短縮します。
Enable Visual EditorTrueスクリプトが選択されたときにビジュアルスクリプトエディターを表示するかどうか。
Hide Unused ParametersTrue行がホバーまたはフォーカスされていないときに、コマンドラインで割り当てられていないパラメーターを非表示にするかどうか。
Insert Line KeySpaceビジュアルエディターがフォーカスされているときに 行の挿入 ウィンドウを表示するホットキー。無効にするには、None に設定します。
Insert Line ModifierControl行の挿入キーの修飾子。無効にするには、None に設定します。
Save Script KeySビジュアルエディターにフォーカスがあるときに、編集したスクリプトを保存(シリアル化)するホットキー。無効にするには、None に設定します。
Save Script ModifierControlスクリプト保存キー の修飾子。無効にするには、None に設定します。
Editor Page Length1000ビジュアルエディターページごとにレンダリングするスクリプト行の数。
Editor Custom Style SheetNullビジュアルエディターのデフォルトスタイルを変更できます。
Graph OrientationHorizontalグラフを垂直、水平のどちらで作成するか。
Graph Auto Align Padding(10.0, 0.0)自動整列を実行するときに各ノードに追加するパディング。
Graph Custom Style SheetNullスクリプトグラフのデフォルトスタイルを変更できます。
Enable Community ModdingFalseビルドへの外部naninovelスクリプトの追加を許可するかどうか。
External LoaderScripts- (Local)外部naninovelスクリプトリソースで使用されるリソースローダーの構成。
Enable NavigatorTrue使用可能なnaninovelスクリプトを参照するためにスクリプトナビゲーターを初期化するかどうか。
Show Navigator On InitFalseスクリプトマネージャーの初期化時にnaninovelスクリプトナビゲーターを表示するかどうか。
Navigator Sort Order900スクリプトナビゲーターのUIソート順。

Spawn

プロパティデフォルト値説明
LoaderSpawn- (Addressable, Project)spawn リソースで使用されるリソースローダーの構成。

State

プロパティデフォルト値説明
Save Folder NameSavesフォルダはゲームデータフォルダに作成されます。
Default Settings Slot IdSettings設定保存ファイルの名前。
Default Global Slot IdGlobal Saveグローバル保存ファイルの名前。
Save Slot MaskGame Save{0:000}セーブスロットの名前に使用されるマスク。
Quick Save Slot MaskGame Quick Save{0:000}クイックセーブスロットの命名に使用されるマスク。
Save Slot Limit99セーブスロットの最大数。
Quick Save Slot Limit18クイックセーブスロットの最大数。
Binary Save FilesTrueセーブをテキストファイル(.json)ではなくバイナリファイルとして圧縮保存するかどうか。これにより、ファイルサイズが大幅に削減され、編集が難しくなります(チートを防止できます)が、セーブとロードの際により多くのメモリとCPU時間を消費します。
Load Start Delay0.3ロード操作を開始するまで待機する秒数。 ロード関連のスタッターが発生する前に、プリロードアニメーションを完了します。
Reset On GotoTrue@goto コマンドで別のスクリプトをロードするときに、エンジンサービスのステートをリセットしてリソースをアンロード(破棄)するかどうか。 メモリリークを防ぐため、有効にすることをお勧めします。 このオプションを無効にした場合でも、@resetState コマンドを使用して、いつでもステートをリセットし、リソースを手動で破棄できます。
Enable State RollbackTrueステートのロールバック機能を有効にするかどうか。プレーヤーがスクリプトを巻き戻すことができます。
State Rollback Steps1024実行時に保持する状態スナップショットの数。ロールバック(巻き戻し)できる量を決定します。この値を大きくすると、より多くのメモリが消費されます。
Saved Rollback Steps128セーブスロットの下でシリアル化(保存)するステートスナップショットの数。セーブしたゲームを読み込んだ後、ロールバックをどれだけ前までできるかを決定します。この値を大きくすると、セーブファイルが大きくなります。
Game State HandlerNaninovel.IO Game State Slot Manager, Elringus.Naninovel.Runtime, Version=0.0.0.0, Culture=neutral, Public Key Token=nullローカル(セッション固有)のゲームステートを非/シリアル化するための実装。カスタムのシリアル化ハンドラーを追加する方法については、ステート管理 ガイドを参照してください。
Global State HandlerNaninovel.IO Global State Slot Manager, Elringus.Naninovel.Runtime, Version=0.0.0.0, Culture=neutral, Public Key Token=nullグローバルのゲームステートを非/シリアル化するための実装。カスタムのシリアル化ハンドラーを追加する方法については、ステート管理 ガイドを参照してください。
Settings State HandlerNaninovel.IO Settings Slot Manager, Elringus.Naninovel.Runtime, Version=0.0.0.0, Culture=neutral, Public Key Token=nullゲーム設定を非/シリアル化するための実装。カスタムのシリアル化ハンドラーを追加する方法については、ステート管理 ガイドを参照してください。

Text Printers

プロパティデフォルト値説明
Default Printer IdDialogueデフォルトで使用するテキストプリンターのID。
Max Reveal Delay0.06テキストメッセージを表示するときの待ち時間の制限(秒単位)。表示速度は、ゲーム設定の message speed で設定されます。この値は、使用可能な範囲を定義します(値が高いほど、表示速度が低くなります)。
Max Auto Wait Delay0.02オートプレイモードの続行を待機している間の、各表示キャラクターの待ち時間の制限(秒単位)。待ち時間は、ゲーム設定の auto delay で設定されます。この値は、使用可能な範囲を定義します。
Scale Auto WaitTrueオートプレイモードでの待機時間を、プリントコマンドで設定した表示速度でスケーリングするかどうか。
Default MetadataObject Refテキストプリンターアクターを作成するときデフォルトで使用するメタデータ。また作成したアクターIDが存在しないときのカスタムメタデータ。
MetadataObject Ref指定したIDでテキストプリンターアクターを作成するときのメタデータ。
Scene Origin(0.5, 0.0)シーンにアクターを配置するときに参照する起点。
Z Offset100アクターの作成時に設定する、アクターからカメラへの初期Z軸オフセット(深さ)。
Z Step0.1アクターが作成されたときにアクター間に設定するZ軸による距離。 Zファイティングの問題を防ぐために使用されます。
Default EasingLinearアクター変更時の全てのアニメーション(外観、位置、色合いの変更など)にデフォルトで使用するイージング関数。
Auto Show On ModifyFalse変更コマンドの実行時にアクターを自動的に表示するかどうか。

UI

プロパティデフォルト値説明
LoaderUI- (Addressable, Project)UIリソースで使用されるリソースローダーの構成。
Objects Layer5エンジンによってインスタンス化されたUI要素に割り当てるレイヤー。UI切り替え 機能を使用するときにUIをカリングするのに使用されます。
Render ModeScreen Space CameraすべてのマネージドUI要素に適用するキャンバスレンダリングモード。
Sorting Offset1すべてのマネージドUI要素に適用するソートオフセット。

Unlockables

プロパティデフォルト値説明
LoaderUnlockables- (Addressable, Project)収集アイテムリソースで使用されるリソースローダーの構成。