# 属性配置

资源配置保存于Assets/NaninovelData/Resources/Naninovel/Configuration 目录。 这些在第一次打开配置菜单的时候会自动生成。

配置菜单按 Naninovel -> Configuration or Edit -> Project Settings -> Naninovel 打开。

注意,所有配置菜单支持unity的预设保存功能如下图 Unity预设特性. 在发布到不同平台的时候很方便。(如, 移动手机, 个人电脑, 主机, 等).

在项目运行的时候也可以修改或是添加新配置,或是改变读取配置信息的方式,(如,从远端读取json文档),详情参考 自定义配置

注意

该配置根据版本 Naninovel v1.10.

# 音频

属性 默认值 描述
Audio Loader Audio- (Addressable, Project) 用于读取(BGM和音效SFX)的加载器。
Voice Loader Voice- (Addressable, Project) 用于读取Voice(大概指人声音配音)。
Default Master Volume 1 用于控制游戏音量。
Default Bgm Volume 1 用于控制BGM音量。
Default Sfx Volume 1 用于控制SFX音量。
Default Voice Volume 1 用于控制人声音量。
Enable Auto Voicing 开启人声自动播放 False 启用时每个PrintText 命令会试图播放以下的音频剪辑VoiceResourcesPrefix/ScriptName/LineIndex.ActionIndex
Voice Overlap Policy 人声重叠规则 Prevent Overlap 决定怎么播放重叠的人声:
• Allow Overlap — 允许已播放的声音播放结束,允许人声重叠
• Prevent Overlap — 停止任何正在播放的人声,再播放吓一跳,不允许人声重叠
• Prevent Character Overlap — 不允许同一角色的声音重叠,允许不同的角色的声音重叠。 (auto voicing)和@voice命令的声音可以重叠。
Custom Audio Mixer Null 音频混合器,用于控制Audio groups。未定义时使用默认值。
Master Volume Handle Name Master Volume 控制主音量的混合器的名字 (exposed parameter公开参数)。
Bgm Group Path Master/BGM 控制的BGM组的路径。
Bgm Volume Handle Name BGM Volume 控制BGM的混合器的名字 (exposed parameter公开参数)。
Sfx Group Path Master/SFX 控制的SFX组的路径。
Sfx Volume Handle Name SFX Volume 控制SFX音效的混合器的名字 (exposed parameter公开参数)。
Voice Group Path Master/Voice 控制人声组的路径。
Voice Volume Handle Name Voice Volume 控制人声的混合器的名字 (exposed parameter公开参数)。

# 背景

属性 默认值 描述
Default Metadata Object Ref 默认使用的数据的元数据配置,创建背景元素和要使用的元素ID不存在时调用的。
Metadata Object Ref 创建具体ID背景元素时使用的元数据。
Scene Origin (0.5, 0.0) 场景中背景生成的定位参考点。
Z Offset 100 创建元素时初始化元素与相机的z轴偏移。
Z Step 0.1 z轴上生成元素的间隔,用于避免深度渲染冲突。
Default Easing Linear 默认使用的切换动画效果,如改变外观,位置,色调等。
Auto Show On Modify True 当执行修改命令后,是否自动显示(演示)元素。

# 相机

属性 默认值 描述
Reference Resolution (1920, 1080) 参考分辨率用于评估正确渲染范围,以保证背景人物元素的正常显示,建议背景元素分辨率和该设置保持一致。
Auto Correct Ortho Size True 是否基于当前相机显示的方位比率来纠正正交大小,以此确保背景和人物的位置正确。
Default Ortho Size 5.35 当自动纠正关闭时,默认相机正交大小。
Initial Position (0.0, 0.0, -10.0) 生成相机的世界坐标位置。
Orthographic True 相机使用透视还是正交模式,自定义相机预制体由定义时无效。
Custom Camera Prefab Null 带相机组件用于渲染的预制体,不定义时,使用默认设置,如果你想修改部分属性(背景色,FOV,HDR,等)或者添加后处理脚本效果,按需创建预制体绑定即可。
Use UI Camera True 是否使用单独相机渲染UI,会使用各自的配置应用于主要相机和UI相机,这样可以避免图像后处理影响到UI,节约部分性能。
Custom UI Camera Prefab Null 带相机组件的用于UI渲染的相机预制体,不配置时使用默认,当 UseUICamera 关闭时无效。
Default Easing Linear 默认使用的相机过渡动画效果(缩放,位置,旋转等)。
Thumbnail Resolution (240, 140) 保存栏位的截图分辨率。
Hide UI In Thumbnails False 截图时是否忽略UI层级。

