快速入门
欢迎使用¶
你好！欢迎使用Raven引擎。 每个视觉小说创作者都可以免费且开放的使用Raven引擎。
这个页面是一个快速入门的教程 按照这个页面的教程可以快速的建立一个Raven视觉小说程序。
提示
为了很快的帮助用户上手，此文档使用的开发模式为🌞模式
安装Cli¶
Raven为开发者准备了脚手架程序，可以快速的构建一个项目模板。
首先在 Github release 下载脚手架程序。
必要的文件¶
在🌞剧本模式下，程序分为如下的结构
| 层级 | 名称 | 职责描述 | 功能细节 |
|---|---|---|---|
| 数据驱动层 | dialogue.yaml | 内容+流程的完整数据结构 | • 存储对话内容 • 包含页面跳转逻辑 • 类似于配置文件或脚本引擎 |
| 资源路由层 | main.yaml | 资源路径的解释 | • 解释和执行dialogue中定义的路径 • 解释程序资源的位置 |
| 渲染层 | style.yaml | 纯粹的视觉表现 | • 负责UI渲染和视觉效果 • 不涉及任何业务逻辑 • 专注于"如何呈现" |
架构特点：
- 数据驱动：dialogue既是内容也是逻辑的载体
- 解耦设计：三层职责明确，依赖关系清晰
- 内容导向：适合剧情的频繁修改
开发模式¶
🌞剧情模式的开发其实就是按照我们的三段式架构设计，剧情开发可以用一句话总结：
把规定的文件放在规定的位置，然后填充好复合语法规定的数据内容
最小系统构建¶
Raven引擎的主程序做了很好的容错处理，实际上，因为有默认样式的存在，一个最小的Raven项目只需要如下的文件:
raven-visual-novel/
│
├── raven.exe # 核心执行引擎
│
└── assets/ # 资源文件夹
├── main.yaml # 主配置文件
├── dialogues.yaml # 对话和剧情数据
└── font/ # 字体文件