Chess Cheat Assistant

nolancacheux/chess-cheat-assistant

Chess Assistant for chess.com

---

---

Getting Started

1. Clone the repository:

   git clone https://github.com/nolancacheux/chess-cheat-assistant.git

2. Load the extension in Chrome:
   • Go to chrome://extensions/
   • Enable Developer Mode
   • Click Load Unpacked and select the project folder you cloned. (e.g., chess-cheat-assistant)
3. Go to chess.com and start a game.
4. Activate the assistant.

---

Features

Real-Time Move Analysis

As soon as you activate the assistant, it connects to the chess.com board and uses a built-in Stockfish engine to analyze the current position. You’ll see the best move, evaluation score, and analysis depth update live as the game progresses.

Advantage Tracking

A dynamic advantage bar that visually represents which side is ahead, based on the engine’s evaluation.

Color Selection & Board Orientation

You can choose to play as White or Black, and the assistant adapts its analysis and move suggestions accordingly. Can be useful for players who want to practice against the engine or analyze their own games.

Level Maximum defeated (3200 Elos)

The assistant has won against the maximum level of chess.com, which is 3200 Elos.

---

Educational Purpose

This extension is designed for educational and research purposes only. It helps you understand how chess engines and browser-based chess assistants work, so you can learn about move analysis, position evaluation, and the technology behind chess improvement tools. Do not use this tool to cheat in online games—it is meant to foster learning, awareness, and fair play. Using such tools during live games is against the rules of chess platforms and can result in bans. Please use responsibly!

---

What is Chess Cheat Assistant?

Chess Cheat Assistant is a powerful, interactive browser extension for chess.com that demonstrates how a chess engine can analyze positions, suggest moves, and even automate play. It’s a hands-on way to explore:

• How Stockfish and other chess engines evaluate positions
• How browser extensions can interact with chess boards
• The difference between human and computer move selection
• The technical side of chess automation and move visualization

---

How Does It Work? (Technical Overview)

• Board State Extraction: The extension reads the chess.com board and generates a FEN string for the current position.
• Stockfish Integration: A web worker runs Stockfish in the background, analyzing the position at configurable depth.
• Move Highlighting: The assistant overlays custom HTML/CSS highlights on the board, using animation for visibility.
• Auto-Play: The assistant simulates mouse events to move pieces, demonstrating browser automation techniques.
• Analysis History: All engine outputs are logged and displayed in a sortable, filterable table.
• Advantage Bar: The evaluation is mapped to a visual bar for instant feedback.

---

Repository & License

• Repository: https://github.com/nolancacheux/chess-cheat-assistant
• License: MIT
• Author: Nolan Cacheux