# 人物

属性 默认值 描述
Auto Arrange On Add True 是否按X轴平均分布新生成的角色。
Default Metadata Object Ref 默认使用的数据的元数据配置,创建角色元素和要使用的元素ID不存在时调用的。
Metadata Object Ref 创建具体ID角色元素时使用的元数据。
Avatar Loader Character Avatars- (Addressable, Project) 用于加载人物头像的资源加载器配置。
Scene Origin (0.5, 0.0) 场景中人物生成的定位参考点。
Z Offset 50 生成元素到相机的z轴偏移。
Z Step 0.1 生成元素z轴偏移,避免深度渲染冲突。
Default Easing Smooth Step 默认使用的切换动画效果,如改变外观,位置,色调等。
Auto Show On Modify True 当执行修改命令后,是否自动显示(演示)元素。

# 选择处理器

属性 默认值 描述
Default Handler Id Button List 默认使用的选择处理器。
Default Metadata Object Ref 默认使用的数据的元数据配置,创建选择处理器和要使用的选择处理器ID不存在时调用的。
Metadata Object Ref 创建具体ID选择处理器时使用的元数据。
Default Easing Linear 默认使用的切换动画效果,如改变外观,位置,色调等。
Auto Show On Modify True 当执行修改命令后,是否自动显示(演示)元素。

# 自定义变量

属性 默认值 描述
Predefined Variables Object Ref 默认初始化的列表变量。 全局变量(名字 G_ or g_开头)在启动时初始化,其他在每个state使用时初始化。

# 引擎

属性 默认值 描述
Generated Data Path Naninovel Data 存储自动生成资源的路径。
Override Objects Layer False 是否为所有引擎物体,绑定特定layer,用于Unity相机渲染的culling mask,用于避免Naninovel被其他相机渲染。
Objects Layer 0 Override Objects Layer 开启时,该layer会被用于所有游戏物体。
Async Exception Log Type Error 用于UniTask相关异常的记录日志类型。
Initialize On Application Load True 应用启动时,本资源是否自动初始化。
Show Initialization UI True 资源初始化的时候,是否显示加载UI。
Custom Initialization UI Null 前者启用时显示的UI。不定义时使用默认。
Show Title UI True 资源初始化完成以后是否自动显示标题画面,你可以定制标题画面,使用资源的自定义UI特性,参考指导手册。
Enable Development Console True 是否打开开发控制台。
Toggle Console Key Back Quote 切换控制台的key,在触摸屏你可以使用多点触摸呼出。

# 输入

属性 默认值 描述
Spawn Event System True 是否在初始化是生成event system。
Custom Event System Null 带有EventSystem 组件的预制体,用于监听输入,未定义时生成默认的。
Spawn Input Module True 是否在初始化是生成input module。
Custom Input Module Null 带有InputModule 组件的预制体,用于监听输入,未定义时生成默认的。
Touch Frequency Limit 0.1 触摸输入频率闲置,单位秒。
Process Legacy Bindings True 是否使用传统输入方式,如果使用新的Unity输入系统,就关闭。
Bindings Object Ref 用于存取输入的Bindings。

# 本地化

属性 默认值 描述
Loader Localization- (Addressable, Project) 用于加载本地化资源的加载器。
Source Locale En 本地项目的使用哪种本地化配置(用于资源的语言设置)。
Default Locale Null 第一次启动时使用的本地化配置。如果不配置则使用 Source Locale 的配置。

# 文本管理

属性 默认值 描述
Loader Text- (Addressable, Project) 用于加载托管文本的资源加载器配置。

# 影片

属性 默认值 描述
Loader Movies- (Addressable, Project) 用于加载电影的资源加载器配置。
Skip On Input True 播放时是否允许用户点击去掉跳过。
Skip Frames True 是否允许帧跳过以匹配当前时间。
Fade Duration 1 播放开始结束时的渐入渐隐时长。
Custom Fade Texture Null 渐入渐隐显示的图片,不定义时使用默认黑色效果过渡。
Play Intro Movie False 显示标题菜单以前是否使用开场动画。
Intro Movie Name Null 开场动画的路径配置。

