1. 简介
欢迎使用 VN Editor！这是一个为视觉小说创作者设计的编辑器。无论你是否有编程基础，都可以通过这个工具轻松地创建、编辑和管理你的视觉小说项目。
1.1 编辑器特点
- 零基础友好：无需编程知识
- 功能完整：支持立绘、背景、音乐、音效、变量系统
- AI助力：集成AI功能，帮助生成剧情和对话
- 导出便捷：一键导出Cradle APP可直接运行的游戏，无需额外配置
1.3 CradleAI 项目
本编辑器导出的视觉小说需要在 CradleAI APP 导入和运行。需要自己在Cradle APP进行API设置.推荐模型为gemini-2.5-pro；其他模型尚未测试过效果
1.4 教程导读
本教程共分为9个部分，建议按顺序学习：
- 简介：了解编辑器基本概念
- 快速上手：学会启动和创建项目
- 仪表盘：熟悉主界面布局
- 变量配置：设置游戏数据和逻辑
- 提示词配置：配置AI助手
- 资源管理：添加图片和音频文件
- 场景编辑：编写游戏剧情
- 样式编辑：美化游戏界面
- 导出项目：生成最终游戏
建议你先通读一遍整个教程，然后边学边练，在实际操作中加深理解。
2. 快速上手
2.1 界面介绍
编辑器启动后，你会看到一个现代化的深色界面。主要包含以下部分：
- 顶部标题：显示"Visual Novel Editor"
- 功能卡片：包含各个编辑模块的入口
- 项目状态：显示当前项目的配置情况
- 导入导出：项目管理功能
2.2 创建第一个项目
在首页新建游戏，输入游戏名称和描述
2.4 保存机制
编辑器采用自动保存机制：
- 所有配置会自动保存到浏览器的本地存储中
- 刷新页面不会丢失数据
- 但清除浏览器数据会丢失项目
- 建议定期使用"导出项目"功能备份
3. 仪表盘
仪表盘（Dashboard）是编辑器的控制中心，提供了项目概览和各功能模块的快速入口。
3.1 界面布局
仪表盘采用卡片式布局，主要包含以下功能卡片：
功能模块卡片
- 📊 变量配置：创建游戏变量，例如角色好感度等数据
- 💬 提示词配置：设置AI的提示词
- 🎨 资源管理：上传和管理立绘、背景、音效等资源
- 📝 场景编辑：编写游戏开局场景和选项分支
- 🎭 样式编辑：自定义游戏界面的视觉样式
项目管理卡片
- 📁 项目导入：从ZIP文件导入项目配置
- 🖼️ 剧本封面：上传游戏封面图片
- 📦 项目导出：导出完整项目或生成二维码
- 📋 当前项目状态：查看各模块的配置情况
3.2 项目状态监控
"当前项目状态"卡片能帮你快速了解项目进度：
- 变量：显示已定义的变量数量
- 提示词：显示已配置的提示词数量
- 资源：显示已上传的资源总数
- 样式：显示是否已配置自定义样式
- 场景：显示是否已编写开场场景
点击"刷新状态"按钮可以更新这些统计信息。
3.3 使用建议
建议按照以下顺序使用各个功能模块：
- 变量配置：首先定义游戏需要的变量
- 资源管理：上传图片和音频文件
- 场景编辑：编写游戏剧情
- 样式编辑：美化界面（可选）
- 提示词配置：配置AI提示词
- 项目导出：导出Cradle可运行的游戏
4. 变量配置
变量是视觉小说游戏的"记忆系统"，你可以用它来存储和追踪你需要的数据。
这些数据会由AI自己维护，只需要你定义名称/规则即可。
4.1 什么是变量？
在视觉小说中，变量主要用于：
- 角色好感度：记录玩家与不同角色的关系
- 玩家属性：如姓名、年龄、职业等
- 游戏进度：如章节进度、解锁内容等
- 物品道具：如金钱数量、拥有的物品等
- 剧情分支：记录玩家的选择，影响后续剧情
4.2 变量类型
编辑器支持以下几种数据类型：
字符串（String）
用于存储文本信息，如玩家姓名、对话内容等：
"playerName": "小明" "currentLocation": "图书馆"
数字（Number）
用于存储数值，如好感度、金钱、分数等：
"favorability": 50 "money": 1000 "score": 0
布尔值（Boolean）
用于存储是/否状态，如任务完成、物品获得等：
"hasKey": false "questCompleted": true "firstMeeting": false
数组（Array）
用于存储多个相关的值：
"inventory": ["钥匙", "地图", "药水"] "visitedPlaces": ["图书馆", "咖啡厅"]
对象（Object）
用于存储复杂的结构化数据：
"character": {
"name": "小樱",
"age": 18,
"favorability": 50
}
4.4 操作指南
添加变量
- 点击仪表盘的"📊 变量配置"卡片
- 在变量编辑器中点击"添加变量"按钮
- 填写变量信息：
- 变量名：英文标识符，如 playerName
- 显示名称：中文名称，如"玩家姓名"
- 类型：选择合适的数据类型
- 初始值：设置变量的默认值
- 点击"保存"确认
编辑变量
点击已有变量的"编辑"按钮，可以修改变量的所有属性。
删除变量
点击变量的"删除"按钮。注意：删除变量可能影响已编写的剧情逻辑。
4.5 使用技巧
- 使用有意义的英文名称，如 sakuraFavorability 而不是 var1，因为前者更有利于AI读懂
- 先规划好游戏需要哪些变量再开始配置
- 为每个变量写清楚描述
- 好感度通常设置为0-100的数字
- 设置合理的初始值
- 变量名不能包含中文或特殊符号
5. 提示词配置
提示词配置非常关键，它和变量系统必须一起使用。
例如在之前创建了一个好感度变量叫goodwill_sakura，那么在提示词中输入${goodwill_sakura}，它就会被替换为好感度值
和变量系统一起使用，提示词可以用来：
- 定义角色：写每个角色的人设信息
- 约束回复风格：控制AI的语言风格和表达方式。但是不要让AI输出状态栏，会和已有格式冲突。
- 提供世界观
6. 资源管理
资源管理是创建视觉小说的重要环节，包括角色立绘、背景图片、背景音乐和音效的管理。
6.1 资源类型
🎭 角色立绘（Sprites）
角色立绘是游戏中角色的视觉表现，通常包含多种表情和姿态：
- 建议格式：PNG（必须透明背景）
- 建议尺寸：宽度400-800像素，高度800-1200像素
- 命名规范：角色名-表情，如"小樱-微笑"、"小樱-害羞"
🖼️ 背景图片（Backgrounds）
背景图片设定游戏场景的氛围：
- 建议格式：JPG或PNG
- 建议尺寸：1920x1080（竖9:16比例）
6.2 资源上传
上传步骤
- 提前在 https://catbox.moe/ 上传立绘/背景图片，并记录自动创建的地址
- 点击仪表盘的"🎨 资源管理"卡片
- 在立绘/背景界面输入catbox的链接即可
6.3 资源管理技巧
- 使用统一的命名规范：必须用`角色-状态`和`时段-背景`的格式来命名资源
6.4 版权注意事项
- 确保所有资源都有使用权限
- 避免使用有版权争议的素材
- 推荐使用免费素材网站的资源
- 商业发布时务必检查版权授权
7. 场景编辑
你可以在这里创建开局的场景，通过各种场景语法来进行角色对话，立绘，背景的切换，这些开局场景会作为AI的参考来生成后续，所以要注意精心设计，和酒馆的开场白一样重要。
改变背景：changeBg:xx.bg
改变立绘：changeFigure:xx.sprite
一般对话（角色名可为`旁白`或创建的角色）：角色名:(对白内容)
8. 样式编辑
你可以在“样式编辑”页面通过滑块来自定义游戏界面的外观，比如对话框的样式、按钮的颜色、文字的字体和大小等。
9. 导出项目
可以在左侧导航栏，或者项目首页，点击“导出”按钮。
在Cradle APP扫码扫入创建的项目，或者导入ZIP文件。