Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rojikaru/renju

Renju game
https://github.com/rojikaru/renju

csharp dotnet maui nunit

Last synced: about 5 hours ago
JSON representation

Renju game

Awesome Lists containing this project

README

        

# Renju

A cross-platform [Renju](https://en.wikipedia.org/wiki/Renju) game built using the .NET MAUI framework.

## Description

Renju is a strategy board game played on a 15x15 grid. This implementation brings the classic game to modern devices using the .NET MAUI framework, allowing it to run on Android, iOS, macOS, and Windows.

## Features

- Cross-platform support (Android, iOS, macOS, Windows)
- Interactive 15x15 game board
- Two-player mode
- Game rules enforcement
- Win detection
- Simple and intuitive UI

## Requirements

- .NET 8.0 SDK or later
- Visual Studio 2022 (17.3 or later) with the .NET MAUI workload installed

## Installation

1. Clone the repository
2. Open the solution in Visual Studio
3. Build and run the project for your desired platform

## How to Play

1. Launch the app on your device
2. The game starts with an empty 15x15 board
3. Black plays first, followed by White
4. Players take turns placing their stones on empty intersections
5. The goal is to form an unbroken line of exactly five stones horizontally, vertically, or diagonally
6. The game ends when a player wins or the board is full

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## Acknowledgments

- .NET MAUI documentation and community
- Renju International Federation for game rules and inspiration

## Contact

If you have any questions or suggestions, please open an issue in the GitHub repository or contact at the email in my profile.