# 资源加载器

属性 默认值 描述
Resource Policy Static 脚本执行时,加载卸载资源的规则:
• Static — (静态)所有资源在读取画面时预加载,并在脚本执行完成后卸载,默认使用的配置推荐适用于大多情况。
• Dynamic — 动态)根据Dynamic Policy Steps设置来加载,不使用的资源立即卸载。用于低配低内存设备,可能在游戏时会有由于加载造成的卡顿。
Dynamic Policy Steps 25 当Resource Policy使用动态配置时,定义在多少句前预加载。
Optimize Loading Priority True 当Resource Policy使用动态配置时,会将Uniyt的后台加载线程优先级设置为低,避免加载卡顿。
Log Resource Loading False 是否再加载界面显示资源加载信息。
Enable Build Processing True Whether to register a custom build player handle to process the assets assigned as Naninovel resources.

注意: 重启Unity编辑器后生效。
Use Addressables True 当Addressable Asset System安装时,开启会优化资源读取,节约build时间。
Auto Build Bundles True 是否在发布是自动生成可寻址资源的AB包。 Use Addressables 关闭时无效。
Allow Addressable In Editor False 是否在编辑器模式下使用可寻址资源加载器。如果你是手动配置地址而非在配置管理器里配置,就开启。注意,如果两边同时注册了可能会有问题,请改名或是从资源目录复制出来以区分。
Extra Labels Null 可寻址提供程序将只处理除“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 Path Naninovel 相对于 Resources 文件夹的路径,naninovel特定资产位于该文件夹下。
Google Drive Root Path Resources Google Drive资源加载器类路径。
Google Drive Request Limit 2 Google Drive最大同时连接数。
Google Drive Caching Policy Smart 下载资源时要使用的缓存策略。Smart 将尝试使用Changes API来检查驱动器上的修改。 PurgeAllOnInit 提供程序初始化后,将重新下载所有资源。

# 脚本播放器

属性 默认值 描述
Skip Time Scale 10 在skip模式下使用的time scale。
Min Auto Play Delay 3 在auto模式下执行到下一句命令的最小等待时长。
Show Debug On Init False 是否再引擎初始化时显示玩家debug窗口。

# 脚本

属性 默认值 描述
Loader Scripts- (Addressable, Project) 用于加载Naninovel脚本的的资源加载器配置。
Initialization Script Null 在引擎初始化完成后执行的脚本。
Title Script Null 显示标题画面时执行的脚本。用于定制标题画面,背景,音乐等。
Start Game Script Null 开始新游戏时执行的脚本,未定义时使用配置的第一脚本。
Auto Add Scripts True 是否自动添加创建的Naninovel脚本。
Hot Reload Scripts True 运行中是否自动重新加载编辑后的脚本。
Count Total Commands False 是否在初始化时计算所有可执行语句数量。如果你不使用TotalCommandsCount属性和脚本内的CalculateProgress 方法,可以关闭来节省加载时间。
Enable Visual Editor True 选中脚本时是否自动显示内置编辑器。
Hide Unused Parameters True 某行未被选定或鼠标停留时,是否隐藏未指定参数的命令。
Insert Line Key Space 显示Insert Line窗口的快捷键。设置为None关闭。
Insert Line Modifier Control Insert Line Key的快捷键。设置为None关闭。
Save Script Key S 选中时保存序列化脚本的快捷键,设置为None关闭。
Save Script Modifier Control Save Script Key的快捷键。设置为None关闭。
Editor Page Length 1000 内置编辑器每页可现实多少行。
Editor Custom Style Sheet Null 允许调整编辑器的默认风格。
Graph Orientation Horizontal 允许调整水平或垂直方向。
Graph Auto Align Padding (10.0, 0.0) 在每个节点执行时会加上的外边距。
Graph Custom Style Sheet Null 允许调整默认脚本样式。
Enable Community Modding False 是否允许添加外部naninovel脚本。
External Loader Scripts- (Local) 用于加载外部naninovel脚本的资源加载器配置。
Enable Navigator True 是否允许初始化脚本导航器浏览所有可用naninovel脚本。
Show Navigator On Init False 是否在初始化完成以后显示naninovel脚本导航器。
Navigator Sort Order 900 脚本导航器的sort order。

