Quickstart and installation

This page is part of the GenPy Ren'Py learning path. It focuses on practical Ren'Py 8.x production and links each concept back to the GenPy workflow.

Learning goals

• Install the Ren'Py SDK and open the launcher.
• Understand the default project structure under game/.
• Run a minimal label start script and test it in the launcher.

Core syntax

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

Runnable example

# 定义角色
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

Study outline

• Start with the smallest example for quickstart and installation.
• Test the key terms in a clean Ren'Py project: label start, define Character, scene, show.
• Move the pattern back into your real project only after the example runs.
• Use GenPy docs and validation to keep the feature connected to story, assets, and export readiness.

Common pitfalls

• Test the smallest working script before layering on visual or UI complexity.
• Run Ren'Py Lint before release builds, even when the script appears to run locally.
• Keep examples in standard .rpy files so they remain editable outside GenPy.

Official references

• Ren'Py Quickstart: https://www.renpy.org/doc/html/quickstart.html
• Ren'Py official reference: https://www.renpy.org/doc/html/launcher.html

How this fits in GenPy

• Use GenPy as the project-aware workspace after you understand the SDK basics.
• Use Code mode for .rpy text, Validation before export, and Export when you are ready to test in Ren'Py.

Recommended GenPy docs:

• Getting started
• Code editor
• Export and download