Live2D and 3D stage

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

• Know the setup requirements for Live2D projects.
• Keep platform support and Web export constraints visible.
• Treat 3D stage features as advanced runtime work.

Core syntax

• Live2D
• Cubism
• Model3D
• camera
• renpy.variant

Runnable example

image hiyori = Live2D("live2d/hiyori", base=1.0, loop=True)

label start:
    show hiyori
    "她在动！"
    show hiyori idle        # 播放名为 idle 的动作/表情

Study outline

• Start with the smallest example for live2d and 3d stage.
• Test the key terms in a clean Ren'Py project: Live2D, Cubism, Model3D, camera.
• 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 official reference: https://www.renpy.org/doc/html/live2d.html
• Ren'Py official reference: https://www.renpy.org/doc/html/3dstage.html

How this fits in GenPy

• Use GenPy to manage script, asset, and export context while testing advanced runtime features in Ren'Py itself.
• Document platform limitations before release.

Recommended GenPy docs:

• Export and download
• Export and download
• Desktop App