个性化与项目设置

「个性化」模块管理游戏的项目级外观和运行方式，集中在「项目设置」视角中：基础信息、个性化样式、输入按键、游戏系统，以及当前项目的扩展与界面。 这些配置会跟随项目保存，并在预览和打包后的游戏中生效。

​

画布与窗口

「画布与窗口」分类决定打包后的游戏窗口形态。它分为两组设置。

​

画布

设计画布会按比例适配玩家窗口。建议尽早确定与背景、立绘素材一致的宽高比，避免 UI 完成后再大规模调整。

​

桌面窗口

​

画面渲染

「画面渲染」分类设置逻辑画布、内部渲染精度和图片缩放方式，让高精度素材在高分屏上发挥出应有的清晰度。 除了项目设置页，预览工具栏左上角也提供「画面渲染」快捷面板：显示当前分辨率与倍率概要，参数修改后立即应用到预览；面板底部可跳转到完整画面渲染设置。

​

渲染质量

面板底部会实时预估当前配置：内部渲染分辨率与单张渲染纹理的显存占用。倍率越高画面越清晰，显存与 GPU 开销也越大；使用 4K 级素材时建议 2× 起。 修改设置后 Studio 预览会实时重建渲染，无需重启预览即可对比效果。

​

默认帧率与特效质量

「性能」区域决定 Studio 预览和构建后游戏默认使用的帧率与特效档位。 高刷新率能让镜头移动、立绘动画和粒子效果更流畅，但会增加 CPU 与 GPU 开销。作品面向普通显示器时建议保留 60 FPS；需要照顾低性能设备时，可以选择 30 FPS 或降低特效质量。 特效质量不会关闭某种效果，而是调整效果的内部精度和粒子数量。降低档位后，模糊、光照等滤镜会使用更低的内部精度，粒子效果也会减少密度，从而降低显卡负担。

​

项目混音基准

进入 个性化 → 项目设置 → 声音，可以分别调整背景音乐、音效和语音的整部作品基础音量。 100% 使用素材原始音量，范围为 0%～200%。当前音频试听、Studio 预览和构建后的游戏都会立即采用新值；「恢复 100%」可以一次重置三路音轨。 基础音量是作者混音基准，单条 Sound Block 音量、玩家设置中的分类音量和主音量会继续叠加。超过 100% 时可能削波失真，建议只用于本身录制音量明显偏低的素材，并在成品设备上试听。

​

个性化

「项目设置 → 个性化」顶部提供「对话框」「段落」「光标」「选项」和「输入框」五个标签。对话框、段落和光标使用专用样式编辑器；选项和输入框会打开默认游戏壳中的可视化界面编辑器。

​

对话框样式

「对话框」标签先显示当前项目可以使用的样式：

• 默认游戏壳 → 预设：Studio 自带的 5 套样式；修改过的预设会标记「已编辑」；
• 默认游戏壳 → 用户自定义：当前项目新建或从预设创建副本的样式；
• 外部扩展：已安装扩展提供的对话框样式。

点击「设为默认」会改变游戏当前使用的样式；点击「编辑 UI」进入可视化编辑器。选择尚未加入项目或已经停用的扩展样式时，Studio 会先加入或启用它。扩展被移除、停用或缺失后，游戏会安全回退到内置样式。

​

在 UI 编辑器中调整

现代对话框样式将内容拆成独立图层： 对话框编辑模式仍可以添加文字、图片、按钮、矩形和表单控件，也可以添加「角色名」「对白文本」「对白头像框」三种专用智能组件。设计时可选择项目角色和表情预览头像，正式运行时会按当前对白自动替换。 角色名和对白文本支持文字描边；对白文本的正文区域还可以独立设置底色、边框颜色、边框宽度和圆角。 文档级「行为」设置用于调整逐字间隔、字符淡入和等待图标延迟。没有覆盖的项目继续沿用样式或引擎默认值。

​

等待指示器

在图层树中选择「等待提示」，属性面板会把指示器分为两组：

