Overlays guide

Customizing the HUD & Overlays

This guide covers how to access, configure, and create custom overlays in Visor, including details on overlay identity, general settings, pose transforms, and template-specific actions.

Quick Setup

To quickly attach your Minecraft HUD elements to your arms and hands:

• Go to VR Settings -> Presets.
• Select and apply the Defaults: Hand HUD preset. This preset splits your standard 2D HUD into sections across your arms, placing the top half of your HUD on your left hand and the bottom half on your right hand.

Accessing Overlay Settings

To manage or edit 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

• You can do more with overlays by making addons. Check out how to create an addon to get started.