https://github.com/michaelkolesidis/beachy-beachy-ball

A beach ball adventure! Can you make it to the end?
https://github.com/michaelkolesidis/beachy-beachy-ball

3d 3d-game ball ball-game beach-ball beach-ball-game beachy browser-game game game-3d internet-game marble-race online-game summer summer-game threejs threejs-game web-game webgl webgl-game

Last synced: 5 days ago
JSON representation

A beach ball adventure! Can you make it to the end?

• Host: GitHub
• URL: https://github.com/michaelkolesidis/beachy-beachy-ball
• Owner: michaelkolesidis
• License: agpl-3.0
• Created: 2023-03-28T15:09:05.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-11-23T03:23:14.000Z (12 months ago)
• Last Synced: 2024-05-02T05:40:31.394Z (7 months ago)
• Topics: 3d, 3d-game, ball, ball-game, beach-ball, beach-ball-game, beachy, browser-game, game, game-3d, internet-game, marble-race, online-game, summer, summer-game, threejs, threejs-game, web-game, webgl, webgl-game
• Language: JavaScript
• Homepage: https://beachy-beachy-ball.vercel.app
• Size: 7.17 MB
• Stars: 11
• Watchers: 1
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
![Beachy Beachy Ball Logo](./images/logo_bg_blue.png)

## Features

## Technologies

The core technologies used are _JavaScript_ and _WebGL_. The following libraries and tools are used:

| Name              | License | Description                                  |

| ----------------- | :-----: | -------------------------------------------- |

| React             |   MIT   | Component-based, front-end interface library |

| Three.js          |   MIT   | 3D graphics API for the web, based on WebGL  |

| React Three Fiber |   MIT   | A React renderer for Three.js                |

| Drei              |   MIT   | Useful helpers for React Three Fiber         |

| Zustand           |   MIT   | State management                             |

| Vite              |   MIT   | Frontend development tooling                 |

## Screenshots

![Screenshot](./screenshots/screenshot_001.png)

![Screenshot](./screenshots/screenshot_002.png)

![Screenshot](./screenshots/screenshot_003.png)

![Screenshot](./screenshots/screenshot_004.png)

![Screenshot](./screenshots/screenshot_005.png)

![Screenshot](./screenshots/screenshot_006.png)

## Roadmap

## Gameplay and Rules

The player controls a beach ball, and has to hit the star at the end of the level in order to win, while avoiding a variety of obstacles. If the ball falls off the level, the game restarts with the ball in its initial position.

### Controls

|  Button(s)   |           Action            |

| :----------: | :-------------------------: |

| ←↑→↓ or WASD |            Move             |

|    Space     |            Jump             |

|    Enter     |  Start game (on main menu)  |

|      M       |         Mute/Unmute         |

|      R       |           Restart           |

|      P       |   Show performance stats    |

|     Esc      | Toggle menu modal (in game) |

## Software Used

A non-exhaustive list of all the software that was used during the development of _Beachy Beachy Ball_.

- Visual Studio Code

- Figma

- Blender

- Adobe Photoshop

- Inkscape

- Google Chrome

- Microsoft Edge

- Mozilla Firefox

## Assets

All the assets used (3D models, images etc.) are either using Creative Commons / Public Domain or they were created by me.

## 💖 Support the Project

Thank you so much for your interest in my project! If you want to go a step further and support my open source work, buy me a coffee:



## License



Copyright (c) 2023 Michael Kolesidis


Licensed under the [GNU Affero General Public License v3.0](https://www.gnu.org/licenses/agpl-3.0.html).