Skip to content

bendymochi/SafeSpace

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

78 Commits
 
 
 
 
 
 
 
 

Repository files navigation

SafeSpace: VR Mental Health Simulator

Overview

This project is part of the module CS4240: Interaction Design for Virtual and Augmented Reality under the School of Computing at the National University of Singapore (NUS).

You may view the project entry at iSTePS AY19/20 S2 here. Our promotional video which explains the features, challenges and gameplay of the simulator can also be found in this link.

Developed by Team SafeSpace.

Problem Statement and Solution

Mental health issues are increasingly rampant amongst people today with 1 out of 7 people in Singapore having experienced some form of mental disorder in their lifetime. Coupled with the heavy social stigma against mental disorders, there is a need to raise awareness about mental health issues as they can affect anyone, regardless of age, gender or race.

Developed using Unity, SafeSpace is a VR mental health solution that aims to bring a greater level of awareness and understanding of anxiety disorders through two main gameplay modes:

  • An anxiety simulator where users can step into the shoes of an anxiety sufferer in a stressful yet familiar office environment
  • A mindfulness solution in the form of a VR meditation therapy which has the goal of treating and controlling anxiety attacks and stress-related disorders

How to Run SafeSpace

The latest release (v1.1) can be found here. Download the release, unzip the file, and run SafeSpace.exe on your Windows machine.

Alternatively, you can clone the project and open it with Unity (Version 2019.3.3f1) and run the simulator from there.

Minimum Specifications & Software/Hardware

  • Windows 10 only
  • VR-enabled Graphics Card (NVIDIA GeForce 1060 minimum)
  • 1GB worth of space
  • SteamVR installed
  • Ensure that Tobii Service (TobiiXR) & SR_Runtime is running in order to play
  • HTC Vive Pro Eye or Tobii XR headsets with eye-tracking enabled*

*Recommended for a fuller experience

Potential errors in running

  • If you are running via Unity, the starting scene is SafeSpace/Menu/WarningScene, the scenes are found under Menu, Meditation or Simulation folders in SafeSpace under Assets
  • Ensure that your firewall or any other application is not blocking SR_Runtime or TobiiXR Runtime from running. You may have to download the plugins/SDK/Runtime at the respective websites should the application not work with your machine. Download links: TobiiXR, SR_Works
  • If you have downloaded the runtimes and it still does not work, try restarting your computer or restarting SteamVR as sometimes, they may fail to initialize/load properly.
  • If you do not have a headset with eyetracking capabilities (HTC Vive), SafeSpace will assume that your eyes are always looking forward. Pointers have been added in v1.1 for Meditation Mode and Main Menu for users to interact with the UI, should the eye-tracking fail during gameplay. However, the animations, UI feedback and interactions in Simulator Mode are still not implemented with the pointers (to be updated in later versions).
  • If you are running the project via Unity, be sure to place the Scenes back in the build indexes according to SceneIndexes.cs
  • The BuildIndexes should be in this order:
    • SafeSpace/Menu/WarningScene (index = 0)
    • SafeSpace/Menu/MainMenu (index = 1)
    • SafeSpace/Meditation/MeditationMenu (index = 2)
    • SafeSpace/Meditation/FlowersEnv (index = 3)
    • SafeSpace/Meditation/GrassEnv (index = 4)
    • SafeSpace/Menu/LoadingScene (index = 5)
    • SafeSpace/Simulation/StartingScreen (index = 6)
    • SafeSpace/Simulation/SimulationBeforePresentation (index = 7)
    • SafeSpace/Simulation/Simulation (index = 8)
    • SafeSpace/Simulation/EndingScreen (index = 9)
  • After exporting the package, ensure that you accept all necessary changes specified by SteamVR, SRWorks, ViveInputUtility
  • Ensure that 'Support Vive Pro Eye (Requires SRanpial SDK)' in TobiiXR Initializer found in the prefab 'CameraSet w Tracked' is checked

How to Play SafeSpace

  1. First, set up the eye callibration and ensure that you are seated upright. SafeSpace requires you to be seated for the whole duration of the experience.
  2. Run SafeSpace from the latest release or on Unity and ensure that Tobii XR Service and SR_Works Runtime are running.
  3. Turn on both controllers and ensure that audio is on. Ensure that you are always holding on to both controllers for a full experience.
  4. Should you feel any discomfort during gameplay, take off the headset immediately.

Controls

  • Gaze: To select
  • Right Controller Trigger: To interact/click
  • Menu Button: Pause Menu
  • D-pad Up: Toggle pointers on/off

Software/SDK/Assets/Audio used

All rights reserved to the respective owners of the assets used.

Software

  • Developed using Unity (2019.3.3f1)
  • SteamVR (1.11.11)

SDK

  • TobiiXR SDK
  • SRWorks & SRanipal SDK & ViveSR
  • Vive Input Utility
  • SteamVR/SteamVR_Input

Assets (Unity Store)

Audio

Credits

Special thanks to Amos (protagonist) for his contributions to the dialogue audio used in Simulator Mode.

Team SafeSpace (Group 7 CS4240 AY19/20 S2) members:

  • Sim Jun Yuen, Darren
  • Tan Mei Yen
  • Jaron Chan Jin Jia
  • Arthur Lee Ying Kiu

If you wish to extend the project, you can either submit a pull request or contact Darren (Kalsyc) here.

About

CS4240 Group Project - SafeSpace: VR Mental Health Simulator

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 96.0%
  • ShaderLab 3.2%
  • Other 0.8%