♟ GabiBot - Chess Bot and ModMenu for Chess.com ♟

> A powerful userscript that enhances your chess experience on Chess.com with automated suggestions, premoves, and visual aids.


## 🚀 Features

### Core Bot Functionality
- **Smart Move Suggestions**: Uses Stockfish engine to analyze positions and suggest optimal moves
- **Customizable Depth**: Adjust analysis depth from 1-20 for balance between speed and accuracy
- **Randomized Analysis**: Introduces natural variability to avoid detection patterns
- **Caching System**: Remembers analyzed positions for faster subsequent queries

### Automation Features
- **Auto-Move**: Automatically executes suggested moves with configurable delays
- **Premove System**: Queue moves for execution when it becomes your turn
- **Condition-based Premoves**: Configure when to auto-queue premoves (every move, only captures, or by piece type)
- **Human-like Delays**: Configurable random delays to mimic human reaction times

### Visual Enhancements
- **Evaluation Bar**: Real-time position assessment displayed alongside the board
- **Move Arrows**: Visual indicators for suggested moves (green for current, blue for premoves)
- **Principal Variation Display**: Shows the engine's thinking process

### User Interface
- **Modern ModMenu**: Sleek, draggable interface with customizeable options
- **Minimize Function**: Collapsible menu (Ctrl+B shortcut)
- **Individual Controls**: Toggle features independently
- **Settings Persistence**: Remembers your preferences between sessions

### Game Management
- **Auto-Rematch**: Automatically accept rematch requests after game completion
- **Game State Detection**: Smart recognition of game start/end states
- **Fail-safes**: Comprehensive error handling and recovery mechanisms

### Safety Features
- **API Retry Logic**: Robust connection handling with exponential backoff
- **Move Validation**: Ensures suggested moves are legal before execution
- **Position Synchronization**: Cancels actions if game state changes unexpectedly

## ⚠️ Disclaimer

### Fair Play Notice
GabiBot is designed for learning and analysis purposes. While automated features can enhance your chess understanding, excessive use of automation may violate Chess.com's terms of service. Use responsibly and consider the impact on your opponent's experience.

### Legal Information
- This software is provided "as-is" with no warranty
- Users are responsible for compliance with platform terms
- The developer is not liable for any consequences of use

### Educational Use
Consider using GabiBot to:
- Analyze your games to improve understanding
- Practice openings and endgames
- Learn from engine recommendations
- Train against specific difficulty levels

## 📝 License

This project is licensed under the MIT License - see the script header for details.