Skip to content

JI20/virtual-restitution

Repository files navigation

Virtual Restitution

Unity Render Pipeline Platform License License

Virtual Restitution is an interactive Virtual Reality experience designed to critique the colonial display of African artifacts. By moving through digital space, the user participates in the symbolic "repatriation" of objects—shifting them from sterile museum vitrines back to their living, functional, and spiritual contexts.


📂 Table of Contents


🏛️ The Experience: A Narrative of Return

The experience is structured as a psychological and spatial journey through three distinct phases:

  • The Sterile Void: A cold, foggy museum room. Artifacts are trapped in glass boxes, stripped of their history, highlighting the "wrongness" of these objects in a Western gallery.
  • The Archive & The Transit: An overwhelming archive of inaccessible history leads to a shipping container. This serves as a "reverse passage"—symbolizing the physical return of the objects to their origins.
  • Contextual Restoration: The journey ends in a warm Ghanaian evening. In a traditional setting, characters emerge to use the artifacts, restoring their functional and spiritual life through light, sound, and communal harmony.

🖼️ Impressions


🛠 Technical Details

Virtual Restitution was developed using Unity 6 (Version 6000.3.8f1) and utilizes the Universal Render Pipeline (URP) to handle its lighting and atmospheric effects, integrated with OpenXR for virtual reality support.

Installation & Setup

Warning

This repository uses Git LFS (Large File Storage) for high-resolution textures and 3D models. You must have Git LFS installed before cloning, otherwise, your assets will be broken.

  1. Install Git LFS.
  2. Run git lfs install in your terminal.
  3. Clone the repository: git clone https://github.com/JI20/virtual-restitution/
  4. Open the project in Unity 6000.3.8f1. Load the 'Main' Scene (found within the Scenes folder) and hit Play. Please ensure no other scenes are loaded simultaneously.

Features & Pipeline

  • Scene Management: We implemented a custom runtime SceneLoader script that handles the additive loading and unloading of the correct environments based on player progression.
  • Lighting & Post-Processing: The environments rely heavily on Baked Lighting to achieve smooth, realistic shadows where possible, combined with several active post-processing effects to transition the atmosphere from cold and sterile to warm and familiar.
  • Shaders: The spiritual/holographic characters are driven by a custom Fresnel Effect Shader Graph.
  • Audio: The project uses Spatial 3D Audio to ground the user in the narrative and guide them toward interactions.

VR Controls & Locomotion

For the best experience, standing up is highly recommended.

  • Movement: Smooth locomotion using the Left Thumbstick. While room-scale physical walking (a few steps) is supported, the environments are designed to be navigated via thumbstick movement.
  • Looking: Standard 6DOF headset tracking.
  • Note: The Right Controller is not actively needed to navigate this experience.

Desktop Fallback (Non-VR)

To speed up development and for accessibility, we built in support for running the project in a standard desktop mode. Without VR glasses, you can navigate the environment using WASD keys for movement and the mouse cursor to look around.

Building the project

Please note that we do not provide pre-built versions or executables; you will need to build from source.

While the project is structured to be buildable for either Windows (PCVR) or Android (Native Meta Quest), our primary development focus was on creating a high-fidelity PCVR game (using Meta's Horizon Link via Link Cable). We did not extensively test or optimize performance for native standalone VR builds on Android/Meta Quest.


📜 License & Attribution

This project is licensed under the Apache License 2.0.

If you use, share, modify, or redistribute this project (or any part of it), you must provide clear and visible credit to the original creators and explicitly state if changes were made to the original work.

For full details on your rights and obligations, please refer to the LICENSE.md file.


🏗️ Attributions

🗿 3D Models & Assets

📦 Unity Asset Store (Extension Asset License)

🎞️ Historical Documentation & Imagery

🎥 Educational Multimedia

🎨 Textures & Materials

About

Virtual Reality Experience made in Unity aiming to restitute the context of african art pieces in western museums.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors