♟️ AsciiChess

A fully-featured ASCII chess game implemented in Java with terminal-based graphics and interactive gameplay.

📖 Overview

AsciiChess is a terminal-based chess game that brings the classic game of chess to your command line. Built with Java 21 and featuring beautiful ASCII art, this implementation provides a complete chess experience with:

• ✨ Beautiful ASCII art interface
• 🎮 Interactive keyboard controls
• ♟️ Full chess piece movement validation
• 🤖 AI opponent (coming soon)
• 🎨 Colorized terminal output
• ⌨️ Cross-platform terminal support

🎯 Features

• Complete Chess Implementation: All standard chess pieces with proper movement rules
• Interactive Gameplay: Navigate the board using keyboard controls
• Visual Board Display: Clean ASCII representation of the chess board
• Move Validation: Ensures all moves follow chess rules
• Cross-Platform: Works on Windows, macOS, and Linux terminals
• Modern Java: Built with Java 21 and modern development practices

📸 Screenshots

Game Interface

Board View

Piece Selection

Move Highlighting

Gameplay

Demo Video

WindowsTerminal_DJTGM58PVs.mp4

🚀 Getting Started

Prerequisites

• Java 21 or higher
• Maven 3.6+ for building
• A terminal that supports ANSI colors (most modern terminals)

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/AsciiChess.git
   cd AsciiChess

2. Build the project:

   mvn clean compile

3. Run the game:

   mvn exec:java -Dexec.mainClass="org.ascii.Main"

   Or build a JAR file:

   mvn assembly:single
   java -jar target/AsciiChess-1.0-SNAPSHOT-jar-with-dependencies.jar

🎮 How to Play

Controls

• Arrow Keys: Navigate the board cursor
• Enter/Space: Select piece or confirm move
• ESC: Cancel current selection
• Q: Quit game

Gameplay

1. Start the game and you'll see the chess board
2. Use arrow keys to move the cursor to the piece you want to move
3. Press Enter to select the piece
4. Move the cursor to the destination square
5. Press Enter to make the move
6. The game alternates between white and black players

🏗️ Project Structure

src/main/java/org/ascii/
├── Main.java                 # Entry point and game initialization
├── chess/
│   ├── ai/
│   │   └── KingsMovement.java # AI movement logic
│   ├── board/
│   │   ├── ChessBoard.java   # Board representation
│   │   ├── ChessBox.java     # Individual board squares
│   │   └── Game.java         # Game logic and state
│   ├── pieces/
│   │   ├── Bishop.java       # Bishop piece implementation
│   │   ├── ChessPieceType.java # Piece type enumeration
│   │   ├── ChessToken.java   # Base piece class
│   │   ├── King.java         # King piece implementation
│   │   ├── Knight.java       # Knight piece implementation
│   │   ├── Pawn.java         # Pawn piece implementation
│   │   ├── Queen.java        # Queen piece implementation
│   │   └── Rook.java         # Rook piece implementation
│   └── util/
│       ├── Colors.java       # Terminal color constants
│       ├── Cursor.java       # Cursor management
│       ├── Data.java         # Game data structures
│       ├── Directions.java   # Movement directions
│       ├── Display.java      # Display utilities
│       ├── Key.java          # Keyboard input constants
│       ├── KeyBoardInput.java # Input handling
│       ├── MovementRecord.java # Move history
│       ├── Movements.java    # Movement validation
│       ├── Path.java         # Path finding for pieces
│       ├── Players.java      # Player management
│       ├── Point.java        # Board coordinates
│       └── Text.java         # Text utilities

🛠️ Dependencies

• JLine 3.23.0: Terminal control and input handling
• JNA 5.12.1: Native library access for terminal operations
• Jansi 2.4.0: ANSI escape sequence support

🤝 Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Add tests if applicable
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

Development Setup

# Clone your fork
git clone https://github.com/yourusername/AsciiChess.git
cd AsciiChess

# Build and test
mvn clean compile
mvn test

# Run the game
mvn exec:java -Dexec.mainClass="org.ascii.Main"

🔮 Future Features

• AI opponent with difficulty levels
• Save/load game functionality
• Network multiplayer support
• Move history and replay
• Chess notation support (PGN)
• Tournament mode
• Customizable themes
• Sound effects

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Hilal - GitHub Profile

🙏 Acknowledgments

• Thanks to the JLine team for excellent terminal control
• Chess piece movement algorithms inspired by classic chess implementations
• ASCII art generated with online tools

📞 Support

If you encounter any issues or have questions:

1. Check the Issues page
2. Create a new issue with detailed information
3. Join the discussion in existing issues

---

⭐ If you enjoyed this project, please give it a star! ⭐