Renpy Particle Burst

Contents

Easy to use screen to include in your project for generating explosions at a given position. 

Provide your list of particle images or simply use the "confetti" coloured solid shapes.

Can be customised further by setting:

• bounce effects
• number of particles
• gravity intensity
• frame rate
• speed and air drag
• time to live before dissolve

---

Usage

show screen particle_overlay

---

FAQ

• How do I make confetti “hover” without falling?
  • Set G = 0 (no gravity), and optionally increase DRAG_C (e.g., 0.998) to reduce drift.
• How do I disable bounces?
  • Set BOUNCE_C = False.
• How do I change particle lifetime or sizes?
  • Adjust LIFE_MIN_C/LIFE_MAX_C and SIZE_MIN_C/SIZE_MAX_C (You can also override size_min/size_max per call to particle_burst)
• How do I turn off the system entirely?
  • Set particle_on = False to stop ticking. To hide visuals immediately, also call particle_clear().

---

Performance tips

• Keep particle_max reasonable (e.g., 200–600) to avoid large draw lists.
• Use small textures for particle_IMAGES; they’ll be scaled by xysize.
• Reduce framerate by increasing particle_dt to 1/30..1/24...