Skip to content

Explore overte#69

Open
zedwick wants to merge 52 commits intooverte-org:masterfrom
zedwick:explore_overte
Open

Explore overte#69
zedwick wants to merge 52 commits intooverte-org:masterfrom
zedwick:explore_overte

Conversation

@zedwick
Copy link
Copy Markdown
Contributor

@zedwick zedwick commented Jan 30, 2026

Updates the Explore section to better reflect the current features and design of Overte.

  • Reword and update terminology to better reflect Overte's
  • Update to match the current Overte experience
  • Expand documentation to cover more features
  • Document interacting, modifying and saving werables
  • Improve clarity around some features
  • Remove references to macOS
  • Remove references to Android
  • Simplify Windows OS instructions by linking to Microsoft support articles
  • Update controls reference
  • Add Ada's Body Poser app as an example of an installable app
  • Replace Vircadia references
  • Update in-game UI screenshots
  • Add image of placed portals
  • Some pages have been converted from markdown to reStructuredText where I felt it would make it easier for the changes I intended to make.

I do not have access to VR myself, so for much of the VR-specific parts I had to read code, changelogs and interview people who have had experience with it on Overte. I may have gotten something wrong here, so would especially appreciate if someone with access to VR could double-check it works as stated.

Similarly for Windows, I do not have access to Windows but tried to confirm those parts the best I could. If someone with Windows could double check them for me I would appreciate that.

to something a little more recent; from 2025 rather than 2022.
* Encourage users to use push-to-talk
* Re-arrange settings table to match the order seen in the audio settings tablet window
* Add missing audio settings to table
* Cyberspace!
* OpenVR and OpenXR support
* Add missing control settings
* Update some terminaology
Also correct table issue in vr-controls
* Expand list of files which make up an avatar
* Rewrite introduction to emphasise how choosing an avatar empowers the user to express themself
* Provide more detail on where to host an avatar, without emphasising individual brands
* Mention all compatible model files
* Document grabbing wearables
* Document modifying wearables, including that modifications will be saved when favourited
* Document favouriting avatars with wearables
* Corrected information about updating apps
* Some tweaking to wording and expanded explanation
* Removed section on the no-longer-available Text to Speech app
* Include screenshots for the current Places app
* cover filtering, bookmarks, portals and home
* Remove erroneous orphaned row of Graphic Settings table
@JulianGro
Copy link
Copy Markdown
Member

For your information, I was debating removing the system requirements in source/explore/get-started/install.rst. I believe they are doomed to always be out of date.
They are never entirely accurate either; The GPU requirements are different between Windows and Linux for example. Even within Linux, the GPU requirement sometimes depends on your driver version.

zedwick added 5 commits March 20, 2026 18:30
* Include context menu button
* Use Roboto font to match upcoming UI change
* Change fonts to Roboto to match upcoming UI change
@zedwick zedwick marked this pull request as ready for review March 23, 2026 20:49
@zedwick
Copy link
Copy Markdown
Contributor Author

zedwick commented Mar 23, 2026

I think I'll leave the system requirements alone, and let them be updated/removed in a separate PR.

Copy link
Copy Markdown
Member

@JulianGro JulianGro left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am only half-way done with the review, but I thought I should show what I have already.

Comment thread source/explore/get-started/adjust-settings.rst Outdated
Comment thread source/explore/get-started/adjust-settings.rst Outdated
Comment thread source/explore/get-started/adjust-settings.rst
Comment thread source/explore/get-started/adjust-settings.rst
Comment thread source/explore/get-started/adjust-settings.rst Outdated
Comment thread source/explore/get-started/install.rst
Comment thread source/explore/get-started/install.rst Outdated
Comment on lines 46 to 50

Unfortunately, bluetooth audio devices do not currently support stereo input. Therefore, you have two options:

* Use the bluetooth headset as an output device only, and use another microphone for input. This allows you to take advantage of the stereo audio.
* Use the bluetooth headset's built-in microphone. In this case, other users will only experience mono sound coming from you, rather than the normal stereo audio.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Use the bluetooth headset's built-in microphone. In this case, other users will only experience mono sound coming from you, rather than the normal stereo audio.