• 普通等待：对白文字显示完成、等待玩家推进时出现；可以使用经典样式、内置菱形/圆点/箭头或项目图片，并调整位置、偏移、尺寸、颜色和动画。
• 自动播放：游戏处于自动模式时出现；可以显示自定义文字、内置形状或项目图片，与普通等待分别保存。

自动播放选择「文字」时，可以调整文字内容、字号、字重、字距、颜色与光晕；选择形状或图片时，可以调整尺寸、颜色和呼吸、旋转、闪烁、弹跳等动画。 属性面板顶部的「预览模式」可以在「普通等待」与「自动播放」之间切换，只改变设计画布中的预览，不会开启游戏的自动播放，也不会修改当前剧情状态。

​

管理样式

• 点击「新建」创建空白自定义样式；
• 右键内置预设可以「创建副本」或「恢复预设原样」；
• 右键自定义样式可以重命名、设为默认或删除；
• 在剧本中使用切换对话框样式，可以在回忆、战斗等段落临时切换。

​

段落样式

「段落」标签控制整屏段落（书信、日记、新闻等长段剧情文字）的外观。段落样式是一份独立的可视化界面，与对话框样式互不影响：

• 默认游戏壳 → 预设：Studio 自带的 5 套段落样式；修改过的预设会标记「已编辑」；
• 默认游戏壳 → 用户自定义：当前项目新建或从预设创建副本的样式。

点击「设为默认」会改变游戏当前使用的段落样式；点击「编辑 UI」进入段落专用编辑器，编辑内容就是整屏段落本身，可以调整背景、遮罩、文字布局和已读句的淡出方式。

​

管理样式

• 点击「新建」创建空白自定义样式，创建后自动进入编辑器；
• 右键内置预设可以「创建副本」或「恢复预设原样」；
• 右键自定义样式可以重命名、设为默认或删除；删除当前正在使用的自定义样式后，游戏会回退到内置默认段落样式。

​

游戏光标

「光标」标签控制玩家在游戏画面里看到的鼠标样式。设置会立即反映到右侧实时预览和独立测试窗口，并随项目一起写入发布后的游戏。 预设区同时提供：

• 图片预设 Secret Letter、Moonlit Quill；
• CSS 预设 先锋指针、霓虹棱线；
• 当前项目保存的「我的设置」和「新建空白设置」。

每张预设卡片会标明「图片」或「CSS」。当前显示方式对应的预设可以直接应用，其他类型仍会保留展示。图片预设包含普通状态和带外缘泛光的可点击状态，并使用 2 倍像素素材适配 Retina 与高 DPI 屏幕。

​

显示方式

• 系统默认：沿用玩家设备上的系统光标。
• 自定义图片：从项目素材中选择图片，设置显示尺寸和点击热点。打开「为按钮和链接单独设置光标」后，可以分别配置普通状态与可点击状态。
• CSS 值：填写标准 cursor 属性值，也可以粘贴类似 cursor: crosshair; 的完整声明。CSS 模式同样支持为普通区域和可点击区域分别配置样式。

图片和 CSS url() 光标可以选择 16、24、27、32、48、64px 的常用正方形尺寸，也可以使用 8～128px 的自定义边长。新选图片默认是 24 × 24px；内置预设的泛光交互状态使用 27 × 27px，以保持主体视觉大小一致。 图片光标由游戏画面直接绘制，不受系统光标切换影响，运行时会同步换算显示尺寸和热点坐标。纯 crosshair、pointer 等系统关键字由操作系统绘制，因此不使用图片尺寸设置。 可以先应用内置预设再继续修改，然后通过「保存到我的设置」创建项目专属样式。保存后的图片与 CSS 设置支持应用、更新、重命名和删除，数据写入当前项目的 config/personalization/cursor-styles.json，不会影响其他项目。

​

选项与输入界面

「选项」和「输入框」标签分别提供默认游戏壳中「剧情选项」与「玩家输入」可视化界面的快捷入口。

​

