Skip to content

Overlays guide

Jump to bottom
Phoenix-Ra edited this page Aug 31, 2026 · 11 revisions

WIKI is in development, some topics might not be finished or missing

What are overlays

Overlays are 2D graphical user interfaces for VR. Powerful Visor feature, highly customizable.

Overlay Types:

Built-in overlays - Created by Visor or Visor addons.

They are limited in options, some of them don't even have options at all. For example: keyboard, hotbar, movementState

Custom overlays - Created and fully controlled by you!

They are based on overlay template - it is a foundation of custom overlay, providing its logic and customization options.

Getting started

To manage your overlays:

  • Open VR Settings.
  • Select Setup Overlays (VR).

Overlays Overview

Visor features both built-in overlays and support for custom user created overlays.

Creating a Custom Overlay

  • Navigate to the Create Overlay tab.
  • Select one of the three available Template Types:
    • HUD
    • Button
    • Chat
  • Set an Overlay ID: The Overlay ID serves as Visor's internal identifier and becomes the filename for its .json configuration file.
  • Multiple custom overlays can be created using the same template type (for example, creating 3–4 distinct HUD overlays).

Overlay Settings

When editing an overlay, options are organized into the following tabs:

Identity

  • Name & Description: Custom labels for identifying the overlay.
  • Icon: Accepts resource file paths to display custom textures (e.g., minecraft:textures/item/bundle.png renders an open bundle texture). You can reference texture paths using a Template Resource Pack on Curseforge.

Visibility

  • Toggle: Controls whether the overlay is currently active or hidden.

General

  • HUD Layer: Toggle to render the overlay on top of standard world objects and menus.

Pose & Scale

  • Anchor: Attaches the overlay to a relative reference point:
    • None - Hides the overlay.
    • HMD - Anchors the overlay to your head/headset.
    • MainHand - Anchors the overlay to your right hand.
    • Offhand - Anchors the overlay to your left hand.
  • Position Sliders (X, Y, Z): Adjusts offset relative to the anchor point.
  • Rotation Sliders (X, Y, Z): Adjusts orientation. A 180 degree rotation is approximately Pi, 3.14159. A 90 degree rotation is approximately 1.57079, half of Pi.
  • Rotation Aimed: Forces the overlay to face its anchor point dynamically.
  • Scale: Sets the overall physical size of the overlay. Default is 0.15.
  • Hand Lock Tool: Clicking the lock button on the bottom right anchors the overlay to your physical hand; pulling the trigger drops and places it at your hand's current position.
  • Copy Transform: Use the green copy button on the right to duplicate current position and rotation values.

Template Types & Specific Settings

1. HUD Template

Captures a specific 2D screen region from the standard Minecraft HUD and projects it into 3D space.

  • Settings: Manual X, Y, Width, and Height sliders, or click and drag directly on the screen preview to select a region.

2. Button Template (updated in 0.5.0)

Creates an interactive touch button in VR space that executes specific actions when pressed.

  • Settings: Width, Height, Button Text, Text Color, Visibility (Always or In Game), Button Color/Texture(e.g., minecraft:textures/item/bundle.png).
  • Actions:
    • Keyboard Keybind (e.g., press R for weapon mods to reload)
    • Run a Command
    • Toggle Visibility of other overlays
    • VR Keybind

3. Chat Template

Displays the Minecraft chat box as a standalone VR overlay.

  • Settings: Update Options (Tick, Frame, or Off).

Expansion on Overlays

Clone this wiki locally