Settings in Hololight Space

Contents

Objectives
Prerequisites
Settings
- Open settings
  - Open settings through Scene View
  - Open settings through an active XR session
- All settings in Hololight Space

Objectives

View all available settings in Hololight Space
Understand how to change settings in Hololight Space

Prerequisites

Hololight Space 2026.0.0.0
Windows computer with Hololight Space installed

Settings

Open settings

There are two ways to access settings in Hololight Space. You can do this either through Scene View or when connected to an active XR session.

Open settings through Scene View

Open Hololight Space on your Windows computer.
Select Scene View in the left sidebar.
Press 5 on your keyboard to open the settings menu.

Open settings through an active XR session

Open Hololight Space.
Connect to Hololight Space with Hololight Stream Client on your XR device.
Open Quick Menu by looking at the palm of your hand.
Select Options.
Select Settings to open the settings menu.

All settings in Hololight Space

The 2026.0.0.0 release of Hololight Space introduces a lot of new settings. This includes both new and improved features. Settings are sorted into different sections to make it easier for users to find the settings they need.

Changes to settings are automatically saved when you change them or close the settings menu. Changed settings are automatically highlighted in orange to make it easier for users to identify which settings they have changed. After closing Settings, you can still see the changed settings highlighted in bold. You can also reset settings to their default values by selecting the Reset all button at the bottom-right corner of the settings menu.

General settings

General settings
Setting	Default value	Description
Language	English	Select the language for the Hololight Space user interface. Currently supported languages include English, German, and Japanese.
Selection color	Green	Change the color that highlights selections in Hololight Space.
Show welcome panel	On	Enable or disable whether the welcome panel appears when Hololight Space starts.
Start in scene view	off	Skips the server connection tab and starts Hololight Space in Scene View.
Show space origin	Visible	Options include Visible, Always visible (Through 3D models and menus), and hidden.
Show 3D hand	On	Enable or disable whether 3D hand models overlay your actual hands in Hololight Space.

General settings - Space
Setting	Default value	Description
Export .hl3d file on save	Off	When enabled, Hololight Space converts all 3D models to a .hl3d file each time you save your space. When disabled, Hololight Space saves the directory path of the models in the space.
Unit	Metric	Change the unit of measurement used in Hololight Space. Options include Metric and Imperial.
QR code object alignment	Center	Change the alignment position of QR codes. Options include Center and Top Left.

General settings - Import
Setting	Default value	Description
File type	JT	Choose the file type whose import behavior you want to configure with the settings below. Options include JT, FBX, OBJ, glTF, HL3D, .PAR .PSM, Catia v5, STEP, STL, USD, PRT, ASM, Inventor, Assetbundle, IFC.
Unit	Meter	Change the default import unit of measurement for the selected file type. Options include Kilometer, Meter, Centimeter, Millimeter, Mile, Inch, and Foot.
Scale	1:1	Change the default import scale for the selected file type.
Up vector	Y	Change the default import up vector for the selected file type. Options include X/Y/Z and -X/-Y/-Z.
Coordinate system	Left Handed	Change the default import coordinate system for the selected file type. Options include Left Handed and Right Handed.
Mirror axis	None	Change the default import mirror axis for the selected file type. Options include X/Y/Z.

Meeting

Meeting settings - Avatar
Setting	Default value	Description
Show full avatar	On	Enable or disable the display of a full avatar in meetings. When disabled, only the name of the participant is shown.
Show name	On	Enable or disable the display of participant names in meetings.

Meeting settings - File sharing
Automatically share objects	On	When enabled, models that are imported to the space are automatically shared with other participants. When disabled, you receive a prompt to choose whether to share an imported model with other participants.
Automatically receive objects	On	When enabled, models that are imported by other participants are automatically received and displayed in your space. When disabled, you receive a prompt to accept or reject the shared models.

Meeting settings - Meeting
Setting	Default value	Description
Connection port	18235	Change the connection port for meetings, if the port is already in use by another application.
Broadcast port	18250	Change the broadcast port for meetings, if the port is already in use by another application.
Max. port multiple instances	18240	Change the maximum port number for multiple instances of Hololight Space. Starting more instances of Hololight Space increases the default port of 9999 by 1 until it reaches the maximum port number.
Minimum TCP port	20000	Change the minimum TCP port number for meetings, if the default port is already in use by another application.
Maximum TCP port	20050	Change the maximum TCP port number for meetings, if the default port is already in use by another application.
Hololight Space Spectator connection port	10090	Change the connection port for Hololight Space Spectator, if the port is already in use by another application.

