https://github.com/carsonsgit/pong

Pong game coded in Game Programming.
https://github.com/carsonsgit/pong

game-programming javascript

Last synced: 6 months ago
JSON representation

Pong game coded in Game Programming.

• Host: GitHub
• URL: https://github.com/carsonsgit/pong
• Owner: carsonSgit
• Created: 2023-08-27T22:41:30.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2023-11-25T00:38:05.000Z (almost 2 years ago)
• Last Synced: 2025-04-08T04:22:10.190Z (7 months ago)
• Topics: game-programming, javascript
• Language: JavaScript
• Homepage:
• Size: 107 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Pong Game

## Contributors

 - Vikram Singh: My teacher who created the base of this game

 - Carson Spriggs-Audet: Accomplished the instructions given to me and added extra functionality.

## Overview

This is a simple implementation of the classic Pong game using HTML, CSS, and JavaScript. The game features two paddles, a ball, and basic game mechanics such as scoring, serving, and victory conditions. 

The code structure includes separate classes for the paddles and the ball, promoting modularity and maintainability.

# Screenshots

## Begin Screen

![beginScreen](https://github.com/carsonSgit/Pong/assets/92652800/2e115039-bd02-4390-9988-5d7cdad2dc0d)

## Serve Screen

![serveScreen](https://github.com/carsonSgit/Pong/assets/92652800/5d55226b-27c2-4ef0-8f57-a458c8580b67)

## In Play

![inPlay](https://github.com/carsonSgit/Pong/assets/92652800/0eeafeb3-670e-436f-b2a4-62b5b74eda32)

## Player Scored

![hasScore](https://github.com/carsonSgit/Pong/assets/92652800/e3a73d14-4b76-4e16-a7cd-bd34dbc7b5ad)

## Toggle for multiplayer

In main.js, line 28 toggle this depending on your preference.

![mainSingleplayerToggle](https://github.com/carsonSgit/Pong/assets/92652800/f84cdf16-1ecf-478d-a58f-25389e9596cf)

## How to Play

- **Controls:**

  - Player 1 (Left Paddle): W (Up), S (Down)

  - Player 2 (Right Paddle): Arrow Up (Up), Arrow Down (Down)

  - Start/Serve/Restart: Enter

- **Objective:**

  - Score points by making the ball pass the opponent's paddle.

  - The first player to reach the victory score (default is 3) wins.

## Code Structure

### HTML

- The HTML file (`index.html`) defines the basic structure of the webpage, including the canvas element where the game is rendered.

### JavaScript

#### Main Game Logic (`main.js`)

- **Game Initialization:**

  - Creates a canvas element and sets its properties.

  - Initializes paddles, ball, and game variables.

- **Event Listeners:**

  - Listens for keydown and keyup events to track player input.

- **Game Loop:**

  - The `gameLoop` function serves as the main loop, calling the `update` and `render` functions.

- **Update Function:**

  - Handles game logic, including state transitions, paddle and ball movement, scoring, and victory conditions.

- **Render Function:**

  - Draws the current game state on the canvas, including scores, paddles, ball, and state-specific messages.

- **Paddle Class (`Paddle.js`):**

  - Represents a paddle in the game.

  - Handles paddle movement, AI for single-player mode, and rendering.

- **Ball Class (`Ball.js`):**

  - Represents the game ball.

  - Manages ball movement, collisions with paddles and walls, and rendering.

#### Utilities (`utilities.js`)

- Contains utility functions for generating random numbers used in the ball's initial velocity.

## Additional Features

- **Single Player Mode:**

  - Can be toggled on/off by setting the `singleplayer` variable in `main.js` to `true` or `false`.

- **Custom Font:**

  - Utilizes a custom font ('PublicPixel') for a retro-style aesthetic.

- **Sound Effects:**

  - Plays sound effects for scoring, victory, wall hits, and paddle hits.

## How to Run

1. Download all files.

2. Open the `index.html` file in a modern web browser.

## Acknowledgments

- **Author:** Carson Spriggs-Audet

- **Teacher:** Vikram Singh

This Pong game was developed as a Game Programming assignment based on my teacher Vikram Singh's code.