# 资源生成

属性 默认值 描述
Loader Spawn- (Addressable, Project) 用于生成资源的资源加载器配置。

# 保存状态

属性 默认值 描述
Save Folder Name Saves 会创建于游戏数据目录。
Default Settings Slot Id Settings 设置保存文件的名字。
Default Global Slot Id Global Save 全局保存文件的名字。
Save Slot Mask Game Save{0:000} 命名保存栏位的Mask名字。
Quick Save Slot Mask Game Quick Save{0:000} 命名快速保存栏位的Mask名字。
Save Slot Limit 99 最大保存栏位。
Quick Save Slot Limit 18 最大快速保存栏位。
Binary Save Files True 是否保存为(.nson) 文件而非(.json),更难编辑和作弊,会花费更多cpu和保存读取时间。
Load Start Delay 0.3 在开始加载命令前的等待时间(秒),用于完成预加载动画,避免加载相关的卡顿。
Reset On Goto True 是否允许在使用@goto命令是卸载资源,推荐开启,避免内存溢出问题,如果关闭了该配置,可以手动使用@resetState命令控制卸载资源。
Enable State Rollback True 是否允许玩家回跳文本。
State Rollback Steps 1024 允许在运行时回跳的最大步进数,更大值耗费更多内存。
Saved Rollback Steps 128 允许在读取存档后回跳的最大步进数,更大值保存文件会耗费更多空间。
Game State Handler Naninovel.IO Game State Slot Manager, Elringus.Naninovel.Runtime, Version=0.0.0.0, Culture=neutral, Public Key Token=null 专用于游戏存储(特定于会话的)的序列化和反序列化实现,请参阅 State Management 了解如何添加自定义序列化处理程序。
Global State Handler Naninovel.IO Global State Slot Manager, Elringus.Naninovel.Runtime, Version=0.0.0.0, Culture=neutral, Public Key Token=null 负责反序列化全局游戏状态的实现;请参阅 State Management 了解如何添加自定义序列化处理程序。
Settings State Handler Naninovel.IO Settings Slot Manager, Elringus.Naninovel.Runtime, Version=0.0.0.0, Culture=neutral, Public Key Token=null 负责对游戏设置进行反序列化的实现;请参阅 State Management 了解如何添加自定义序列化处理程序。

# 文本打字机

属性 默认值 描述
Default Printer Id Dialogue 默认使用的text printer的ID配置。
Max Reveal Delay 0.06 延迟限制(单位秒),在设置中message speed可用值范围,值越大,显示速度越慢。
Max Auto Wait Delay 0.02 延迟限制(单位秒),auto模式下每个字母的显示间隔,在设置中auto delay可用值范围,值越大,显示速度越慢。
Scale Auto Wait True 是否在auto模式下根据显示速度自动缩放等待时间。
Default Metadata Object Ref 默认使用的text printer的元数据配置,创建text printer和要使用的text printer的ID不存在时调用的。
Metadata Object Ref 创建具体ID的text printer元素时使用的元数据
Scene Origin (0.5, 0.0) 场景中生成元素的定位参考点。
Z Offset 100 生成元素到相机的z轴偏移。
Z Step 0.1 z轴上生成元素的间隔,用于避免深度渲染冲突。
Default Easing Linear 默认使用的切换动画效果,如改变外观,位置,色调等。
Auto Show On Modify False 当执行修改命令后,是否自动显示(演示)元素。

# UI界面

属性 默认值 描述
Loader UI- (Addressable, Project) 用于加载UI的资源加载器配置。
Objects Layer 5 引擎用于注册UI的layer,用于遮挡剔除UI,用于toogle UI特性。
Render Mode Screen Space Camera 用于所有管理的UI元素的画布渲染模式。
Sorting Offset 1 所有管理元素的排序步进。

# 可解锁配置

属性 默认值 描述
Loader Unlockables- (Addressable, Project) 用于加载未解锁资源的资源加载器配置。
最近更新時間: August 23, 2020