
Visor
Minecraft mod that brings full VR support to the game. Supports addons, customizing your VR experience
- Загрузки
- 2K
- Подписчики
- 20
- Обновлён
- 25 июня 2026 г.
- Лицензия
- LGPL-3.0-only
Опубликован 7 апреля 2025 г.
Crafted by VR enthusiasts for players and developers alike
Recommended addons
What is Visor?
Visor is a Minecraft mod that brings VR support to the game - built from scratch as a platform. Based on OpenXR, allowing you to play from any VR runtime supporting OpenXR, including SteamVR.
Attention! Visor is on early development stage and might be unstable.
Some options are only configurable in config/Visor/settings.yml and config/Visor/server_settings.yml
Why use Visor?
For Players:
- Customize your VR experience through a growing addon ecosystem.
- Convenient customizations of VR overlays, keybindings and other
- Want to invite friend to play, but with custom VR settings you made? Create a settings preset and send it to your friend!
For Mod Developers:
- Build VR features or integrate VR support into your mod without sufferings in mixin chains, use Visor API instead.
- The codebase is intentionally readable, well-structured, and extensible.
For Project Owners:
- Visor is built to create large VR projects and smoothly integrate with existing ones.
- Want a custom integration or help in your VR project? Reach out via Discord - We are open to partnerships.
For Content Creators:
- Visor's well-designed codebase makes it easier to create mechanics and any other content for your videos.
- Need help with creating a content for you? Reach out via Discord - We are open to partnerships.
Project principles
The project is guided by the following principles:
Platform-first: You decide what's in your game. We build the foundation to start from.
Vanilla-Based: Stays close to vanilla Minecraft, so, addons and projects build on a stable foundation.
Lightweight: No unnecessary features overcomplicating the core. Easier to maintain, easier to extend.
User-friendly: Intuitive to play, good UI, no unnecessary options and just common sense.
Readable Code: The codebase is built to be understood, not just to work.
Plans
Want to know plans for next versions? Take a look at project roadmap
To get more details join Visor Mod Community.
If you are an enthusiastic VR developer and want to contribute to this project or create an addon, please contact us on Discord.
Ченджлог
0.4.0-forgeРелиз1.20, 1.20.1 · 25 июня 2026 г.
Includes 0.4.0beta changes and additional minor improvements, fixes
Improvements
- twoHanded and betterSwinging are no longer enabled by default on server join, so, won't be enabled for servers that do not have Visor mod or VisorPlugin
- Chat overlay repositioned for defaults presets
- Improved Iris + ImmersivePortals compatibility
- Changed color palette for VR ingame pause menu to cyan (Visor's main color)
Fixes
- Fixed mouse_left VRAction stuck in press state during world load
- Fixed item usage logic for offhand causing duplication in some cases with twoHanded gameplay enabled
- Fixed forge hud elements visibility (wasn't same as on fabric)
- Fixed force changing height when apply defaults preset
0.4.0-fabricРелиз1.20, 1.20.1 · 25 июня 2026 г.
Includes 0.4.0beta changes and additional minor improvements, fixes
Improvements
- twoHanded and betterSwinging are no longer enabled by default on server join, so, won't be enabled for servers that do not have Visor mod or VisorPlugin
- Chat overlay repositioned for defaults presets
- Improved Iris + ImmersivePortals compatibility
- Changed color palette for VR ingame pause menu to cyan (Visor's main color)
Fixes
- Fixed mouse_left VRAction stuck in press state during world load
- Fixed item usage logic for offhand causing duplication in some cases with twoHanded gameplay enabled
- Fixed forge hud elements visibility (wasn't same as on fabric)
- Fixed force changing height when apply defaults preset
0.4.0beta-forgeБета1.20, 1.20.1 · 17 июня 2026 г.
This version is focused on improving player experience and compatibility with most important mods
New features
1. GUI
Reshaped the way UI is felt in Visor, it is waay more convenient now.
Drag and resize overlays
Reworked keyboard logic from "Visor decides where to place it and when to remove" to "Player decides"
Added Keyboard language layouts
Reworked VR game pause menu
Convenient VR play mode switching instead of annoying simple button.
For NonVR players: "Force switched to NonVR" warning when failed to initialize VR instead of a spooky error
2. New Main Menu scene
Completely new and unique main menu scene instead of panorama images that were affecting on mod file size significantly.
The change has reduced mod file size from almost 20MB to 5MB!
In case you want to make main menu look different for you project needs, you can still use panorama feature
Improvements
- RU and UA localizations
- Added hotkey CTRL + F7 to switch VR play mode in case game is stuck in VR while you are on PC
- Added exception for auto-jump - if block has an inventory, no auto-jumping. Later I'll allow addons to modify that exception list
- "Closing eyes" effect when reaching a solid block too close, instead of an instant black display.
- Auto height calibrate on world join
- NonVR players now can spectate VRPlayers in first person with seeing VR hands (also works with replay mods)
- Slightly improved spectator gamemode in VR
- Added Visibility option for Movement State overlay
- Added support for item dragging in inventory with Right mouse (when one item is taken from the stack)
- Minor improvements and fixes for presets
- Added default preset alternative with HUD elements attached to hands
Linux support
This version should work with SteamVR on Linux, but we haven't tested it well enough yet, please let us know in case of issues
Mods compatibility
Added support for:
- Iris, Oculus
- Distant Horizons
- Replay/Flashback
Additionally, improved Immersive portals compatibility
Fixes
- Fixed gimbal lock issue messing up overlays rotation with sliders
- Fixed trident haptic pulse when any VR player uses it on multiplayer
- Fixed consuming item sometimes wasn't correctly working in main hand
- Fixed forge render pipeline, that caused the items and hands render with inconsistency between eyes, making weird and uncomfortable feeling
- Fixed player model in inventory GUI leaves bounds and overlaps with item slots when swimming/fall-flying
- Fixed inconsistency of OtherVRPlayer model height on multiplayer
-- And more!
0.4.0beta-fabricБета1.20, 1.20.1 · 17 июня 2026 г.
This version is focused on improving player experience and compatibility with most important mods
New features
1. GUI
Reshaped the way UI is felt in Visor, it is waay more convenient now.
Drag and resize overlays
Reworked keyboard logic from "Visor decides where to place it and when to remove" to "Player decides"
Added Keyboard language layouts
Reworked VR game pause menu
Convenient VR play mode switching instead of annoying simple button.
For NonVR players: "Force switched to NonVR" warning when failed to initialize VR instead of a spooky error
2. New Main Menu scene
Completely new and unique main menu scene instead of panorama images that were affecting on mod file size significantly.
The change has reduced mod file size from almost 20MB to 5MB!
In case you want to make main menu look different for you project needs, you can still use panorama feature
Improvements
- RU and UA localizations
- Added hotkey CTRL + F7 to switch VR play mode in case game is stuck in VR while you are on PC
- Added exception for auto-jump - if block has an inventory, no auto-jumping. Later I'll allow addons to modify that exception list
- "Closing eyes" effect when reaching a solid block too close, instead of an instant black display.
- Auto height calibrate on world join
- NonVR players now can spectate VRPlayers in first person with seeing VR hands (also works with replay mods)
- Slightly improved spectator gamemode in VR
- Added Visibility option for Movement State overlay
- Added support for item dragging in inventory with Right mouse (when one item is taken from the stack)
- Minor improvements and fixes for presets
- Added default preset alternative with HUD elements attached to hands
Linux support
This version should work with SteamVR on Linux, but we haven't tested it well enough yet, please let us know in case of issues
Mods compatibility
Added support for:
- Iris, Oculus
- Distant Horizons
- Replay/Flashback
Additionally, improved Immersive portals compatibility
Fixes
- Fixed gimbal lock issue messing up overlays rotation with sliders
- Fixed trident haptic pulse when any VR player uses it on multiplayer
- Fixed consuming item sometimes wasn't correctly working in main hand
- Fixed forge render pipeline, that caused the items and hands render with inconsistency between eyes, making weird and uncomfortable feeling
- Fixed player model in inventory GUI leaves bounds and overlaps with item slots when swimming/fall-flying
- Fixed inconsistency of OtherVRPlayer model height on multiplayer
-- And more!
0.3.0-forgeРелиз1.20, 1.20.1 · 8 мая 2026 г.
Improved VRBody model rendering
Fixes
Gui squish
twoHanded gameplay issues
Opengl.dll crash on game close (error log generated every time you close the Minecraft, messing up the game folder)
Hand Item positioning
Flicker of VR hands on attack/use
VR model was not visible for other VR and NonVR players
VRBody full on teleportation had the delayed camera update that caused the model to be visible "from the future"
No pvp on server with Visor
Crash on dedicated server during load
Presets could not be created by player due to an id pattern incorrect check
0.3.0-fabricРелиз1.20, 1.20.1 · 8 мая 2026 г.
Improved VRBody model rendering
Fixes
Gui squish
twoHanded gameplay issues
Opengl.dll crash on game close (error log generated every time you close the Minecraft, messing up the game folder)
Hand Item positioning
Flicker of VR hands on attack/use
VR model was not visible for other VR and NonVR players
VRBody full on teleportation had the delayed camera update that caused the model to be visible "from the future"
No pvp on server with Visor
Crash on dedicated server during load
Presets could not be created by player due to an id pattern incorrect check
0.3.0beta-forgeБета1.20, 1.20.1 · 25 апреля 2026 г.
New features
1. GUI
The number of available settings has grown a lot, and Visor’s feature list continues to expand.
The old Minecraft-based settings screen was becoming harder to use and confusing for new players. In Visor 0.3.0, we redesigned the VR settings interface from scratch to make it clearer, more convenient, and easier to navigate.
Additional GUI changes:
- Added settings presets You can now share your settings with friends, so they do not need to spend a lot of time configuring everything before playing.
This can also be useful for large projects or modpacks that want to provide tuned VR settings for their project context
- Added the "Key Button" overlay template
This overlay can emulate a keyboard key press when clicked.
For example, if you use a gun mod where the "R" key reloads a weapon, you can add a Key Button overlay that emulates pressing "R".
2. Immersion
- Added a new Immersion settings category.
- Reworked In-Room Jump, Sneak, and Crawl.
3. VR body
Visor 0.3.0 introduces a new experimental approach to rendering the VR player model.
Previously, Visor only rendered hands, and addons could not change that without hardcoding many mixins.
Now, VR player rendering is handled by the new VRBody system. This system is much more customizable, and addons can add VR bodies with the same level of freedom as overlays.
Players can select a VR body from the settings category. Addons can also take full control over body selection, in which case the player will not be able to change it manually.
The goal of this feature is to let addons completely change what the player sees as their body or hands in VR.
Addon developers can create bodies for specific gameplay experiences, creatures, or modpack concepts. We strongly encourage developers to use this feature to improve immersion. Imagine a modpack where you play as a cat and your VR body actually looks like a cat. Or a project where you become a giant, a monster, or a horror creature.
Important: This feature is still raw and highly experimental. It will continue to be improved in future versions.
4. Two-Handed gameplay
Two-handed gameplay allows the offhand to work similarly to the main hand.
In vanilla Minecraft, the offhand is mostly a secondary support slot with limited use. In VR, that behavior can feel inconvenient, so we made the offhand behave more like the main hand.
This feature is optional and can be disabled in:
config/Visor/server-settings.yml (it is a server side behaviour change)
5. Swinging
You can now attack entities and break blocks by physically swinging your hand.
There is also a betterSwinging option in server settings. When enabled, block breaking uses a more advanced mechanic.
Improvements
Added Fabulous graphics support
Reworked rendering pipeline for VR.
Added a look compatibility option for mods that require the player’s look direction to follow the HMD. (This may be useful for some horror mods and other mods that depend on player look direction)
Mods compatibility
Sodium: improved compatibility. The game should now be noticeably more optimized when using Visor together with Sodium.
Immersive portals. Added compatibility
Fixes
- Fixed X-Ray when looking inside a block
- Fixed transparancy issues in rendering
- Fixed an annoying leash rendering issue where the leash appeared attached to the player instead of the animal.
- Fixed In-Room Swimming working while standing on a block.
- Fixed some hotbar issues
- Fixed disabled VR mode, so non-VR players should behave like vanilla players while still being able to see VR player rendering correctly.
And more!
0.3.0beta-fabricБета1.20, 1.20.1 · 25 апреля 2026 г.
New features
1. GUI
The number of available settings has grown a lot, and Visor’s feature list continues to expand.
The old Minecraft-based settings screen was becoming harder to use and confusing for new players. In Visor 0.3.0, we redesigned the VR settings interface from scratch to make it clearer, more convenient, and easier to navigate.
Additional GUI changes:
- Added settings presets You can now share your settings with friends, so they do not need to spend a lot of time configuring everything before playing.
This can also be useful for large projects or modpacks that want to provide tuned VR settings for their project context
- Added the "Key Button" overlay template
This overlay can emulate a keyboard key press when clicked.
For example, if you use a gun mod where the "R" key reloads a weapon, you can add a Key Button overlay that emulates pressing "R".
2. Immersion
- Added a new Immersion settings category.
- Reworked In-Room Jump, Sneak, and Crawl.
3. VR body
Visor 0.3.0 introduces a new experimental approach to rendering the VR player model.
Previously, Visor only rendered hands, and addons could not change that without hardcoding many mixins.
Now, VR player rendering is handled by the new VRBody system. This system is much more customizable, and addons can add VR bodies with the same level of freedom as overlays.
Players can select a VR body from the settings category. Addons can also take full control over body selection, in which case the player will not be able to change it manually.
The goal of this feature is to let addons completely change what the player sees as their body or hands in VR.
Addon developers can create bodies for specific gameplay experiences, creatures, or modpack concepts. We strongly encourage developers to use this feature to improve immersion. Imagine a modpack where you play as a cat and your VR body actually looks like a cat. Or a project where you become a giant, a monster, or a horror creature.
Important: This feature is still raw and highly experimental. It will continue to be improved in future versions.
4. Two-Handed gameplay
Two-handed gameplay allows the offhand to work similarly to the main hand.
In vanilla Minecraft, the offhand is mostly a secondary support slot with limited use. In VR, that behavior can feel inconvenient, so we made the offhand behave more like the main hand.
This feature is optional and can be disabled in:
config/Visor/server-settings.yml (it is a server side behaviour change)
5. Swinging
You can now attack entities and break blocks by physically swinging your hand.
There is also a betterSwinging option in server settings. When enabled, block breaking uses a more advanced mechanic.
Improvements
Added Fabulous graphics support
Reworked rendering pipeline for VR.
Added a look compatibility option for mods that require the player’s look direction to follow the HMD. (This may be useful for some horror mods and other mods that depend on player look direction)
Mods compatibility
Sodium: improved compatibility. The game should now be noticeably more optimized when using Visor together with Sodium.
Immersive portals. Added compatibility
Fixes
- Fixed X-Ray when looking inside a block
- Fixed transparancy issues in rendering
- Fixed an annoying leash rendering issue where the leash appeared attached to the player instead of the animal.
- Fixed In-Room Swimming working while standing on a block.
- Fixed some hotbar issues
- Fixed disabled VR mode, so non-VR players should behave like vanilla players while still being able to see VR player rendering correctly.
And more!
Комментарии
Загружаем…