Skip to main content

​
Controls

The RoadVR headset

​
Two modes

RoadVR always runs in one of two modes, and knowing which one you are in explains almost every question about the controls.

Passthrough

Windows float around you. You walk, drive and play normally — the windows are pure graphics and take no input.

Focus

The mouse is free and you can click. Movement is locked while you are in it — except while you hold a window’s grabber, which lets you walk and carry the window along.
You enter focus mode by looking at a window and pressing E, and you leave it with ESC. Nothing is torn down on the way out — the windows stay exactly where they were.
The headset only goes on in first person. Switching to third person while it is on takes it off again — flying the drone is the exception. Servers can turn this off with Config.FirstPersonOnly = false.

​
The keys

F7, F6, roadvr_toggle and roadvr_widgets are FiveM keybinds: each player can rebind them under Settings → Key Bindings → FiveM, and what config.lua sets is only the default. The focus key is not — it reads a fixed game control, so Config.FocusKey accepts E, G, X, F or H and falls back to E for anything else.
F7 does a little more than open the home screen: in a car with the cockpit bar enabled it shows and hides the bar in the windshield, and if the home screen is already open but far behind you, it brings it back in front. ESC also closes the widget editor, and while an environment is running it opens a small menu in passthrough: Resume, Open map and Leave environment.

​
The unbound keys

roadvr_toggle and roadvr_widgets appear in the FiveM key bindings and are deliberately shipped without a default key. That is not an oversight. A default would take a key away from every server that installs RoadVR. Most servers hand the headset out as an item anyway, and the widget editor has its own button on the home screen. If you run without an item (Config.Item = ''), tell your players to bind roadvr_toggle once themselves — or use the command:
When no window is near, a hint at the bottom of the view reads “Press F7 to open the home screen” — with whatever key the player actually bound. Nobody is left wearing a headset that shows nothing.

​
The window bar

Every window has a bar of controls hanging below it. It appears when you look at the window, and from left to right it holds: The home screen’s own bar carries a Widgets button in place of Home.

​
Moving windows

A window hangs on a sphere around the player rather than in free 3D space, so dragging the grabber moves it along that shell.
  • Distance: the mouse wheel over the grabber pulls the window closer or pushes it away, in 0.2 m steps between 0.8 m and 6 m.
  • Size: move the pointer near a corner and an arc appears — drag it. The window keeps its proportions.
  • Facing: with Windows turn with you on (the default, in Settings → Windows) a window always faces you. Switched off, it keeps the direction it was placed in.
While Move all is on, every grab handle is tinted, because an invisible mode that changes what dragging does is a trap.

​
Anchors

Two anchor modes decide what happens when you walk away:

Come along

The window follows you once you are 2 m away or have turned 45°. Good for anything you want to keep reading while you move.

Stay in place

The window stays where you put it. Good for leaving a screen on a desk.
New windows stay in place by default. Each player changes that under Settings → Windows → New windows, and every window can be switched on its own with the anchor button in its bar. A window you drag and let go of is pinned in the room where you left it.

​
How many windows

Config.MaxPanels (4) caps the app windows that can be open at once. The home screen, Spaces and the car’s displays do not count. Opening one more closes the oldest, with a notification saying so.

​
Widgets

Open the widget editor with the Widgets button under the home screen, the Widgets switch in the Control Centre, or /roadvr_widgets.
1

Pick a widget

The bar shows how many you have up out of your limit. Widgets with content — a note, a photo, a sign — open a sheet first; Hang it up when it is ready.
2

Place it

The widget follows your gaze. The mouse wheel resizes it, left click sticks it to the wall, right click cancels.
3

Change it later

In the editor, click a widget on the wall to take it off, use the pencil to change its contents, choose another widget to swap it in the same spot, or remove it with ✕. Done or ESC closes the editor.
Widgets live in the player’s profile, so they survive taking the headset off, relogging and a resource restart.

​
Learn it in game

Window basics is a short interactive tutorial that walks through focusing, grabbing, distance, tilt, resizing, anchors, Move all and Arrange. It is offered at the end of the first setup and can be started again from Settings → General → Try the window tutorial. It puts your open windows away while it runs and brings them back afterwards.

Apps & Widgets

Everything that ships with the headset