XYZ Chess: A New Dimension

![XYZ Chess Gameplay]

Welcome to XYZ Chess, a captivating strategic experience that elevates the classic game to a new level. Played across three stacked 8x8 boards, this game challenges you to think beyond the flat plane and master vertical tactics. With a sleek, futuristic interface, this project is a modern take on a timeless game.

Overview

XYZ Chess expands the traditional game by adding a third axis of movement. Pieces can move not only across a single board but also between the three levels, opening up a universe of new strategic possibilities. Capturing a piece might involve an attack from a different level, and king safety requires vigilance in all three dimensions.

This application is built as a sophisticated single-page application using React, TypeScript, and Tailwind CSS, featuring a custom-built 3D chess engine.

Features

• Three-Level Gameplay: Experience chess on three stacked 8x8 boards.
• Full 3D Chess Engine: Implements all standard chess rules, including castling, en passant (on a single level), and pawn promotion, adapted for a 3D environment.
• Vertical Movement: All pieces have extended move sets allowing for movement between the levels, creating deep and complex strategies.
• Interactive 3D View: A dynamic, adjustable 3D perspective allows you to view the game from the perfect angle.
• Game Logic: Full detection for Check, Checkmate, and Stalemate.
• Captured Pieces Tracker: Keep track of all captured pieces for both players.
• Intuitive UI: A clean, modern interface designed for focus and clarity.
• In-Game Instructions: A comprehensive "How to Play" modal explains the rules of 3D movement for each piece.

Tech Stack

• Frontend: React, TypeScript
• Styling: Tailwind CSS
• Module Loading: ES Modules served via esm.sh

Getting Started

To run this project locally, you just need a web server to serve the index.html file. Below are instructions for different operating systems.

Prerequisites

• A modern web browser.
• Depending on the method you choose below, you might need Node.js or Python installed.

Running the Application

First, clone the repository (or download and unzip the files):

git clone https://github.com/DoctorGuidance/xyzChess
cd xyz-chess

Then, choose one of the methods below to start a local server.

Method 1: Using Node.js (Recommended for all OS)

This is the most reliable method and works on Windows, macOS, and Linux.

1. Install Node.js: If you don't have it, download and install it from nodejs.org. This will also install npm.

2. Serve the project: A popular and easy option is serve. From inside the project directory, run:

   # If you don't have serve, install it globally first
   npm install -g serve
   
   # Run the server
   serve .

3. Open in browser: Open your web browser and navigate to the local address provided by the server (e.g., http://localhost:3000).

Method 2: Using Python (Simple Alternative)

If you have Python installed, you can use its built-in web server. This is a quick way to get started without installing anything extra.

On Windows:

1. Open Command Prompt or PowerShell in the project directory.
2. Run the following command (for Python 3):

   py -m http.server

3. Open your browser to http://localhost:8000.

On Ubuntu / macOS / Other Linux:

1. Open your terminal in the project directory.
2. Run the following command (for Python 3):

   python3 -m http.server

3. Open your browser to http://localhost:8000.

---

Contact

For any questions or inquiries, feel free to reach out:

• Telegram: t.me/DrGuidance

---

Built by a world-class senior frontend React engineer.