【开发教程】Ren’Py 从零开始使用教程

Ren\’Py 是一款专为视觉小说（Visual Novel）设计的免费开源游戏引擎，零基础也能快速上手。它采用类似电影脚本的语法，被广泛应用于《心跳文学部！》《ATRI -My Dear Moments-》等知名作品的开发。本教程将带你从零开始，完成第一个 Ren\’Py 游戏的制作与打包。

一、下载与安装

1. 下载 Ren\’Py

访问 Ren\’Py 官网下载页面：https://www.renpy.org/latest.html

选择适合你操作系统的版本：

• Windows：下载 .exe 可执行文件

• macOS：下载驱动器镜像（.dmg）

• Linux：下载 .tar.bz2 压缩包

2. 安装与启动

Windows 平台：双击下载的可执行文件，它会自动解压到名为 renpy-<版本号> 的文件夹。进入该文件夹，运行 renpy.exe。

macOS 平台：双击下载的驱动器镜像挂载为驱动器，将 renpy-<版本号> 文件夹复制到任意位置（注意：不能是只读驱动器），然后运行 renpy 程序。

Linux 平台：解压 tar 包，进入 renpy-<版本号> 目录，运行 renpy.sh。

3. 切换为中文界面

首次启动时启动器默认使用英文。点击右下角的 “preferences”（偏好设置），将 “Language” 修改为 “Simplified Chinese”，即可切换为简体中文界面。

二、创建你的第一个项目

1. 创建新项目

在启动器界面点击 “创建新项目”。如果是第一次创建，Ren\’Py 会要求你选择一个项目目录——这个文件夹将用来存放所有项目。

接着输入项目名称（例如 “My First Visual Novel”），然后选择项目分辨率。默认的 1280×720 是个良好的折中方案。之后选择颜色主题（随意选择即可）。

完成后，Ren\’Py 会自动生成一个可运行的简单游戏模板。

2. 运行项目

在启动器中选中你的项目，点击 “启动项目”，即可预览游戏效果。

三、编写游戏脚本

Ren\’Py 的游戏脚本存放在项目文件夹的 game/ 目录下，所有以 .rpy 为扩展名的文件都是脚本文件。

1. 打开脚本文件

用文本编辑器（如 VS Code、Sublime Text 或系统自带的记事本）打开 game/ 文件夹下的 script.rpy 文件。

2. 脚本基本结构

一个最简单的 Ren\’Py 脚本如下：

label start:

    scene bg room

    \"你好，这是我做的第一个视觉小说！\"

    show eileen happy

    \"主角出现了，她看起来很开心。\"

    return

3. 核心语法说明

角色定义

使用 define 语句定义角色，让对话更简洁：

define e = Character(\"艾琳\")
define s = Character(\"我\")

对话（Say 语句）

直接使用角色名加引号即可显示对话：

e \"你好！今天过得怎么样？\"
s \"挺好的……\"

显示图像

• scene：清除所有图像并显示背景

• show：在现有画面上显示角色图像

• hide：隐藏指定的图像

scene bg room          # 显示背景
show eileen happy      # 显示角色
hide eileen            # 隐藏角色

菜单与分支

使用 menu 语句创建选项分支：

menu:
    \"和她一起回家\":
        jump home_together
    \"独自回家\":
        jump home_alone

标签与跳转

• label：定义一个位置标记

• jump：跳转到指定的标签

• return：结束游戏或返回上级标签

label home_together:
    e \"我们一起走吧！\"
    return

转场效果

使用 with 语句添加转场效果：

scene bg room with dissolve    # 淡入淡出效果
show eileen happy with fade    # 渐变效果

四、测试与调试

1. 运行测试

在启动器中选中项目，点击 “启动项目” 即可运行游戏。运行时会打开一个控制台窗口，如果脚本有错误，会在这里显示具体的报错信息。

2. 常见错误排查

• 缩进错误：Ren\’Py 对缩进非常敏感，确保使用一致的缩进（建议 4 个空格）

• 文件路径错误：图像文件需放在 game/ 目录下，并在脚本中使用正确的文件名

• 标签重复：同一个项目中 label 的名称必须唯一

五、打包发布

1. 打包为 PC 版本

在启动器中选中项目，点击 “构建分发版本”。在弹出的窗口中勾选需要发布的平台（Windows、macOS、Linux 等），然后点击 “构建”。

等待构建完成，打包文件会生成在项目文件夹下的 项目名-1.0-dist/ 目录中。

2. 打包为移动端版本

Android：在启动器中点击 “Android” → “安装 SDK” → “生成密钥” → “配置项目”，完成后再点击 “构建 Android 应用”。

iOS：需要 macOS 系统和 Xcode，具体步骤可参考官方文档。

3. 构建配置（进阶）

高级开发者可以通过 options.rpy 文件中的 build.classify 函数自定义打包规则，控制哪些文件被包含在发行包中。

六、学习资源推荐

Ren\’Py 采用 MIT 许可证开源，可免费用于商业及非商业目的。祝你创作愉快！