{"id":18238273,"url":"https://github.com/manuelalejandrojimeneztorres/rollaball","last_synced_at":"2026-04-26T23:31:15.952Z","repository":{"id":269247796,"uuid":"889677797","full_name":"manuelalejandrojimeneztorres/RollABall","owner":"manuelalejandrojimeneztorres","description":"Roll-a-Ball 3D Game","archived":false,"fork":false,"pushed_at":"2024-11-20T15:26:57.000Z","size":11299,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-14T12:36:00.950Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manuelalejandrojimeneztorres.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-16T23:40:58.000Z","updated_at":"2024-11-20T15:27:00.000Z","dependencies_parsed_at":"2024-12-22T05:51:57.252Z","dependency_job_id":null,"html_url":"https://github.com/manuelalejandrojimeneztorres/RollABall","commit_stats":null,"previous_names":["manuelalejandrojimeneztorres/rollaball"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manuelalejandrojimeneztorres%2FRollABall","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manuelalejandrojimeneztorres%2FRollABall/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manuelalejandrojimeneztorres%2FRollABall/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manuelalejandrojimeneztorres%2FRollABall/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manuelalejandrojimeneztorres","download_url":"https://codeload.github.com/manuelalejandrojimeneztorres/RollABall/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247878023,"owners_count":21011158,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","csharp","game","game-development","game-engine","unity","unity3d","visual-studio"],"created_at":"2024-11-05T03:04:48.864Z","updated_at":"2026-04-26T23:31:15.925Z","avatar_url":"https://github.com/manuelalejandrojimeneztorres.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Roll-a-Ball 3D VR Game\n\nAn enhanced version of the classic _Roll-a-Ball_ game, now featuring **Virtual Reality (VR)** integration and a multi-level gameplay experience. Built using **Unity 2022.3.50f1**, this project leverages modern VR technologies, including **XR Interaction Toolkit**, **OpenXR**, and **XR Plug-in Management**, to deliver immersive gameplay with advanced VR functionalities such as teleportation, locomotion, object interaction, and gesture controls.\n\n## Table of Contents\n\n- [Project Description](#project-description)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n- [Features](#features)\n  - [Core Game Mechanics](#core-game-mechanics)\n  - [Virtual Reality Features](#virtual-reality-features)\n- [Built With](#built-with)\n- [License](#license)\n- [Acknowledgments](#acknowledgments)\n\n---\n\n## Project Description\n\nThis project extends the _Roll-a-Ball_ game into a full-fledged VR experience with four challenging levels, culminating in a **VR-enabled Level 4**. Players can interact with the environment using VR controllers, explore the game world with teleportation and smooth locomotion, and engage with objects dynamically using XR technologies. Whether you’re a gamer or a VR enthusiast, this project provides an engaging platform to experience advanced Unity VR development.\n\n[🔼 Back to Top](#table-of-contents)\n\n---\n\n## Getting Started\n\nFollow these steps to clone, build, and explore the project on your local machine.\n\n### Prerequisites\n\nEnsure the following tools are installed on your system:\n\n- **Unity 2022.3.50f1**  \n  Download from [Unity's official website](https://unity.com/releases/2022-lts).\n- **Git**  \n  Download from [Git's official website](https://git-scm.com/downloads).\n- **VR Headset**  \n  Compatible with OpenXR (e.g., Oculus Quest, HTC Vive, etc.).\n- Optional: **Visual Studio** or **JetBrains Rider**  \n  For editing and debugging C# scripts.\n\n[🔼 Back to Top](#table-of-contents)\n\n---\n\n### Installation\n\n1. **Clone the Repository**\n\n   ```bash\n   git clone https://github.com/manuelalejandrojimeneztorres/RollABall.git\n   ```\n\n2. **Open the Project in Unity**\n\n   - Open **Unity Hub** and select **Open Project**.\n   - Navigate to the cloned directory and select the project.\n   - Ensure **Unity 2022.3.50f1** is selected as the project version.\n\n3. **Configure Build Settings**\n\n   - Go to **File \u003e Build Settings** and select the desired platform (e.g., PC or VR-supported platforms like Android for Oculus).\n   - Add all necessary scenes to the build.\n\n4. **Run the Game**\n   - Open the scene `Assets/Scenes/StartMenu.unity`.\n   - Click **Play** in the Unity Editor or build the project to test it on your VR device.\n\n[🔼 Back to Top](#table-of-contents)\n\n---\n\n## Features\n\n### Core Game Mechanics\n\n1. **Multi-Level Gameplay**\n   - Four unique levels, each progressively challenging.\n   - Collectible items to achieve level objectives.\n2. **Enhanced Player Controls**\n\n   - Restriction-based jumping to prevent unintended exits from the play area.\n   - Keyboard shortcuts and UI buttons for accessible navigation.\n\n3. **Immersive Audio Feedback**\n\n   - Collision sound effects enhance the gaming experience.\n\n4. **Accessible Gameplay**\n   - Buttons for restarting levels, transitioning to the next level, and returning to the main menu.\n\n| Button       | Action                       |\n| ------------ | ---------------------------- |\n| `Resume`     | Resume the game              |\n| `Restart`    | Restart the current level    |\n| `Next Level` | Transition to the next level |\n| `Start Menu` | Return to the start menu     |\n\n[🔼 Back to Top](#table-of-contents)\n\n---\n\n### Virtual Reality Features\n\n**Available in Level 4:**\n\n1. **Locomotion Systems**\n\n   - Teleportation and continuous movement for navigating the environment.\n\n2. **Interaction Features**\n\n   - XR Ray Interactor for object interaction.\n   - Snap Turn and Continuous Turn for rotation.\n   - Object grabbing, manipulation, and throwing using VR controllers.\n\n3. **Controller and Gesture Support**\n\n   - Full VR controller support for actions like grabbing and rotating objects.\n   - Hand gesture recognition for intuitive controls.\n\n4. **Immersive XR Setup**\n   - Configured with **XR Plug-in Management** and **OpenXR** for cross-platform compatibility.\n   - **XR Rig** for accurate VR interaction.\n\n[🔼 Back to Top](#table-of-contents)\n\n---\n\n## Built With\n\n- **Unity 2022.3.50f1**  \n  Game engine for 3D development.\n- **XR Interaction Toolkit**  \n  Provides XR-specific components and interaction systems.\n- **OpenXR**  \n  Ensures compatibility with various VR hardware.\n- **C#**  \n  Primary programming language for game logic and mechanics.\n- **Git**  \n  Version control for project management and collaboration.\n- **Visual Studio / Rider**  \n  Recommended IDEs for script editing and debugging.\n\n[🔼 Back to Top](#table-of-contents)\n\n---\n\n## License\n\nThis project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.\n\n[🔼 Back to Top](#table-of-contents)\n\n---\n\n## Acknowledgments\n\n- **Unity Technologies**  \n  For the original _Roll-a-Ball_ tutorial and XR tools.\n- **Tiburcio Cruz Ravelo**  \n  For mentorship and support throughout the project.\n- **Microsoft Corporation**  \n  For providing a robust development environment with Visual Studio 2022 Community Edition IDE.\n- **OpenXR and XR Toolkit Documentation**  \n  For detailed guidance on implementing advanced VR features.\n\n[🔼 Back to Top](#table-of-contents)\n\n---\n\nEnjoy the immersive gameplay and explore the world of VR with **Roll-a-Ball VR**!  \nFeel free to contribute to the project or share your feedback. Happy gaming! 🎮\n\n[🔼 Back to Top](#table-of-contents)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanuelalejandrojimeneztorres%2Frollaball","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanuelalejandrojimeneztorres%2Frollaball","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanuelalejandrojimeneztorres%2Frollaball/lists"}