剧情选项

剧情选项界面决定分支 Block 运行时的选项列表外观。点击「在 UI 编辑器中编辑」后，可以调整：

• 选项排列、间距、尺寸和编号；
• 框体、指示器、序号和正文四个模板图层；
• 各模板的常态、悬停、按下、禁用和焦点状态；
• 背景与选项图片；
• 进场、退场和错峰动画；
• 运行区域的尺寸和位置。

界面中的「选项列表」智能组件在设计时使用示例文案，运行时会自动替换为当前分支 Block 的真实选项，并把玩家选择映射回原分支序号。 四个模板会按运行时选项数量重复生成，因此只需设计一套。需要调整框体图片、指示器发光、编号规则或正文颜色时，直接在图层树中选择对应模板；详细参数见选项按钮模板。

​

玩家输入

玩家输入界面用于收集姓名、数值或自由文本。可以修改标题、说明、输入框、确认按钮、校验状态和进退场动画。 打开编辑器后，Studio 会为当前项目创建默认游戏壳界面的可编辑副本。修改只影响当前项目，并同时用于预览和发布版本；需要回到内置版本时，可以使用「恢复原始界面」。

​

输入按键

「项目设置 → 输入按键」用于调整推进对话、跳过、自动播放、隐藏对话框和重放语音等语义动作的按键。 扩展程序也可以注册自己的动作。动作注册后会出现在这里，项目创作者可以统一修改默认按键。开发方法见系统插槽与内置动作。

​

游戏系统

「项目设置 → 游戏系统」决定标题、对话工具栏、存档、读档、设置、历史、鉴赏、玩家输入和剧情选项实际由哪一份 UI 提供。 默认情况下，九个位置都由「默认游戏壳」实现。你可以把它们绑定到：

• 自己制作的可视化界面；
• 本地或工坊扩展提供的可视化界面；
• 声明支持对应插槽的程序 UI。

标题、对话工具栏、存档、读档、玩家输入和剧情选项属于必需位置。绑定失效时，引擎会回退到默认游戏壳。完整说明见默认游戏壳与系统界面。

​

扩展与界面

项目设置左侧第二级导航的下半部分是扩展树。扩展按「本项目」和「本机的其它扩展（全局）」分组显示，全局组的扩展点击「加入」即可加入当前项目，详见扩展工坊 · 安装后的管理。 扩展来源分三种，以行尾徽章区分：

• 内置：Studio 自带，不能停用或删除；
• 本地：自己新建或导入，可编辑、移动和删除；
• 工坊：从扩展工坊安装，只读，可按项目启用或停用。

每个扩展下会按能力显示「界面」和「程序」分组：

• 在「界面」中创建、复制和编辑可视化 UI；
• 在「程序」中查看 React 模块、剧本方法、设置和存档字段；
• 新扩展默认可以只做界面，需要写代码时再初始化程序。

​

项目发行物

项目启用一份本地或市场扩展后，Studio 会把扩展运行所需的内容保存为项目发行物。它会跟随项目一起保存，用于预览、构建和分享。 因此，把整个项目目录复制给其他人时，扩展提供的界面和功能也会一起带过去，对方不需要另外安装原扩展，也不需要拥有扩展源码。源码仍留在开发者自己的电脑上，不会被复制进项目。 项目发行物和本机源码是两份不同的内容：前者保证项目可以独立运行，后者用于继续编辑和开发扩展。扩展信息页会分别显示它们的状态。 扩展下的「界面」和「程序」分组可以分别折叠。管理本地扩展时注意两种删除操作：

• 从 Studio 移除：解除本机工作区关联，保留磁盘上的扩展源码；项目发行物可继续保证项目运行。
• 彻底删除：把本机源码移到系统废纸篓，并删除当前项目中的对应发行物和依赖关系。

彻底删除前先确认源码已提交或另有备份。工坊扩展使用卸载流程，内置扩展不能删除。 从可视化界面编辑器开始制作 UI；安装成品扩展见扩展工坊。