forked from Github/uno-online
93 lines
3.2 KiB
Markdown
93 lines
3.2 KiB
Markdown
<h1 align="center">UNO ONLINE</h1>
|
||
<h2 align="center">Two player online game of UNO</h2>
|
||
<h3 align="center">Live at https://uno-online-multiplayer.herokuapp.com</h3>
|
||
|
||
<img src="client/src/assets/logo.png" alt="UNO Logo" width="33%" align="center" />
|
||
|
||
## 🤔 What is UNO?
|
||
|
||
UNO is the classic and beloved card game that’s easy to pick up and impossible to put down! Players take turns matching a card in their hand with the current card shown on top of the deck either by color or number. Special action cards deliver game-changing moments as they each perform a function to help you defeat your opponents. These include skips, reverses, draw twos, color-changing wild and draw four wild cards.
|
||
|
||
## ⚠️ Game Rules
|
||
|
||
Read the complete rules of UNO [here](https://www.unorules.com/).
|
||
|
||
## ❓ About the Game
|
||
|
||
This two-player online version of the game was built with [React](https://reactjs.org/), [Socket.IO](https://socket.io/), [Express](https://expressjs.com/) and [Node](https://nodejs.org/en/). It currently supports two-players in each game. It also has text chat functionality to communicate with your opponent!
|
||
|
||
## 🧐 How to Play?
|
||
|
||
1. Once you're on the homepage of the game, you can either host a new game or join a friend's game.
|
||
2. To host a new game, click on CREATE GAME. A game code will be generated which you can share with your friend.
|
||
3. To join a friend's game, enter the game code given by them, and click on JOIN GAME.
|
||
4. That's it! Enjoy the game and remember, no toxicity!
|
||
|
||
## 🎮 Screenshots
|
||
<img src="screenshots/Screenshot-1.png" alt="Screenshot 1" width="75%" align="center" />
|
||
<img src="screenshots/Screenshot-2.png" alt="Screenshot 2" width="75%" align="center" />
|
||
<img src="screenshots/Screenshot-3.png" alt="Screenshot 3" width="75%" align="center" />
|
||
|
||
## 🏁 Getting Started (to run game locally)
|
||
|
||
Follow the steps below, after cloning the repository:
|
||
|
||
### 🖐 Requirements
|
||
|
||
**For Installing:**
|
||
|
||
- Node
|
||
|
||
### ⏳ Installation
|
||
|
||
- At the root of the project directory, use npm to install the server-side dependencies
|
||
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
This command installs all the server-side dependencies needed for the game to run locally.
|
||
|
||
- (Use npm to run server)
|
||
|
||
```bash
|
||
npm start
|
||
```
|
||
|
||
This command gets the server running on localhost port 5000.
|
||
|
||
- In a separate terminal, navigate into the client folder and use npm to install the client-side dependencies
|
||
|
||
```bash
|
||
cd client
|
||
npm install
|
||
```
|
||
|
||
This command installs all the client-side dependencies needed for the game to run locally.
|
||
|
||
- Finally, use npm to run client
|
||
|
||
```bash
|
||
npm start
|
||
```
|
||
|
||
This command gets the client running on localhost port 3000.
|
||
|
||
Head over to http://localhost:3000/ and enjoy the game! 🎉
|
||
|
||
|
||
## 🤝 Contributing
|
||
|
||
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.
|
||
|
||
1. Fork the Project Repo
|
||
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
|
||
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
|
||
4. Push to the Branch on your forked Repo (`git push origin feature/AmazingFeature`)
|
||
5. Open a Pull Request
|
||
|
||
|
||
## ❤️ Acknowledgements
|
||
|
||
* [AlexDer](https://alexder.itch.io/) for the UNO cards assets!
|