Petbot/CHANGELOG.md

# Changelog

All notable changes to PetBot IRC Game will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [v0.2.0] - 2025-07-13

### 🎒 Item Collection System
- **Complete Item System** - 16 unique items across 5 categories
- **Item Discovery** - 30% chance to find items during exploration
- **Rarity Tiers** - Common, Uncommon, Rare, Epic, Legendary with symbols
- **Location-Specific Items** - Unique treasures in each area
- **Inventory Management** - `!inventory` and `!use` commands
- **Consumable Items** - Healing potions, battle boosters, lucky charms
- **Web Integration** - Player inventories displayed on profile pages

### 🎯 New Items Added
- **Healing Items**: Small/Large/Super Potions, Energy Berries
- **Battle Items**: Attack Boosters, Defense Crystals, Speed Elixirs  
- **Rare Items**: Fire/Water Stones, Lucky Charms, Ancient Fossils
- **Location Items**: Pristine Shells, Glowing Mushrooms, Volcanic Glass, Ice Crystals, Ancient Runes

### 🆕 New Commands
- `!inventory` / `!inv` / `!items` - View collected items by category
- `!use <item name>` - Use consumable items on active pets

### 🔧 Technical Updates
- **Database Schema** - Added `items` and `player_inventory` tables
- **Game Engine** - Integrated item discovery with exploration system
- **Web Interface** - Added inventory section to player profiles with rarity colors
- **Module System** - New Inventory module for item management

### 🎨 Visual Enhancements
- **Rarity Symbols** - ○ ◇ ◆ ★ ✦ for different item tiers
- **Color-Coded Items** - Web interface shows items with rarity-specific colors
- **Category Organization** - Items grouped by type in inventory display

---

## [v0.1.0] - 2025-07-13

### 🎮 Major Features Added
- **Complete IRC Pet Collection Game** - Pokemon-style gameplay in IRC
- **Dynamic Weather System** - Real-time weather affecting spawn rates
- **Web Dashboard** - Modern web interface for player stats and collections
- **Turn-Based Battles** - Strategic combat with type effectiveness
- **Multi-Location Exploration** - 6 themed locations with unique spawns
- **Achievement System** - Unlock new areas by completing challenges
- **Player Progression** - Experience, levels, and team management

### 🌤️ Weather System
- **Background Task System** - Automatic weather updates every 5 minutes
- **Dynamic Durations** - Weather lasts 30 minutes to 3 hours
- **6 Weather Types** - Each with unique spawn modifiers:
  - Sunny (1.5x Fire/Grass) - 60-120 min
  - Rainy (2.0x Water) - 45-90 min  
  - Thunderstorm (2.0x Electric) - 30-60 min
  - Blizzard (1.7x Ice/Water) - 60-120 min
  - Earthquake (1.8x Rock) - 30-90 min
  - Calm (1.0x Normal) - 90-180 min
- **Continuous Coverage** - No more expired weather periods
- **Location-Specific** - Each location has appropriate weather patterns

### 🐛 Bug Fixes
- **Database Persistence** - Players retain data after bot restarts
- **Player Page Display** - Fixed "player not found" errors on individual pages
- **Achievement Counts** - Corrected SQL query Cartesian product issue
- **Travel Requirements** - Added specific achievement requirement messages
- **Battle Move Colors** - Different colors for each move type for clarity
- **Locations Page** - Fixed column indexing and display issues

### 🔧 Technical Implementation
- **Modular Architecture** - Clean separation of concerns
- **Async Database** - SQLite with aiosqlite for performance
- **Background Tasks** - Proper async task management
- **Error Handling** - Robust error handling throughout
- **Clean Shutdown** - Graceful cleanup of background tasks
- **PM Flood Prevention** - Web links instead of message spam

### 📊 Statistics
- **6,235+ lines of code** across 31 files
- **6 game locations** with unique spawns
- **15+ IRC commands** for gameplay
- **8 database tables** with relationships
- **Web server** with 5 main pages
- **Background weather task** running continuously

### 🎯 Commands Added
- `!start` - Begin your journey
- `!explore` - Find wild pets
- `!catch <pet>` - Catch wild pets
- `!battle` - Start combat
- `!attack <move>` - Use battle moves
- `!team` - View active pets
- `!pets` - Complete collection (web)
- `!travel <location>` - Move between areas
- `!weather` - Check current weather
- `!achievements` - View progress
- `!activate/deactivate <pet>` - Manage team
- `!swap <pet1> <pet2>` - Reorganize team
- `!moves` - View pet abilities
- `!flee` - Escape battles

---

## Version History

### Versioning Scheme
- **Major.Minor.Patch** (e.g., v1.0.0)
- **Major**: Breaking changes or major feature releases
- **Minor**: New features, significant improvements
- **Patch**: Bug fixes, small improvements

### Planned Releases
- **v0.2**: PvP battles between players
- **v0.3**: Pet evolution system
- **v0.4**: Trading system
- **v0.5**: Seasonal events and more locations