Based on repository activity, growth velocity and community engagement.
27
Growth1/30
Activity8/25
Popularity1/25
Trust18/20
1
Stars
High
Sentiment
Votes
1
README.md
<a name="readme-top"></a>
<!-- PROJECT SHIELDS -->
<!-- PROJECT LOGO -->
<br />
<div align="center">
<a href="https://github.com/sebolsita/VR_MSc_5_Ai__Johny_Silverhand_AR">
<img src="https://i.ibb.co/7xhmFJ6/logio-productions2.png" alt="Logo" width="350" height="350">
</a>
<h3 align="center">Ai - Johny Silverhand in AR</h3>
<p align="center">
The project's objective is to create a mixed reality VR/AR application focused on AI-driven NPC interactions within a unique theme, featuring advanced dialogue systems and behavior modeling for an immersive storyline.
<br />
<a href="https://github.com/sebolsita/VR_MSc_5_Ai__Johny_Silverhand_AR"><strong>Explore the files »</strong></a>
<br />
<br />
<a href="https://youtu.be/4gqNRb5YoYY">View Demo</a>
·
<a href="https://github.com/sebolsita/VR_MSc_5_Ai__Johny_Silverhand_AR/issues">Report Bug</a>
·
<a href="https://github.com/sebolsita/VR_MSc_5_Ai__Johny_Silverhand_AR/issues">Request Feature</a>
</p>
</div>
<!-- TABLE OF CONTENTS -->
<details>
<summary>Table of Contents</summary>
<ol>
<li>
<a href="#about-the-project">About The Project</a>
<ul>
<li><a href="#assignment-objectives">Assignment Objectives</a></li>
<li><a href="#built-with">Built With</a></li>
</ul>
</li>
<li>
<a href="#installation-and-running-the-application">Getting Started</a>
<ul>
<li><a href="#windows-instructions">Windows</a></li>
<li><a href="#oculus-quest-standalone-instructions">Oculus Stand-Alone (Android)</a></li>
</ul>
</li>
<li><a href="#features">Features</a></li>
<li><a href="#roadmap">Roadmap</a></li>
<li><a href="#license">License</a></li>
<li><a href="#contact">Contact</a></li>
<li><a href="#acknowledgments">Acknowledgments</a></li>
</ol>
</details>
<!-- ABOUT THE PROJECT -->
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- GETTING STARTED -->
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- USAGE EXAMPLES -->
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- ROADMAP -->
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- LICENSE -->
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- CONTACT -->
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- ACKNOWLEDGMENTS -->
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<!-- MARKDOWN LINKS & IMAGES -->
<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
About The Project
Assignment Objectives
Objectives
AI-driven NPC Interaction: Implement NPC capable of complex interactions to enrich the user experience.
Advanced AI Techniques: Utilize behavior trees, finite state machines, and more to simulate lifelike NPC behaviors and crowd simulations.
Creative Storytelling: Design an engaging storyline within a specific theme, where dialogue choices lead to diverse narrative outcomes.
Documentation: Provide detailed project documentation, including development insights, AI in VR analysis, and a promotional video.
Develop an AR Application: For extra marks.
Built With
Installation and Running the Application
Windows Instructions
Locate the Downloaded File: Navigate to your Downloads folder or the location where you saved the downloaded .exe file.
Launch the Application: Double-click on Swansea Railway Station.exe to start the application.
Open the Application in Your VR Headset
For Oculus Quest (or Similar VR Headsets):
Connect Your Headset to the PC: If you haven't already, connect your Oculus Quest to your PC using a compatible USB-C cable. For a wireless connection, ensure that Air Link is properly set up and enabled on both your PC and headset.
Allow Access: If prompted on your headset, select 'Allow' to permit access to data from your PC.
Enable Oculus Link: On your Oculus Quest, enable Oculus Link via the prompt on the headset to access PC VR content. This step bridges your PC's VR application output directly to your headset.
Wear Your Headset: Once Oculus Link is enabled, put on your headset. You should see the PC VR environment displayed in your VR space.
Launch the Application: With the application already running on your PC, you should be able to access it directly from within the VR interface provided by Oculus Link or similar software for other headsets.
Ensure your VR headset is correctly configured and recognized by your PC. Refer to the headset's user manual or official support channels for specific setup instructions or troubleshooting steps.
Oculus Quest StandAlone Instructions
(Using SideQuest)
To install and run applications not available on the Oculus Store, you can use SideQuest. This is a useful tool for managing, installing, and browsing apps for Oculus Quest. Here's how to get started:
Enable Developer Mode on Oculus Quest
Open the Oculus app on your mobile device.
Select 'Settings' at the bottom right, then select your Oculus Quest headset and tap 'More Settings'.
Tap 'Developer Mode' and then switch it on. You may need to create a developer account if you haven't already done so.
Install SideQuest on Your Computer
Visit the SideQuest website and download the latest version of SideQuest for your operating system. Follow the installation instructions provided on their website.
Connect Your Oculus Quest to Your Computer
Use a high-quality USB cable to connect your Oculus Quest to your computer. If prompted on your Oculus Quest, allow USB debugging from your computer (you can check 'Always allow from this computer' to skip this step in the future).
Install the Application Using SideQuest
Open SideQuest on your computer.
Drag and drop the APK file for the application (you need to download the APK file for the Oculus Quest version of the application from the Releases section of this GitHub repository) into the SideQuest window to install it on your Oculus Quest.
Find and Run the Application on Oculus Quest
Put on your Oculus Quest headset.
Navigate to the 'Library' from the bottom menu.
Select the 'Unknown Sources' section to see all apps installed outside the Oculus Store.
Find and select the application (e.g., Swansea Railway Station) to start it.
Remember, applications installed through SideQuest or directly via APK may not appear in your regular Oculus Quest library. Always check the 'Unknown Sources' list to find and run these apps.
Features
Space to show useful examples of how a project can be used. Additional screenshots, code examples and demos etc. Link to more resources.
For more examples, please refer to the Documentation
Roadmap
[ ] Fix issues with canvas direction
[ ] Expand the story
[ ] Add assets for animation
[ ] Try to use chat-gpt instead of yarnScript
See the open issues for a full list of proposed features (and known issues).
License
Distributed under the CC BY-NC-ND 4.0 License. See LICENSE.txt for more information.
