Particles and weather effects

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

• Use built-in effects before custom particle systems.
• Keep weather layers separate from story logic.
• Measure performance on target platforms.

Core syntax

• SnowBlossom
• SpriteManager
• particles
• weather layer
• performance

Runnable example

image snow = SnowBlossom("fx/snow.png", count=100)

label start:
    scene bg night
    show snow                 # 直接显示，雪花持续飘落
    "下雪了……"
    hide snow

Study outline

• Start with the smallest example for particles and weather effects.
• Test the key terms in a clean Ren'Py project: SnowBlossom, SpriteManager, particles, weather layer.
• 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/sprites.html

How this fits in GenPy

• Use Performance Editor to decide where weather belongs in a scene.
• Use local preview for GPU and platform performance checks.

Recommended GenPy docs:

• Performance Editor
• Export and download
• Desktop App