Environment

Environment settings in Hololight Space allow you to customize the appearance of your space. These settings mostly affect the appearance and controls of full VR mode and Scene View.

Environment settings - Scenery
Setting	Default value	Description
Skybox	Default Skybox	Change the skybox of your space. Options include 3 different default skyboxes and the option to add custom skyboxes.
Floor color	Transparent	Change the floor color of your space. Options include Transparent, White, Grey scale, and Black.
Floor height	0	Change the height of the floor in your space. Options include values from -4m to 4m.
Floor teleport	On	Enable or disable the floor teleport in your space.

Environment settings - Grid
Setting	Default value	Description
Minor grid color	White	Change the color of the minor grid lines in your space.
Major grid division	10	Change the size of a major grid element. Options include values from 2 to 10.
Major grid color	White	Change the color of the major grid lines in your space. Options include Transparent, White, Grey scale, and Black.
Grid alpha	0.8	Change the transparency of the grid lines in your space. Options include values from 0 (fully transparent) to 1 (fully opaque).

Environment settings - Teleport
Setting	Default value	Description
Enable teleport mode	On	Enable or disable teleport mode in your space.
Movement comfort	Off	When enabled a screen fade appears during teleportation to reduce motion sickness.
Turn style	Snap	Changes the turn style for teleportation. Options include Snap and Smooth.

Environment settings - Flight mode
Setting	Default value	Description
Flight Mode	On	Enable or disable flight mode. Only available when using controllers.
Movement comfort	On	When enabled a tunneling vignette effect appears during flight to reduce motion sickness.
Movement direction	Head-directed	Changes the forward direction for teleportation. Options include Controller-directed and Head-directed.
Turn style	Smooth	Changes the turn style for flight mode. Options include Snap and Smooth.
Speed modifier	3x	Changes the speed modifier for flight mode. Options include a slider from 1x to 9x.

Environment settings - Walking mode
Setting	Default value	Description
Walking mode	On	Enables or disables walking mode. When enabled, you can fly, but vertical movement is disabled to simulate walking. Requires a controller.
Movement comfort	Off	Enables a tunneling vignette effect during flight to reduce motion sickness.
Movement direction	Controller-directed	Changes the forward direction for flight mode. Options include Controller-directed and Head-directed.
Turn style	Smooth	Changes the turn style for flight mode. Options include Snap and Smooth.

Interaction

Interaction settings - Visuals
Setting	Default value	Description
Far ray distance	100	Changes the distance of the far ray for part selection and interaction. Higher values impact amount of physics calculations and may reduce performance.
Enable selection preview (XR only)	On	When enabled models or parts are highlighted when they are about to be selected.
Enable cursor hovering (XR only)	On	When enabled, your ray cast cursor hovers over surfaces when you point at them, making it easier to select models.
Isolate selection during remove (XR only)	On	When enabled unselected models are temporarily hidden when you are in remove mode.

Interaction settings - Convenience
Setting	Default value	Description
Repeated click behavior	Hierarchy	Controls what happens when you repeatedly click a part in select part mode. Hierarchy selects progressively higher parent parts up to the root. Depth selects parts behind the currently selected part.
Clear selection on void click	On	When enabled, clicking on an empty area clears the current selection. When disabled, clicking on an empty area doesn’t affect the current selection. Both in XR and in Scene View.
Smart selection for 'Triangle Set'	On	Skips the "Triangle Set" geometry during selection and redirects selection to the sets parent, which holds the actual data.
Auto-select confirmed imports	On	Automatically selects imported models after they are confirmed in the loading cube.
Auto-select single model	On	Automatically selects a model if it is the only model in the space.
Auto-start selection mode (XR only)	Off	Automatically starts a selection mode when you enter a space. When disabled, you need to manually enable a selection mode. Options include Off, Select parts, Select model, Intersect, Remove and Add.
Use bubble up for inversions	On	Also selects parent elements when all their children become selected during inversion.

Interaction settings - Interaction panel defaults (XR Only)
Setting	Default value	Description
Default XR user smart bubble up state	On	If all children of a part are selected, the parent part is automatically selected as well. When disabled, only the children are selected.
Default manipulation space	Local	Change the default manipulation space for move and rotate manipulations. Options include Local and Global
Default reference position	Center	Change the default reference position for move and rotate manipulations. Options include Center and Origin.