Do we care about this? Stereo audio input has to be enabled and breaks spatial audio (distance works, but direction does not). In my opinion stereo input should only be used for injecting audio streams.

A more interesting topic would be if we can avoid Bluetooth devices enabling their microphones and changing away from high fidelity audio mode because of that.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I found the talk about stereo audio confusing, because it seems to suggest most microphones produce stereo audio which was not the case as far as I knew.

Comment thread source/explore/get-started/setup-audio.rst Outdated
Comment thread source/explore/get-started/setup-audio.rst Outdated
Copy link
Copy Markdown
Member

@JulianGro JulianGro left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some small things and nitpicks.

As mentioned in the comments, with the American English versus British English differences, I think it makes sense to just stay with American English as to not mix the two of them. American English is probably a better choice for an international audience anyway, because it has easier spelling and fewer exceptions.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I assume you remade the text to add the context menu button, but I don't see the context menu being mentioned here. Did you forget to add it?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I left it off because as I understand it there isn't a button on those controllers for it at the moment.

+------------------------------------------------+---------------------+
| Windows MR | XBox One Controller |
+------------------------------------------------+---------------------+
To get the best and most immersive experience in Overte, we encourage you to use VR equipment, such as the HTC Vive. With these HMD devices and hand controllers, you will be able to interact with people in 3D, track body movements, and engage with the objects around you. We support both OpenVR and OpenXR, which means we support most currently available HMDs and hand controllers.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To get the best and most immersive experience in Overte, we encourage you to use VR equipment, such as the HTC Vive. With these HMD devices and hand controllers, you will be able to interact with people in 3D, track body movements, and engage with the objects around you. We support both OpenVR and OpenXR, which means we support most currently available HMDs and hand controllers.
To get the best and most immersive experience in Overte, we encourage you to use VR equipment, such as the Steam Frame. With these HMD devices and hand controllers, you will be able to interact with people in 3D, track body movements, and engage with the objects around you. We support both OpenVR and OpenXR, which means we support most currently available HMDs and hand controllers.

I don't think we should mention the HTC Vive, as it comes across as a suggestion and the HTC Vive is probably one of the worst HMDs you can get nowadays.
We could remove the mention of a particular VR headset, change it to the Valve Index since that is probably what most people would be happy with, or assume the Steam Frame is going to be good and just put it in there for when it eventually gets released.
We could also add a buyers guide, since there are some really low budget options on the used market, but maybe later.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we should mention a headset we hope to support in the future. The docs should represent the current state of Overte.
I do like that there is some example here, but it would be easier to maintain the docs if we didn't include specific examples like this.
A buyers guide would be great, or we could link to an external list of VR devices like Linux VR Adventures Wiki

+------------------------------------------------+---------------------+
To get the best and most immersive experience in Overte, we encourage you to use VR equipment, such as the HTC Vive. With these HMD devices and hand controllers, you will be able to interact with people in 3D, track body movements, and engage with the objects around you. We support both OpenVR and OpenXR, which means we support most currently available HMDs and hand controllers.

We recommend you use SteamVR, which should allow you to use any VR equipment you choose. Monado and Wivrn are also supported, as are any OpenVR or OpenXR runtimes.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
We recommend you use SteamVR, which should allow you to use any VR equipment you choose. Monado and Wivrn are also supported, as are any OpenVR or OpenXR runtimes.

Do we want to mention this? On Linux, SteamVR generally doesn't work. To quote the LVRA wiki: "SteamVR is not recommended for any device(...)"
We could either expand on this and tell people to use Wivrn or Monado on Linux, and whatever they want on Windows, or we could just leave this.
On Windows, I had good luck with VDXR (Virtual Desktop) as well, and would recommend Quest users to use that over SteamVR.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm going to remove mention of particular runtimes here, and instead just recommend OpenXR over OpenVR. I am told OpenVR has been causing users issues, so encouraging use of OpenXR is probably the most important point here.

