https://github.com/hmlendea/sokoban-cli

Command-line version of the game Sokoban
https://github.com/hmlendea/sokoban-cli

Last synced: 11 months ago
JSON representation

Command-line version of the game Sokoban

• Host: GitHub
• URL: https://github.com/hmlendea/sokoban-cli
• Owner: hmlendea
• License: gpl-3.0
• Created: 2016-10-21T20:47:21.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2019-02-23T23:22:23.000Z (over 7 years ago)
• Last Synced: 2024-12-27T14:29:08.652Z (over 1 year ago)
• Language: C#
• Size: 81.1 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# SokobanCLI

[![Donate](https://img.shields.io/badge/-%E2%99%A5%20Donate-%23ff69b4)](https://hmlendea.go.ro/fund.html) [![Build Status](https://github.com/hmlendea/sokoban-cli/actions/workflows/dotnet.yml/badge.svg)](https://github.com/hmlendea/sokoban-cli/actions/workflows/dotnet.yml) [![Latest GitHub release](https://img.shields.io/github/v/release/hmlendea/sokoban-cli)](https://github.com/hmlendea/sokoban-cli/releases/latest)

**SokobanCLI** is a text-based version of the classic Sokoban game that runs directly in the terminal.

---

## 🔧 Features

- Fully playable command-line Sokoban game

- Map loading from text files

- Support for multiple levels

- Clean and intuitive ASCII UI

---

## 🚀 How to Run

1. Clone the repo:

   ```bash

   git clone https://github.com/hmlendea/sokoban-cli.git

   cd sokoban-cli

   ```

2. Build with .NET:

   ```bash

   dotnet build

   ```

3. Run the game:

   ```bash

   dotnet run --project SokobanCLI

   ```

---

## 🎮 Controls

- `W`, `A`, `S`, `D` – move the player

- `R` – retry

- `Esc` – quit

---

## ❤️ Support

If you find this project helpful, consider [donating here](https://hmlendea.go.ro/fund.html).

---

## 📄 License

Licensed under the [GPL-3.0](./LICENSE) License.