Sequence Pro - Multiplayer Sequence Simulator

Sequence Pro is a modern, full-stack web application that digitizes the classic board game "Sequence". It features real-time multiplayer, a high-fidelity 3D interface, and an advanced AI simulation laboratory for strategy analysis.

---

Features

Gameplay Modes

• Solo Play: Play against a smart AI opponent with adjustable difficulty.
• Real-Time Multiplayer: Create private rooms and play with friends instantly via WebSockets.
• AI Battle Arena: Watch two AI agents battle it out in high-speed simulations.

Monte Carlo Lab

• Simulation Dashboard: Run batch simulations (100+ games) to analyze win rates and game balance.
• Data Visualization: View win/loss charts and average turn statistics using granular data.

Visuals & UX

• 3D Board Experience: Immersive, perspective-tilted board with hover effects and animations.
• Interactive Hand: Dynamic card selection with visual cues for valid moves (Single-player).
• Robust Connectivity: "Slot System" ensures stable connections even if players refresh the page.

---

Tech Stack

Frontend

• React (Vite + TypeScript)
• Tailwind CSS (Styling)
• Framer Motion (Animations)
• React Query (State Management)
• Lucide React (Icons)

Backend

• Python 3.10+
• FastAPI (API & WebSockets)
• Pandas (Data Analysis for Lab)
• Uvicorn (ASGI Server)

Game Engine

• Custom Python Engine: Deterministic logic handling all Sequence rules (Jacks, locking, dead cards).

---

Installation & Setup

Prerequisites

• Node.js (v18+)
• Python (v3.10+)

1. Clone the Repository

git clone https://github.com/akashrane/Sequence.git
cd Sequence

2. Backend Setup

Create a virtual environment and install dependencies.

# Windows
python -m venv venv
.\venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Start the Server:

uvicorn backend.main:app --reload --port 8000

The backend will run at http://localhost:8000.

3. Frontend Setup

Open a new terminal.

cd frontend
npm install

Start the Client:

npm run dev

The application will open at http://localhost:5173.

---

How to Play

1. Objective: Form two rows of 5 consecutive chips (Sequences) on the board.
2. Turn:
   • Select a card from your hand.
   • Place a chip on the corresponding board square.
   • Draw a new card to end your turn.
3. Special Cards:
   • Two-Eyed Jacks: Wild card. Place a chip anywhere.
   • One-Eyed Jacks: Anti-Wild. Remove an opponent's chip (unless locked in a Sequence).
4. Winning: The first player/team to complete 2 Sequences wins!

---

Future Roadmap

• Replay System (Game History)
• Cloud Deployment (Docker/Vercel)
• User Accounts & ELO Ratings

---

Built by Akash Rane.