Graphics

Graphics - Performance settings
Setting	Default value	Description
Small-mesh screen percentage culling	0%	When enabled, parts of models that are smaller than the specified screen percentage are hidden to improve performance. Greatly improves performance for large models at the cost of smooth transitions. Options include values from 0% to 20%.
Enable GPU occlusion culling	Off	When enabled, the GPU calculates which objects are visible and which are occluded by other objects to improve performance.
Enable backface culling	Off	When enabled, back faces of parts aren’t rendered. This can improve performance, but may cause visual issues with thin or single-sided parts.
Teleport sample frequency	35ms	Change the frequency at which teleportation samples the environment to find a valid teleport location. Lower values can improve the responsiveness of teleportation but may reduce performance.
Desktop frame rate	60 FPS	Change the frame rate for desktop mode. Options include 30 FPS, 60 FPS, and Uncapped.

Graphics - Visuals
Setting	Default value	Description
Use skybox lighting	Off	When enabled, the skybox contributes to the lighting of the scene. This can improve the visual quality of the scene, but may reduce performance.
Enable local reflections	Off	When enabled, local reflections of the skybox are rendered, improving the visual quality of reflective surfaces. This can impact performance, especially with complex materials and models.
Ambient occlusion	Medium	Change the intensity of ambient occlusion, which adds soft shadows to the scene. Options include Off, Low, Medium, and High.

Graphics - Anti-aliasing
Setting	Default value	Description
MSAA (Multisample anti-aliasing)	Off	When enabled, MSAA smooths out jagged edges in the scene. This can improve visual quality, but may reduce performance. Options include Off, 2x, 4x, and 8x.
Desktop anti-aliasing mode	FXAA	Change the anti-aliasing mode for desktop mode. Options include FXAA and SMAA. FXAA is faster but may produce more artifacts, while SMAA is slower but produces better visual quality.
Desktop SMAA quality	High	Change the quality of SMAA anti-aliasing for desktop mode. Options include Low, Medium, and High. Higher quality settings improve visual quality but may reduce performance.

Graphics - Shadows
Setting	Default value	Description
Enable Shadows (Desktop/VR/MR Only)	Off	When enabled, shadows are rendered in the scene. This can greatly improve the visual quality of the scene, but may reduce performance.
Soft-edged shadows	On	When enabled, shadows have soft edges, which can improve visual quality. When disabled, shadows have hard edges, which can improve performance.
Soft shadow quality	High	Change the quality of soft shadows. Options include Low, Medium, and High. Higher quality settings improve visual quality but may reduce performance.
Shadow resolution	1024	Change the resolution of shadows. Options include 256, 512, 1024, 2048, and 4096. Higher resolution shadows improve visual quality but may reduce performance.
Shadow attenuation	1	Change the attenuation of shadows, which affects how quickly shadows fade with distance. Options include values from 0 to 1. Lower values make shadows fade more quickly, while higher values make shadows fade more slowly.

Experimental

Experimental settings - Features
Setting	Default value	Description
Enable snapshots	Off	When enabled, you can activate the snapshots feature in Quick Menu and Scene View.
Snapshot menus	Off	When enabled, menu positions are included in snapshots.
Enable XR browser integration	Off	When enabled, you can use the XR browser integration feature in Hololight Space. This allows you to open web pages and interact with them directly in your XR environment.
Default XR browser URL	https://docs.hololight.com/hololight-space	The default URL for the XR browser integration.

Streaming

Streaming settings
Setting	Default value	Description
Bandwidth	Low	Change the bandwidth for streaming in Hololight Space. Options include Low, Medium, High and Ultra-high
Streaming reprojection mode	Depth	Change the reprojection mode for stability improvements. Options include Depth, Planar (2m), and Default.
Pose prediction	Moderate Predict	Change the pose prediction for streaming. Options include Disabled, Under predict, Moderate predict, and Over predict. The right setting depends on your network and device performance. If you experience lag or jitter, try adjusting this setting.
HD live stream (Microsoft HoloLens 2 only)	Off	When enabled, the live stream from Microsoft HoloLens 2 is in HD quality. This can improve visual quality but may require more bandwidth and processing power.