https://github.com/djeada/3d-pong
This project is a 3D implementation of the classic game Pong using the Visualization Toolkit (VTK). It is a two-player game where each player controls a paddle to hit the ball and prevent it from reaching their goal. The score is updated in real-time.
https://github.com/djeada/3d-pong
Last synced: 5 months ago
JSON representation
This project is a 3D implementation of the classic game Pong using the Visualization Toolkit (VTK). It is a two-player game where each player controls a paddle to hit the ball and prevent it from reaching their goal. The score is updated in real-time.
- Host: GitHub
- URL: https://github.com/djeada/3d-pong
- Owner: djeada
- License: mit
- Created: 2023-06-15T18:17:13.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-06-01T20:17:54.000Z (about 2 years ago)
- Last Synced: 2025-02-05T11:51:51.554Z (over 1 year ago)
- Language: Python
- Size: 29.3 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 3D Pong Game
This project is a 3D implementation of the classic game Pong using the Visualization Toolkit (VTK). It features both single-player mode with AI opponent and two-player local multiplayer. The score is updated in real-time with visual feedback.
## Features
### Gameplay
- **3D Real-Time Rendering**: Utilizes VTK to create an immersive 3D game environment.
- **Single Player Mode**: Play against an AI opponent with three difficulty levels.
- **Two-Player Mode**: Local multiplayer with keyboard controls.
- **Win Condition**: First player to reach 11 points wins the match.
- **Dynamic Ball Physics**: Ball angle changes based on where it hits the paddle.
- **Progressive Difficulty**: Ball speed increases over time for more challenging gameplay.
### Visual Effects
- **Ball Trail**: Colorful trail effect following the ball (toggle with T key).
- **Speed-Based Colors**: Ball color changes based on its current speed.
- **Collision Effects**: Visual feedback when ball hits paddles.
- **Score Flash**: Background flash effect when scoring.
- **Dark Theme**: Modern dark background for better visibility.
### AI Opponent
- **Three Difficulty Levels**:
- **Easy**: Slower reactions, less accurate predictions
- **Medium**: Balanced gameplay (default)
- **Hard**: Fast reactions, highly accurate
## Controls
### Paddle Movement
- **Player 1 (Left)**: `W` to move up, `S` to move down
- **Player 2 (Right)**: `↑` Arrow to move up, `↓` Arrow to move down
### Game Controls
| Key | Action |
|-----|--------|
| `Space` | Pause/Resume game |
| `R` | Reset game |
| `A` | Toggle AI opponent on/off |
| `D` | Cycle difficulty (Easy → Medium → Hard) |
| `T` | Toggle ball trail effect |
## Installation
### For Developers
To work with the source code and manage dependencies, follow these steps:
1. **Clone the Repository**: First, clone the repository to your local machine.
```bash
$ git clone https://github.com/djeada/3D-Pong.git
$ cd 3D-Pong
```
2. **Set Up a Virtual Environment**: It's a good practice to use a virtual environment to manage dependencies.
```bash
$ virtualenv env
$ source env/bin/activate
```
3. **Install Dependencies**: Install the required Python packages listed in the `requirements.txt` file.
```bash
$ pip install -r requirements.txt
```
4. **Verify VTK Installation**: Ensure that VTK is installed correctly by running a simple VTK script or checking the installation.
```bash
$ python -c "import vtk; print(vtk.VTK_VERSION)"
```
5. **Run the Game**: After setting up everything, you can run the game using the following command:
```bash
$ python src/main.py
```
### For Normal Users
For users who just want to play the game without diving into the source code, follow these steps:
1. **Download the Executable**: Go to the [Releases](https://github.com/yourusername/3D-Pong/releases) page of the GitHub repository.
2. **Select the Latest Release**: Find the latest release and download the executable file appropriate for your operating system (e.g., Windows, macOS, Linux).
3. **Run the Executable**:
- **Windows**: Double-click the `.exe` file to start the game.
- **macOS/Linux**: Open a terminal, navigate to the directory containing the downloaded file, and run the following command:
```bash
$ chmod +x 3D-Pong
$ ./3D-Pong
```
## Contributing
We welcome contributions to this guide! If you would like to contribute, please create a pull request. For major changes, please open an issue first to discuss what you would like to change.
## License
[MIT](https://choosealicense.com/licenses/mit/)