Gacha System for Ren'Py

"I love gambling" - Evil Komi, 2026

A configurable gacha system for Ren'Py 8.3+! Includes Pity, multiple banners, a shard shop, a character-select ticket system, a collection gallery, pull history, and reveal animations!

Everything you see in the demo up above is placeholder and ready to be replaced with your own content. Play around with it and see what it does, try the tutorial, and maybe think of adding a gacha minigame to your visual novel... for some reason. 

FEATURES

• Pity system! A hard-pity guarantee (akin to Twisted Wonderland), and a soft-pity ramp that boosts the odds as a player approaches it.
• Banners! Featured banners, birthday banners? The sky is the limit.
• Multi-pulls! A 10-pull (or however many you configure) is guaranteed at least one card at or above a tier. So you can make your 10-pulls always guarantee a SR card!
• A shard shop! Duplicate pulls convert into a currency you spend to buy any card you don't own yet.
• Character-select tickets! A currency that lets a player redeem one card of a character they want! You can set it so it's either really easy or actual misery to get one.
• A collection gallery with per-character pages! 
• Pull history!
• Rarity-scaled reveal animations! the reveal's zoom, shake, screen flash, and particle burst! The demo includes some very simple ones, but you can play with ATL animations to make some fancy stuff. Compatible with things like shaders.
• A rate-disclosure screen per banner, because we all know what happens when it's not disclosed. *Shivers*
• A full reference hub UI you can use as-is, reskin, or replace entirely! It's very simple, but you can play with it.

HOW IT WORKS

Everything you want to change (your roster, rarity tiers, banners, prices, pity numbers, feature toggles...)  is in one file, gacha_config.rpy. The engine (gacha_engine.rpy) reads everything from that config and utilizes that data.  gacha_screens.rpy is what you'll want to edit for the presentation of the screens.

Card art is a an "image" field per card, just point it at your own art and it's cropped/scaled to fill every card slot in the game (gallery, shop, tickets, etc). Leave it unset and cards use a placeholder tile.

PLEASE NOTE: To use this system to its full capabilities, it's recommended that you have some level of experience with Ren'py. This plugin assumes you know Ren'py, and doesn't include tutorials or explanations on its basics. 

REQUIREMENTS

Ren'Py 8.3+

LICENSE

• Free to use in personal or commercial projects, in as many of your own projects as you like.
• This plugin is free to modify, reskin, extend, or cut down to fit your game.
• Not for resale/redistribution. Please don't do this.
• Requires credit somewhere, in the game's page or the in-game credits.
• This plugin is provided as-is with no warranty.
• Do not use the placeholder card art in your game. Those are my children

CREDITS

Ren'py screens, logic & tutorial by Meiri 

Math suffering & Python functions by adrmkx

Most of the placeholders cards were made in Comipo with backgrounds available on Unsplash. One (1) artwork is a 2020 Meiri original.

Komi chibi by mustacheskulls