Ren'Py 入门与项目创建
认识 Ren'Py 视觉小说引擎的定位版本与许可证，完成安装并创建第一个可运行的项目
想讲一个由文字、图像与声音交织而成、还能让读者做出选择的故事吗？Ren’Py 就是为此而生的引擎：它开源免费、可以商用，自带的脚本语言简单到零基础的创作者也能快速上手，同时又内嵌 Python，足以支撑复杂的模拟玩法。本篇带你认识 Ren’Py 的定位、版本与许可证，完成下载安装，并创建出第一个可以点击运行的项目，为后面编写剧本打好地基。
学习目标
- 说清 Ren’Py 的定位：视觉小说引擎（visual novel engine），以及它除了视觉小说还能做什么；
- 了解最新发行版 8.5.3，以及 8.4 与 8.5 两个版本线的主要新特性；
- 准确理解 Ren’Py 的许可证构成，知道分发游戏时需要满足 LGPL 要求；
- 在 Windows、macOS 或 Linux 上完成安装并启动 Launcher；
- 试玩两个官方示例项目 The Question 与 Tutorial；
- 用 Launcher 创建一个新项目，认识项目目录中每个文件夹与文件的作用。
Ren’Py 是什么
官方对它的定义只有一句话：“Ren’Py is a visual novel engine”，即 Ren’Py 是一个视觉小说引擎（visual novel engine）。它被全球数千名创作者使用，帮助创作者用文字、图像和声音讲述可交互的故事，作品可以运行在电脑与移动设备上。
“视觉小说”这个名字容易让人以为它只能做一种游戏，其实不然：Ren’Py 既能制作传统的视觉小说（visual novel，以对话文本推进的图文故事），也能制作人生模拟类游戏。这背后是两套能力的配合：
- 脚本语言：Ren’Py 自带一套非常易学的脚本语言，任何人都能高效编写大型视觉小说。写一段对话只需一行文本，写一个选项只需几行缩进块，完全不需要先系统学完一门编程语言。
- 内嵌 Python：脚本中可以直接使用 Python，其能力足以支撑复杂的模拟游戏。引擎本体也是用 Python 编写的，自 8.4 版起所有平台使用 Python 3.12。
对零基础的学习者来说，这意味着一条平滑的上升曲线：最初你只需写对话，之后按需逐步引入变量、条件、界面与动画，而不必一上来就面对完整的编程环境。
开源、免费与许可证
Ren’Py 是开源软件（open source software），免费用于商业用途——你可以用它做游戏并上架收费，不需要向引擎作者支付分成或授权费。
许可证（license）方面有两点需要准确理解：
- Ren’Py 的大部分代码采用 MIT 许可证（MIT License），这部分非常宽松；
- 另有一部分代码源自 GNU LGPL，因此用 Ren’Py 制作的游戏在分发时必须满足 LGPL 的要求。发布游戏前建议通读一遍官方许可证文档，确认自己的分发方式合规。
此外，Ren’Py 的二进制包还捆绑了若干第三方组件（如 ANGLE、FFmpeg、Freetype 等），它们各有各的许可证。日常使用无需操心，但如果你在做合规审查，可以逐项核对。
版本：8.4 与 8.5 带来了什么
截至本文写作时，最新的官方发行版是 8.5.3（2026 年 5 月发布）。从 8.4.0（2025 年 7 月发布）起，Ren’Py 不再维护与 8.x 配对的旧 7.x 版本线，新项目直接从 8.x 开始即可。
8.4 版本的主要新特性包括：
- 升级到 Python 3.12，报错信息可以定位到行内的具体子表达式，排查语法错误更方便；
- 大型项目的脚本加载时间减少约一半，游戏体量越大越能感受到差别；
- 新增 GLTF 模型加载（GLTFModel displayable）；
- 新增 Traceback Saves：脚本抛出异常时自动保存一个 _tracesave 存档槽，方便开发期回溯现场；
- 新增 libs 与 mods 目录约定（即 game/libs 与 game/mods）。
8.5 版本的主要新特性包括：
- Web 平台支持 Live2D；
- 引入自动化测试框架，可以为游戏编写测试；
- 支持 WOFF2 字体格式；
- 局部标签（local label）的声明规则放宽。
初学者不必逐条研究这些特性，先记住一个原则：直接使用最新版。等具体功能用到时，再回头查官方文档即可。
支持的平台
Ren’Py 制作的作品可以发布到相当广的平台：
Windows 10+
Mac OS X 10.10+
Linux（x86_64 与 ARM）
Android 5.0+
iOS 11+
HTML5/WebAssembly（Web 版，目前为 Beta）同一份剧本，稍加配置就能同时面向桌面、手机与浏览器玩家发布，这是 Ren’Py 相对许多同类工具的一大优势。
安装并启动 Launcher
安装过程在不同系统上略有差异：
- Windows：从官网下载后双击可执行文件，会解压出一个 renpy-<版本号> 文件夹，运行其中的 renpy.exe 即可；
- macOS：挂载下载的磁盘镜像后，把整个文件夹复制到电脑上的其他位置，再运行它，不要直接在镜像里运行；
- Linux：解压 tarball 后运行 renpy.sh。
启动后看到的就是 Launcher（启动器）。它是你创建项目、编辑脚本、试玩运行与打包发布的中枢，以后几乎所有操作都从这里出发。Launcher 支持多语言界面：点击窗口右下角的 preferences 即可切换语言，中文界面可以降低不少上手门槛。
先玩两个官方示例
在动笔写代码之前，建议先玩一遍 Launcher 首屏提供的两个官方示例项目：
- The Question：一个几分钟就能通关的微型视觉小说，展示了对话、选项、图像与结局的完整骨架；
- Tutorial：官方交互式教程，边玩边讲，覆盖脚本语言与常用功能。
在 Launcher 中选中示例项目，点击 “Launch Project” 即可预览。玩的时候不妨留意三件事：什么时候出现选项、画面如何切换、以及能不能用鼠标滚轮回看上文（这个功能叫回滚，rollback）。这些行为你很快就能亲手写出来。
创建第一个项目
点击 Launcher 首屏的 “Create New Project”，按向导走四步：
- 选择项目目录：Ren’Py 会把你的所有项目放在同一个目录下统一管理；
- 输入项目名；
- 选择分辨率（resolution）：官方建议 1280x720，这是画质与文件体积之间的良好折中；
- 选择配色方案（color scheme）：决定界面与对话框的配色基调。
完成后 Ren’Py 会生成一个立即可运行的模板项目：它自带占位图片素材，并且已经内置了回滚、存档与读档功能。这些通常需要开发者自己实现的”基础设施”，Ren’Py 全部白送。点击 “Launch Project” 就能玩到自己空白的第一个场景。
认识项目目录结构
打开项目文件夹，你会看到一套固定的组织方式：
game/
audio/ 音频文件
cache/ 缓存，勿编辑
gui/ 界面（GUI）用图
images/ 图片素材
tl/ 翻译文件
gui.rpy 界面变量
options.rpy 项目配置与构建变量
screens.rpy 界面定义
script.rpy 剧本脚本逐个说明：
- script.rpy 是你的剧本入口，但 Ren’Py 并不要求把所有内容写在这一个文件里——你可以随意增删任何 .rpy 文件，引擎会把它们合并看待。体量上来之后，按章节拆分成多个文件是好习惯。
- options.rpy 保存项目配置与构建（打包）变量；gui.rpy 保存界面变量；screens.rpy 定义界面。前期你主要和 script.rpy 打交道，其余文件认识即可。
- audio/ 用来放音频，images/ 用来放图片，gui/ 放界面用图，tl/ 放翻译文件；cache/ 是引擎的缓存目录，请勿编辑。
- 你可能还会看到 .rpyc 文件（例如 script.rpyc）。它们是 Ren’Py 从 .rpy 编译出来的产物，请勿手动编辑，也不要删除。
- .rpy 文件的命名有一个禁区：文件名不能以 00 开头，这个前缀保留给 Ren’Py 自己的文件使用。另外从 8.5.0 起，以点开头的 .rpy 文件不再被加载。
选择编辑器
在 Launcher 中选中项目后，在 “Edit File” 下方选择 script.rpy，Launcher 会调用编辑器打开它。第一次编辑时 Ren’Py 会要求你选择一个编辑器（editor），官方推荐 Visual Studio Code。选好之后，以后每次从 Launcher 点开脚本都会直接进入你熟悉的编辑器。
首周常见坑：安装与第一次运行
下面五个坑在零基础创作者中出现频率最高，先认识它们，遇到时就能直接对号入座：
- 项目路径含中文或空格。 把项目建在「桌面/我的 作品」这类路径下，轻则 Launcher 预览异常，重则打包时构建失败。修正：所有 Ren’Py 项目统一放在一个纯英文、无空格、不带特殊符号的路径下（如
D:/renpy-projects/），这条纪律同样适用于后续的素材文件名。 - 杀毒软件误报。 Ren’Py 的可执行文件偶尔被 Windows Defender 或国产杀软标记，玩家侧也会有同样困扰（发布篇会再谈）。开发期处理：把 renpy 安装目录与项目目录加入白名单；发布后若玩家反馈误报，关注官方版本的签名更新情况即可，不要自行「改壳」重新打包。
- 缩进混用导致解析错误。 Ren’Py 脚本用缩进表达块结构（官方风格是 4 个空格），Tab 与空格混用会直接报
expected statement或缩进不一致的解析错误——这是新手报错榜第一名。修正：在编辑器设置里把 Ren’Py 文件的缩进固定为「Tab 转空格、宽度 4」，报错时第一眼看报错行上下的缩进。 - 删了 .rpyc「清理垃圾」。 .rpyc 是编译产物但并不总是垃圾：它保存着标签与语句的位置信息（存档兼容正依赖它，见打包发布篇）。手动删除后引擎会重新编译，看似无事，但如果你已经发过带存档的版本，旧存档会找不到原来的语句位置。修正：.rpyc 一律不删不碰，交给引擎管理。
- 把 1280x720 当成”过时分辨率”。 有人一步到位选 1920x1080，结果素材体积、显存占用、Web 版性能全线承压。官方推荐 720p 是有理由的：视觉小说的文本可读性在 720p 下已经足够，独立创作的素材产能也更友好。想清楚再改，而不是默认”越大越好”。
这五条都写进第一周的检查动作里，比事后排错省一个晚上的时间。
动手实践
以下三个任务按顺序做，合计约 90 分钟，全部产物会沉淀成你后续 12 篇练习的工作目录。
任务一：安装、切换中文界面并创建项目（约 20 分钟）
按本文流程完成安装，把 Launcher 切成中文，以 1280x720 创建一个名为 my-first-vn 的项目。创建完成后在文件管理器里找到项目文件夹，对照「项目目录结构」一节把每个文件与目录的职责各用一句话写进笔记。
参考检查点：能说出 script.rpy（剧本）、options.rpy（配置与构建）、screens.rpy（界面定义）三个文件的分工；能指出 cache/ 为什么不能编辑。
任务二：玩 The Question 并拆解它的第一场戏（约 30 分钟）
运行 The Question 玩到第一个选项为止，然后用编辑器打开它的 script.rpy，找出对应这段流程的脚本行：开场 define 语句、第一句 say 语句、第一个 menu 块。给每行加中文注释说明它的作用。
参考方向（不要照抄，按你找到的行写）：define 行创建了一个带名字与颜色的 Character 对象；say 语句就是「角色名 + 缩进的台词文本」；menu 块由 menu 关键字、若干选项子块与每个选项下的跳转组成。拆解完你会发现「视觉小说脚本」的每个运行时行为都能对应到一行你能读懂的代码——这个”行为到代码”的翻译练习，是后面 12 篇一切学习的母技能。
任务三：改坏一次，再修好（约 20 分钟）
在 my-first-vn 的 script.rpy 里，把某句台词的缩进多加 4 个空格，保存后从 Launcher 运行，读一遍报错信息；然后把缩进改回去，确认恢复正常。接着把项目文件夹临时改名为含空格的名字，观察 Launcher 的反应，再改回纯英文名。
参考检查点：能复述报错信息里指出的行号与问题类型；能说出「报错行号 + 上下缩进」是解析类报错的第一排查位。故意制造一次错误再修复，是记忆最深的排错教学——比一次都不出错强得多。
小结
- Ren’Py 是开源免费、可商用的视觉小说引擎，也能胜任人生模拟类游戏；脚本语言易学，自 8.4 起全平台内嵌 Python 3.12。
- 许可证以 MIT 为主，但包含源自 LGPL 的代码，分发游戏时须满足 LGPL 要求；捆绑的第三方组件另有各自的许可证。
- 最新发行版为 8.5.3（2026 年 5 月）；8.4 带来 Python 3.12、脚本加载提速约一半、GLTF、Traceback Saves 与 libs/mods 目录，8.5 带来 Web 端 Live2D、自动化测试框架与 WOFF2 字体。
- 作品可发布到 Windows 10+、macOS 10.10+、Linux、Android 5.0+、iOS 11+ 与 Web（Beta）。
- 安装后一切操作围绕 Launcher 展开；先玩 The Question 与 Tutorial，再以 1280x720 分辨率创建新项目。
- 项目由 audio/、gui/、images/、tl/ 等目录与 options.rpy、gui.rpy、screens.rpy、script.rpy 等文件组成；.rpyc 是编译产物勿手改，.rpy 文件名不能以 00 开头。