Gacha Game Pull Probability Calculator

A web-based calculator that helps you estimate the probability of obtaining 5-star characters in various Gacha games.

Includes statistical visualizations via Tableau for deeper insights into pull rates and probability distributions.

Supported Games

• Honkai: Star Rail
• Genshin Impact
• Zenless Zone Zero

Technical Notes

• Rate-increase assumption: 7% for all banners across supported games
• Data sources:
  • HoYoLAB Article
  • Star Rail Station
  • Paimon.moe
  • ZZZ RNG

Build Status

Quick Start Guide for the Web-App Calculator

Docker Requirements

• Docker Desktop

Installation

1. Clone the repository:

   git clone https://github.com/sakan811/gacha-game-pull-calculator.git
   cd gacha-game-pull-calculator
   

2. Download the docker-compose.yml file from the repository:

3. Open a terminal in the directory containing the file

4. Run:

   docker-compose up -d
   

5. Visit http://localhost:5173 in your browser

Statistics Visualization

View detailed probability statistics and visualizations here.

Application Flow Documentation

View the application architecture and flow diagrams here.

Running Statistics Script

Prerequisites

• UV Package Manager

Setup and Execution

1. Navigate to stats directory:

   git clone https://github.com/sakan811/gacha-game-pull-calculator.git
   cd stats
   

2. Set up Python environment:

   uv venv
   # Windows
   venv\Scripts\activate
   # macOS/Linux
   source venv/bin/activate
   

3. Install dependencies:

   uv sync
   

4. Run the script:

   python runner.py