ScrabbleBot

ScrabbleBot is a Python implementation of Scrabble with a Pygame-based GUI and a core rules engine you can test or extend. The project separates game logic from the UI so you can build bots, experiment with scoring/rules, or plug in new interfaces.

Features

• Core engine: board, tiles, rules validation, and scoring.
• Dictionary-backed legality checks.
• Simple GUI for local play.
• Pluggable AI engines in scrabble/engine/ (greedy/random examples).

Requirements

• Python 3.10+ recommended.
• Pygame (for the GUI).

Setup

python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txt

Run

python main.py
# or
python -m scrabble_gui

Tests

python -m unittest discover -s tests

Project Layout

• scrabble/: core logic (rules, scoring, game state, engines).
• scrabble_gui/: Pygame UI (scenes, widgets, assets).
• tests/: unit tests.
• assets/: dictionary files.

License

MIT. See LICENSE.