Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation for VR Clients #133

Open
wants to merge 18 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 16 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
date: 2023-31-01
title: Introduction
aliases:
description: Intro to the DCL VR Client.
categories:
- Decentraland
type: Document
url: /player/general/DCL-VR-Client/DCL-VR-Client-Introduction
weight: 2
---

<b>

The Decentraland VR Client allows the a user to experience this Metaverse from within virtual reality!
</b>
This is where you will find instructions on how to set up and play Decentraland from your Meta Quest 2. In future sections, we will run through how to use Quest Link and the Oculus desktop app to play Decentraland on a PC/VR setup as well as show how you can side-load Decentraland directly onto you your Quest using SideQuest.

In certain ways, the decentraland VR-Client is not too different from the desktop version. In terms of how the world is setup, you will still be able to do things that other players can. The main difference is the way your viewing your environment (from within you headset), and how you interact with the world around you (with controllers instead of a keyboard and mouse).

You will also be able to sign in with your wallet, or opt to play as a guest. Fortmatic will be the easiest to log in on the headset as there is no way to scan QR codes in headset currently. For more information on the benefits of a
wallet vs signing in as guest, see the ["Get a Wallet for Beginners"](https://docs.decentraland.org/player/general/hardware-requirements/) page.



---

### **Compatible Headsets**

- Currently, the client only supports the <u> Meta Quest 2 </u> headset.

### **Known Issues**

- The downloads available are in an Alpha version state. A Decentraland architecture change has broken the current builds of the VR Clients on Quest and PCVR.


Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
date: 2023-31-01
title: PC/VR Decetraland
aliases:
description: How a user can set themselves up to play Decentraland using PC/VR.
categories:
- Decentraland
type: Document
url: /player/general/DCL-VR-Client/DCL-VR-Client-PCVRSetup
weight: 3
---

{{< hint warning >}}
**📔 Note**: If you're interested in playing the PC/VR version, refer to the [Hardware Requirements](https://docs.decentraland.org/player/general/hardware-requirements/) for more information about what your PC needs to be able to play Decentraland.
{{< /hint >}}

<b>

This section will help you get set to play Decentraland using PC/VR! We will walk through the steps we need to set up your headset, download the game, and launch it in your headset.

</b>

---

## Download the Quest App and Set Up Air Link on Your Meta Quest 2

Meta has already created some articles and documentation on many of the features of the Quest 2. To set up AirLink,



- See the [Meta Quest Link](https://www.meta.com/help/quest/articles/headsets-and-accessories/oculus-link/) page and scroll down to the "Air Link" section.

- The dropdown titled "Connect Meta Quest Pro or Meta Quest 2 to your PC with Air Link" has the instructions you need to get your Quest 2 set up with AirLink. It will also help you to set up with the Oculus App, which is a required dependency for Air Link.

- If you haven't already, open the Oculus app and navigate to the settings. Click on the "General" tab and check to see if Oculus is set to be the active OpenXR Runtime. If not, click "Set Oculus as Active."

- After you have completed this, proceed to download the latest version of [Decentraland for PC/VR](https://install.appcenter.ms/orgs/onginnovations/apps/decentraland-vr-pcvr/distribution_groups/public%20testers).



## Launch Quest Link and Play the Game
Once you have completed the previous steps, you should be ready to launch the Air Link and play the game. Follow the steps listed below to do just that!



- Open your universal Menu with the Oculus button on your right Touch controller. Navigate to your "Quick Settings" menu by hovering on the clock on the far left of the universal menu.

- Click on "Quest Link." Make sure that "Use Air Link" is enabled at the top.

- Select your PC from the "Available PCs" list and click Pair.

- You will see a pairing code appear in your headset. If you look back at your Oculus app, you should see the same pairing code. Click "Confirm" in the desktop app if it matches.

{{< hint warning >}}
**📔 Note**: If you do not see a paring code, ensure that your headset and desktop app are fully up to date.
{{< /hint >}}

- Click "Launch" back in the headset to start using Air Link.

- If you haven't already, unzip the DecentralandVR game file we downloaded earlier. Open the unzipped folder, and open the "DecentralandVR.exe" application.

{{< hint warning >}}
**📔 Note**: A window may pop up from windows defender saying that it blocked the app from opening since it was from an unknown publisher. Click "See More" or "More" and then click "Run Anyway."
{{< /hint >}}



You should now be able to play Decentraland in your Oculus Quest! You will be able to sign in with your Wallet or opt to play as a Guest. Refer to other sections in the documentation for more information on how to play Decentraland in VR.





Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
date: 2023-31-01
title: Decentraland on SideQuest
aliases:
description: How to use SideQuest to side load the VR client and play directly on the headset.
categories:
- Decentraland
type: Document
url: /player/general/DCL-VR-Client/DCL-VR-Client-SideQuestSetup
weight: 4
---

Did you know that you can also play Decentraland directly on your Meta Quest by sideloading the app through SideQuest?! If you don't already use SideQuest, this section will walk you through how to set it up, and use it to sideload the Decentraland app directly onto your headset.

## Get SideQuest

- To get started visit SideQuest's website and look at ["Get SideQuest"](https://sidequestvr.com/setup-howto). This page will give you all the information on how to set up an account and download SideQuest.
{{< hint warning >}}
**📔 Note**: You will need to enable developer mode onto your headset before you will be able to sideload apps. To do this, if you haven't already, you will need to first set up a developer account with Meta. These instructions should be outlined in the SideQuest setup documentation, but you can also follow Meta's instructions [here.](https://developer.oculus.com/documentation/native/android/mobile-device-setup/)
{{< /hint >}}

## SideLoad the DCL App
- After you have finished the SideQuest setup, open up SideQuest and head to the homepage. Once there, you should be able to search for "Decentraland VR" using the search bar the centered close to the top of your screen. Click on it to navigate to the game's main page.

- Connect your headset to the computer with a USB-C cable.
> *Double check that your headset is connected by looking to see if has the headset's name showing in the top left of your SideQuest window* (i.e. *"Oculus Quest 2"*).

- Once it's connected, in SideQuest, press the "Download App (SideLoad)" button to download the app on your headset. The app will notify you of when the install is completed.

## Play the Game!

- After the app has been downloaded, put on your headset and open the universal menu. Navigate to you App Library and open it.

- Head to the dropdown on the top furthest to the right, and switch to the the "Unknown Sources" section. Note that all of you sideloaded apps will appear under this section.

- Launch the "DecentralandVR" App.

You should now be able to play Decentraland in your Oculus Quest! You will be able to sign in with your Wallet or opt to play as a Guest. Refer to other sections in the documentation for more information on how to play Decentraland in VR.
4 changes: 4 additions & 0 deletions content/player/general/Decentraland-VR-Client/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
bookCollapseSection: true
weight: 21
---
2 changes: 1 addition & 1 deletion content/player/general/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ date: 2018-01-01
title: Introduction
description: Decentraland is a virtual reality platform powered by Ethereum.
aliases:
- /login?redirect=docs
- /login/redirect=docs
- /docs
- /docs/
- /decentraland/introduction/
Expand Down
2 changes: 1 addition & 1 deletion themes/documentation-theme
Submodule documentation-theme updated 1 files
+0 −0 serve.sh