Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/mehrshaad/ap_basketball_game

Advanced Programming Project (Basketball Game)
https://github.com/mehrshaad/ap_basketball_game

advanced-programming gui pygame python sqlite

Last synced: 9 days ago
JSON representation

Advanced Programming Project (Basketball Game)

Awesome Lists containing this project

README

        

# Basketball-game project
+ [Project summary](#project-summary)
+ [How to run](#how-to-run)
+ [How to play](#how-to-play)
+ [Sign Up](#sign-up)
+ [Enter your username and name](#enter-your-username-and-name)
+ [Choose a mode to play](#choose-a-mode-to-play-solo-or-multi-player)
+ [Solo mode](#solo-mode)
+ [Enter username (sign up if it's your first time) - select difficulty - select your player color](#enter-username-sign-up-if-its-your-first-time---select-difficulty---select-your-player-color)
+ [Hit the basket!](#hit-the-basket)
+ [Multi-Player mode](#multi-player-mode)
+ [Enter usernames (sign up if it's your first time)](#enter-usernames-sign-up-if-its-your-first-time)
+ [Select each player's color](#select-each-players-color)
+ [Try to defeat your opponent!](#try-to-defeat-your-opponent)
+ [1st player controlls](#1st-player-controlls)
+ [2nd player controlls](#2nd-player-controlls)
+ [Team (alphabetical order)](#team-alphabetical-order)
+ [Ali Dadashzadeh](#ali-dadashzadeh)
+ [Kiyan Rezaee](#kiyan-rezaee)
+ [Vahid Aghilzadeh](#vahid-aghilzadeh)

## Project summary


This project was one of the final projects of our Advanced Programming course at the Guilan University, which was instructed by Prof. Sadegh Eskandari, that we'd to implement one of them to pass the course. But we'd decided to do both available projects, so we passed the course with the max score (20 of 20). This project was also the best project of the course at the time (you can check the website of the course by clicking here). After that, we were offered to be Teaching Assistants of the course for the next semesters.


We'd to implement this project in Python programming language using the Pygame package. You can see our other Advanced Programming project by clicking here!




NOTE: We didn't use GitHub while we were working on these projects, so my team isn't listed as contributors.

## How to run


Python3 and the Pygame package are needed to run the game.

How to install Python

Download a suitable Python version from [**here**](https://www.python.org/downloads/).\
Then install it and don't forget to check (enable) the `add to path` option while installing.\
After that you can test it by entering `pip3` command in the terminal.

How to install Pygame

Windows:
```shell
pip install pygame
```

Linux | MacOS:
```shell
pip3 install pygame
```


Then you have to download and extract the project files from releases page.


Then direct to that folder and open the terminal in that folder and enter one of these commands (choose the right one based on your OS).

Windows:
```shell
python Basketball.py
```

Linux | MacOS:
```shell
python3 Basketball.py
```

## How to play
### Choose a mode to play: [Solo](#solo-mode) or [Multi-Player](#multi-player-mode)
![ScreenRec 0014](https://user-images.githubusercontent.com/60104751/130366579-d04f83a2-b7d6-4fd4-90e6-a9d50ee42e4a.jpg)

---

### Solo mode
#### Enter username ([sign up](#sign-up) if it's your first time) - select difficulty - select your player color
![ScreenRec 0016](https://user-images.githubusercontent.com/60104751/130366814-47de448a-c783-4120-ac00-102fe216d1b6.jpg)

#### Hit the basket!
![ScreenRec-0017](https://user-images.githubusercontent.com/60104751/130366971-fd6b68e4-c1eb-4582-b445-78bc42c10a0d.gif)

---

### Multi-Player mode
#### Enter usernames ([sign up](#sign-up) if it's your first time)
![ScreenRec 0019](https://user-images.githubusercontent.com/60104751/130367198-fe4dbe5d-2d1e-4a40-b749-f0e8a4dfc59b.jpg)

#### Select each player's color
![ScreenRec 0020](https://user-images.githubusercontent.com/60104751/130367228-760ad243-2543-4a83-b475-df7583a40d0f.jpg)

#### Try to defeat your opponent!
##### 1st player controlls:
+ Moves with: `Arrow keys`
+ Shoots with: `L`
+ Goal: `Left`

##### 2nd player controlls:
+ Moves with: `WASD keys`
+ Shoots with: `V`
+ Goal: `Right`

![ScreenRec-0021](https://user-images.githubusercontent.com/60104751/130367487-82477484-2b80-418d-935e-1bf9df052634.gif)

---

### Sign Up
#### Enter your username and name
![ScreenRec 0018](https://user-images.githubusercontent.com/60104751/130367327-a6d71bd1-8c09-40e4-af25-0858b62f4435.jpg)

## Team (alphabetical order)
### Ali Dadashzadeh
>
>>
>>>
>>>>

### Kiyan Rezaee
>
>>
>>>

### Vahid Aghilzadeh
>
>>
>>>




© Summer 2020 Ma3ta team