https://github.com/nedhmn/ygeometric

Yu-Gi-Oh! deck probability calculator using hypergeometric distribution. Successor to yugioh.party.
https://github.com/nedhmn/ygeometric

probability yugioh

Last synced: about 1 month ago
JSON representation

Yu-Gi-Oh! deck probability calculator using hypergeometric distribution. Successor to yugioh.party.

• Host: GitHub
• URL: https://github.com/nedhmn/ygeometric
• Owner: nedhmn
• License: mit
• Created: 2025-02-08T00:02:13.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-02-10T06:11:00.000Z (over 1 year ago)
• Last Synced: 2025-05-01T05:28:26.264Z (about 1 year ago)
• Topics: probability, yugioh
• Language: TypeScript
• Homepage: https://www.ygeometric.com/
• Size: 672 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Yu-Gi-Oh! Deck Calculator

[![Next.js](https://img.shields.io/badge/Next.js-15-black?style=flat&logo=next.js)](https://nextjs.org/)

[![TypeScript](https://img.shields.io/badge/TypeScript-5-blue?style=flat&logo=typescript)](https://www.typescriptlang.org/)

[![Tailwind CSS](https://img.shields.io/badge/Tailwind-3.4-38B2AC?style=flat&logo=tailwind-css)](https://tailwindcss.com/)

[![shadcn/ui](https://img.shields.io/badge/shadcn%2Fui-9.15-black?style=flat)](https://ui.shadcn.com/)

[![Vercel](https://img.shields.io/badge/Vercel-deployed-000000?style=flat&logo=vercel)](https://vercel.com)

[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

[![CI](https://github.com/nedhmn/ygeometric/actions/workflows/production.yml/badge.svg)](https://github.com/nedhmn/ygeometric/actions/workflows/production.yml)

A hypergeometric probability calculator for Yu-Gi-Oh! deck optimization. Calculate the odds of drawing specific card combinations to build more consistent decks. Spiritual successor to yugioh.party.

![ygeometric-preview](assets/ygeometric-preview.gif)

🔗 **[https://www.ygeometric.com](https://ygeometric.vercel.app)**

## 🎮 Features

- Calculate probability of drawing specific cards/combinations

- Support for multiple card scenarios

- Mobile-friendly interface

## 📱 Usage

1. Enter your deck size (40-60 cards)

2. Set your opening hand size (typically 5-6 cards)

3. Add card groups you want to calculate probabilities where:

   - Amt is the number of copies in your deck

   - Min is the minimum number of copies you want to see in your hand

   - Max is the maximum number of copies you want to see in your hand

4. View real-time probability calculations

## 💻 Local Development

# Clone the repository

```bash

git clone https://github.com/nedhmn/ygeometric.git

```

# Navigate to the project

```bash

cd ygeometric

```

# Install dependencies

```bash

pnpm install

```

# Start development server

```bash

pnpm dev

```

Open [http://localhost:3000](http://localhost:3000) in your browser.

## 🗺️ Roadmap

- [ ] Keyboard shortcuts to add and remove card groups

- [ ] Better error handling

- [ ] Share results with link

- [ ] More documentation on usage

## 🧮 How It Works

The calculator uses the hypergeometric distribution to compute probabilities. This statistical model is perfect for card games as it calculates the probability of drawing specific cards from a finite deck without replacement.

## 📝 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- Inspired by the original yugioh.party

- Yu-Gi-Oh! is a registered trademark of Konami

- Gote for the url name

- Horsemen