快速入门与安装

本页属于 GenPy Ren'Py 学习路线。教程内容面向 Ren'Py 8.x，并在页面末尾连接到 GenPy 的对应工作流。

学习目标

• 了解“快速入门与安装”在 Ren'Py 项目中的用途。
• 能在一个最小项目里验证本章相关语法或工作流。
• 知道发布前需要检查的常见风险，并能在 GenPy 中继续维护。

核心语法

• label start
• define Character
• scene
• show
• menu
• return

可运行示例

# 定义角色
define e = Character("艾琳", color="#c8ffc8")

# 游戏从 start 开始
label start:

    # 显示背景（需要 game/images/bg room.png）
    scene bg room

    # 显示立绘
    show eileen happy

    "这是旁白：没有名字框的文字。"

    e "你好，这是我的第一个 Ren'Py 游戏！"

    e "点击继续，故事就会向下推进。"

    # 一个简单选择
    menu:
        "要继续吗？"
        "继续":
            e "我们继续吧！"
        "结束":
            e "那就到这里。"

    "（游戏结束）"

    return

教程正文

1. 下载与安装

1. 打开 Ren'Py 下载页面，下载对应平台（Windows / macOS / Linux）的 SDK。
   • 本教程示例以 Ren'Py 8.5.3（2026-05）为基准。8.x 基于 Python 3，推荐新项目使用。
   • 旧的 7.x 基于 Python 2，仅在维护老项目时使用；同一份脚本通常可在 7/8 间共享。
2. 解压到一个纯英文、无空格的路径（例如 D:\renpy-8.5.3）。
3. 运行解压目录中的可执行文件启动 启动器（Launcher）：
   • Windows：renpy.exe
   • macOS：renpy.app（或终端 ./renpy.sh）
   • Linux：renpy.sh

提示：Ren'Py 自带 Python，无需另外安装。文本编辑器推荐随启动器一键安装的 Visual Studio Code 或 Atom/Editra，会自带 .rpy 语法高亮。

2. 启动器界面

启动器是开发主控台，常用功能：

• Create New Project：新建项目，选择分辨率（默认 1280×720）、配色、UI 主题。
• 项目列表：选中后可以：
  • Launch Project：运行游戏。
  • Script Files / Open Directory：打开脚本或项目文件夹。
  • Navigate Script：在 label/screen 间快速跳转。
  • Check Script (Lint)：静态检查脚本错误，发布前务必跑一次。
  • Build Distributions：打包发布。
  • Generate Translations：生成翻译模板。
  • Images / Phone（开发者工具）等。

3. 项目目录结构

新建项目后，目录大致如下：

MyGame/
├── game/
│   ├── script.rpy          # 主脚本，游戏从 label start 开始
│   ├── options.rpy         # 配置：游戏名、分辨率、音量、构建设置
│   ├── gui.rpy             # GUI 外观变量（颜色、字体、尺寸）
│   ├── screens.rpy         # 内置界面（对话框、主菜单、存档界面…）
│   ├── images/             # 放置图片资源（背景、立绘）
│   ├── audio/              # 放置音乐与音效
│   └── ...                 # 你自己的 .rpy 脚本
├── 各平台 SDK 文件...

• game/ 是游戏内容目录，所有 .rpy、图片、音频都放这里。
• 启动时引擎会编译所有 .rpy 为 .rpyc（字节码），编译产物可忽略。
• 游戏入口固定是 label start:。

4. 第一个可运行脚本

把下面内容写入 game/script.rpy（覆盖示例内容）：

# 定义角色
define e = Character("艾琳", color="#c8ffc8")

# 游戏从 start 开始
label start:

    # 显示背景（需要 game/images/bg room.png）
    scene bg room

    # 显示立绘
    show eileen happy

    "这是旁白：没有名字框的文字。"

    e "你好，这是我的第一个 Ren'Py 游戏！"

    e "点击继续，故事就会向下推进。"

    # 一个简单选择
    menu:
        "要继续吗？"
        "继续":
            e "我们继续吧！"
        "结束":
            e "那就到这里。"

    "（游戏结束）"

    return

保存后回到启动器点 Launch Project 即可运行。没有对应图片时，Ren'Py 会用占位图，不影响逻辑测试。

5. 常用快捷键（运行时）

按键	作用
鼠标左键 / 回车 / 空格	推进对话
鼠标滚轮上 / Page Up	回退（rollback）
Ctrl（按住）	快进已读文本
Tab	切换自动前进
S	截图（保存到项目目录）
Shift+R	重新加载脚本（开发期热重载，超实用）
Shift+D	打开开发者菜单
H	隐藏界面查看画面
Esc / 右键	打开游戏菜单

Shift+R 热重载：修改脚本后无需重启，按 Shift+R 即可在当前位置重新载入，开发效率极高。

常见坑

• 路径含中文或空格可能导致部分平台报错，SDK 解压路径尽量用纯英文。
• 每次发布前先 Check Script (Lint)，能查出未定义跳转、死路 label、图片缺失等问题。
• .rpy 用空格缩进（通常 4 个空格），不要混用 Tab。
• 改了 options.rpy/gui.rpy 后建议完全重启游戏，而非仅热重载。

官方参考

• 快速上手：https://www.renpy.org/doc/html/quickstart.html
• 启动器：https://www.renpy.org/doc/html/launcher.html

在 GenPy 里怎么做

• 在 GenPy 的代码模式中维护相关 .rpy 文件，先保持语法清晰，再逐步加入本章功能。
• 用故事图谱、变量、校验或演出编辑器把“能运行”提升到“可维护”。
• 导出前结合 Ren'Py Lint 和 GenPy 校验结果，确认脚本、素材和发布路径一致。

推荐继续阅读：

• 快速开始
• 代码模式
• 导出与下载