快速开始

环境准备

推荐 Node.js 22 LTS 的最新补丁版，使用 pnpm。仓库固定 pnpm 12.3.4。源码开发中的类型剥离命令需要 Node.js 22.6+；本文文档站的 Vite 8 需要 Node.js 20.19+ 或 22.12+。

Bash
node --versionpnpm --version

创建项目

Bash
pnpm create qua-game my-storycd my-storypnpm installpnpm run project:validatepnpm run project:doctorpnpm dev

默认模板是 visual-novel-vue，包含引擎、Vue 渲染器、QuaScript 编译、开发资源加载与构建配置。浏览器地址以终端输出为准。

模板已经接好了必要的入口。首次预览会进入示例对白；点击或使用输入插件提供的推进操作，检查故事能否继续。创建失败时先确认注册表可访问以及当前版本的 create-qua-game 可用。

找到要修改的文件

确认项目可以构建

Bash
pnpm typecheckpnpm run assets:buildpnpm build

模板图标是 QuaEngine 品牌的开发占位图。发布自己的作品前，应替换成你有权使用的游戏素材，并检查 qua.project.yaml 的图标路径。

接下来阅读 第一幕。如果你希望先体验已有故事，可以 运行仓库 Demo。