You can enhance your Overte experience using full body motion capture (mocap). Overte currently supports mocap using HTC Vive Trackers.
You can enhance your Overte experience using full body tracking (FBT), also known as full body motion capture (mocap). Overte currently supports FBT using any trackers compatible with OpenVR or OpenXR runtimes, including the HTC Vive Trackers.

.. note:: Whilst Overte supports full body tracking in both OpenVR and OpenXR, for best compatibility we recommend you use SteamVR runtime for accurate body tracking.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
.. note:: Whilst Overte supports full body tracking in both OpenVR and OpenXR, for best compatibility we recommend you use SteamVR runtime for accurate body tracking.
.. note:: Whilst Overte supports full body tracking in both OpenVR and OpenXR, for best compatibility we recommend you use OpenVR with SteamVR runtime for accurate body tracking.

I believe body tracking on OpenXR with SteamVR currently doesn't work at all. I haven't tested it in months though.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, apparently OpenXR body tracking partially works, but not at all when used with SteamVR.

OpenVR body tracking works well, so I am recommending it be used here - do you think we should just not mention SteamVR at all here? It seems like you are reading it as "when using SteamVR you should use OpenVR, as body tracking is more accurate than OpenXR with SteamVR" which wasn't my intention. Maybe mentioning SteamVR is just confusing things, and we should just not mention it.

Comment thread source/explore/personalize/install-apps.rst Outdated
You can edit any property of your wearable, just like any other object in the domain. Give it a name, shift its position in relation the joint it is attached to, give it an animation or attach an entity script. Your modifications will remain until you switch avatar.

----------------------------------------
Favourite Wearables for your Avatar
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Favourite Wearables for your Avatar
Favorite Wearables for your Avatar

Favourite Wearables for your Avatar
----------------------------------------

So you have added a wearable or two as accessories for your current avatar, and you like them so much you just know you will be wearing them all the time? It's time to save them as a set with your favourite avatar.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
So you have added a wearable or two as accessories for your current avatar, and you like them so much you just know you will be wearing them all the time? It's time to save them as a set with your favourite avatar.
So you have added a wearable or two as accessories for your current avatar, and you like them so much you just know you will be wearing them all the time? It's time to save them as a set with your favorite avatar.


So you have added a wearable or two as accessories for your current avatar, and you like them so much you just know you will be wearing them all the time? It's time to save them as a set with your favourite avatar.

When you add an Avatar as a favourite, it will also save any wearables you have added along with it. So whenever you change your set of wearables be sure to press **Add to favorites** to save them as a favourite set. Then whenever you load it from your favourites again, your wearables will load along with it!
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When you add an Avatar as a favourite, it will also save any wearables you have added along with it. So whenever you change your set of wearables be sure to press **Add to favorites** to save them as a favourite set. Then whenever you load it from your favourites again, your wearables will load along with it!
When you add an Avatar as a favorite, it will also save any wearables you have added along with it. So whenever you change your set of wearables be sure to press **Add to favorites** to save them as a favorite set. Then whenever you load it from your favorites again, your wearables will load along with it!


When you add an Avatar as a favourite, it will also save any wearables you have added along with it. So whenever you change your set of wearables be sure to press **Add to favorites** to save them as a favourite set. Then whenever you load it from your favourites again, your wearables will load along with it!

.. note:: Changes made to your wearables are not automatically saved to your favourites. You must **Add to favorites** again to save changes after grabbing, modifying, adding or removing wearables.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
.. note:: Changes made to your wearables are not automatically saved to your favourites. You must **Add to favorites** again to save changes after grabbing, modifying, adding or removing wearables.
.. note:: Changes made to your wearables are not automatically saved to your favorites. You must **Add to favorites** again to save changes after grabbing, modifying, adding or removing wearables.

| Paste Entity | ``CTRL`` + ``V`` |
+-------------------------------------------+-------------------------------+
| Toggle Global/Local Translation | ``T`` |
| Toggle Local/World Mode | ``T`` |
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I opened a PR to change it. Unless it does more than just change the transforms, I think it is worth to change it. overte-org/overte#2257

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants