# Palworld Breeding Calculator

> Advanced breeding calculator and optimization tool for Palworld. Calculate breeding combinations, find optimal parent pairs, and discover the shortest breeding paths to any target Pal.

This free web-based tool helps Palworld players optimize their breeding strategies using accurate game mechanics and comprehensive breeding data.

## Core Features

- [Breeding Calculator](https://palworld-breeding-calculator-seven.vercel.app/): Calculate child outcomes from any two parent Pals
- [Reverse Lookup](https://palworld-breeding-calculator-seven.vercel.app/#reverse): Find all possible parent combinations for any target Pal
- [Path Optimizer](https://palworld-breeding-calculator-seven.vercel.app/#path): Calculate shortest breeding path from your current inventory
- [Version Tracking](https://palworld-breeding-calculator-seven.vercel.app/#diff): Compare breeding changes between game updates

## Key Capabilities

- **225 Pals Database**: Complete breeding data for all Pals in the game
- **32 Special Combinations**: All unique breeding exceptions and fusion combos
- **Inventory-Aware Planning**: Mark owned Pals to find optimal breeding routes
- **Multi-Optimization**: Choose between minimum steps, cake cost, or time
- **Real-Time Calculation**: Instant results with no server delays

## How It Works

The calculator uses hidden breeding power values from the game. When breeding, the child's power equals the average of both parents (rounded), then maps to the closest matching Pal. Special exceptions are checked first.

## Special Breeding Rules

- **Unique Combinations**: Specific pairs like Kitsun + Astegon = Shadowbeak
- **Self-Only Breeding**: Legendaries like Jetragon can only breed with themselves
- **Fusion Combos**: Special results like Helzephyr + Frostallion = Frostallion Noct

## Usage Examples

- Find how to breed rare Pals like Shadowbeak or Frostallion Noct
- Calculate the shortest path to breed any Pal from your current collection
- Discover all possible ways to obtain a specific Pal
- Optimize breeding for minimum resource consumption

## Technical Details

- **Framework**: Pure JavaScript with Bootstrap UI
- **Data**: Embedded JSON with 225 Pals and breeding rules
- **Algorithm**: BFS/Dijkstra for path optimization
- **Performance**: Sub-100ms calculation time
- **Mobile**: Fully responsive design

## Contact & Resources

- [Calculator Tool](https://palworld-breeding-calculator-seven.vercel.app/)
- [GitHub Issues](https://github.com/palworld-breeding-calculator/issues)
- Last Updated: 2025-08-30