https://www.vivecraft.org/

Required Materials

Software

The below software is required for this guide, except those marked as optional:

Required Minecraft Mods

Optional Minecraft Mods

https://www.youtube.com/watch?v=8gqGp7TV-9E&t=0s

Summary

Vivecraft is a mod for Minecraft v1.20.4 and requires Fabric to be installed. Use the Prism Launcher to install Fabric and Vivecraft, as well as the Vivecraft mod compatibility pack. We have chosen v1.20.4 as this version also works with multiplayer servers and headsets running QuestCraft, the port of Vivecraft for Meta Quest 2/3/3S/Pro.

Minecraft Setup

SpigotMC Server Installation

1. Follow this guide to install SpigotMC server via BuildTools. If you have been provided a pre-configured server, you will just need to install Azul Zulu JDK 17 from here (install the Windows 64-bit version).

ViveCraft Installation

1. Purchase a copy of Minecraft Java & Bedrock Edition using your personal Microsoft account or use a gift card key and add it to your Microsoft account.

2. Download and install the latest version of PrismLauncher. Use the suggested default settings during installation.

3. Run PrismLauncher.

4. When prompted, sign in with your Microsoft account.

5. Add a new Minecraft instance for v1.20.4.

6. Select the instance and click the Folder button from the sidebar to open the instance folder in Windows Explorer.

7. (optional) Import a previously exported ZIP of the v1.20.4 Minecraft instance by unzipping the contents and overwrite the files already in the v1.20.4 folder.

8. (optional) Add the list of required mods from this guide.

9. Start the SpigotMC server via run.bat so the multiplayer server starts. If prompted to allow Java through the Windows firewall, accept this.

10. Launch the v1.20.4 Minecraft instance from PrismLauncher. If prompted to allow Java through the Windows firewall, accept this.

11. On the Minecraft title screen, toggle VR to ON. You can toggle between desktop mode and VR mode at any time. In desktop mode the standard keyboard / mouse controls are available, and this can be useful when setting up the Minecraft world for shooting videos in VR.

12. Click Multiplayer then select the multiplayer server from the list.

13. Click Join to enter the Minecraft world.

14. (optional) If you have installed the Bluemap mod, you can access a 3D Google Maps style interface to view your Minecraft world in a browser.

15. In the SpigotMC server command line, use the stop command to safely save the world and shut down the multiplayer server.

Disabling Shaders

If you have been provided with an exported ZIP of the v1.20.4 Minecraft instance it may be pre-configured to use shaders. On some PCs that only just meet the minimum requirements for VR, this will cause poor performance. You can disable shaders by going to the Minecraft title screen, then going to Options… → Video Settings… → Shader Packs… and toggling Shaders to Disabled.

Installing Another Shader Pack

Install Sildur’s Vibrant Shaders via the PrismLauncher shaders list for better performance.

1. Close Minecraft.

2. Edit the 1.20.4 Minecraft instance.

3. Uncheck the Complementary shader pack.

4. Check Sildur’s Vibrant Shaders.

5. Launch the 1.20.4 Minecraft instance from Prism Launcher.

Alternate Immersive VR Essentials modpack for Minecraft

GingasVR has recently released a new modpack for Minecraft via Modrinth. This modpack is single player only, but provides a more immersive set of crafting mechanics where items are placed on crafting tables and inventory management is in 3D worldspace, instead of the usual 2D UI windows.

https://modrinth.com/modpack/immersive-vr-essentials

Vivecraft SteamVR Bindings

Vivecraft requires minimal button bindings due to good integration with Minecraft via mods. It supports features like auto-jump which means there is one less button to bind. The item hotbar can be accessed by hovering over it with your right hand and using the right-hand trigger to select an item. Crouching is automatic by default - you can physically crouch, assuming you have calibrated your height in from the Minecraft VR settings menu - this will help when walking near ledges to stabilize any unintentional joystick directional inputs that are accidentally triggered.

Mining and interacting with many objects in the world can be done by physically swinging your hands. The game also supports a virtual keyboard for entering text.

We also suggested changing the radial menu to be triggered by a long press and adding non-critical buttons to the menu, such as toggling sprint mode, dropping the current item or picking blocks (if in Creative Mode).

SteamVR Controller Profile

1. In Windows, unzip and place the profile json in %USERPROFILE%\Documents\steamvr\input:
   

2. Open SteamVR Settings → Controllers → Manage Controller Bindings → Vivecraft → Active Controller: Index Controller → Active Controller Binding: Custom, select the StretchSense Vivecraft configuration for Index Controller.

Controller Profile Bindings

The above profile uses these recommended bindings:

Minecraft Gestures

The following binding changes will help stop accidental activations of the Minecraft menus.

• Left B Button - In the global bindings tab, change B button bindings so that Long press toggles the inventory menu. Remove all actions bound to Single for the B button.

• Left A Button - In the global bindings tab, change B button bindings so that Long press triggers the Minecraft menu. Remove all actions bound to Single for the A button.

• Left / Right Grip - Remove the single In-Game bindings for these buttons as they will navigate forwards/backwards through the current hotbar selection and are easy to accidentally trigger. Instead use your right hand and hover over the hotbar slot on the left hand and use the RT button to select the item.

• Right Stick Click - This default binding is non-functional as v0.6.0 of the StretchSense App for SteamVR does not support joystick click emulation. The controller profile in this guide rebinds this to a long press of the right B button.

Left Hand

Pose	Button Name	Action	Type	Description
	Idle			Make the horns gesture, then move your thumb straight up. This represents the centered position of joystick.
	Up	Walk Forward	SCALAR Y: 1.0 *	Make the horns gesture 🤘 with your thumb forward, parallel to your index finger.
	Left	Strafe Left	SCALAR X: -1.0 *	Make the horns gesture 🤘 with your thumb pulled towards the left side of your hand, away from your palm. This button is optional
	Right	Strafe Right	SCALAR X: 1.0 *	Make the horns gesture 🤘 with your thumb pulled towards the right side of your hand, towards your palm. This button is optional
	Down	Walk Backward	SCALAR X: -1.0 *	Make the horns gesture 🤘 with your thumb curled in, with your knuckle arching up and the tip pressing towards middle of your middle finger. This direction is not used often as it is a fatiguing pose for the thumb.
	Grip	GUI Shift	SINGLE	Make a finger gun pose with your thumb pointing upwards and your middle, ring and little fingers curled. Don’t squeeze too hard to avoid overdriving the glove sensors. When moving inventory items, hold left grip and right grip together to transfer an entire stack into the opposite container.
	LT	Use Item / Place block	SINGLE	Point gesture with thumb pointing upwards. Fully curl in your index finger, as if you were pulling a real trigger. Avoid squeezing your index finger too hard as it will make it harder to repeat the gesture. Use LT to activate items held in your left hand. Use LT to open UIs while hovering over them with the cross hair e.g. crafting, furnaces, smokers
	A Button	Toggle Game Menu	SINGLE	Touch your middle finger to your thumb, with your thumb resting on the middle part of your middle finger. Keep your other fingers extended. Use A to toggle the Minecraft Game Menu to change settings or exit the game.
	B Button	Toggle Inventory GUI	LONG PRESS	Touch your ring finger to your thumb, with your thumb resting on the middle part of your ring finger. Keep your other fingers extended. Use this to close other UIs e.g. crafting, furnaces, smokers

Right Hand

The right hand is used for interaction and selecting UI elements with a laser pointer.

Pose	Button Name	Action	Type	Description
	Idle			Make a relaxed pose and move your fingers between being fully extended to a slightly relaxed curled pose. This represents no buttons being pressed.
	Grip	GUI Right Click	SINGLE	Make a finger gun pose with your thumb pointing upwards and your middle, ring and little fingers curled. Don’t squeeze too hard to avoid overdriving the glove sensors. When moving inventory items, hold left grip and right grip together to transfer an entire stack into the opposite container. When moving a stack of items, activating the grip button will split the stack into the current inventory slot being hovered over.
	RT	Mine / Attack / Use Held Item GUI Left Click	SINGLE SINGLE	Point gesture with thumb pointing upwards. Fully curl in your index finger, as if you were pulling a real trigger. Avoid squeezing your index finger too hard as it will make it harder to repeat the gesture. Use RT to select items from your left hand hotbar.
	Menu	Toggle SteamVR Dashboard	LONG PRESS	Touch your little finger to your thumb, with your thumb resting on the middle part of your little finger. Keep your other fingers extended. This gesture activates the SteamVR Dashboard. Train it so it can be pressed accurately. You may need to go back and train the idle pose again to stop it accidentally triggering. Bind this button in the SteamVR Dashboard Controller Bindings to avoid accidentally activating it.
	A Button	Jump Sneak	SINGLE LONG PRESS	Touch your middle finger to your thumb, with your thumb resting on the middle part of your middle finger. Keep your other fingers extended. Rebound from the right thumb stick click button to long press of the A button. Long press A button to exit minecarts and boats.
	B Button	Radial Menu	HOLD	Touch your ring finger to your thumb, with your thumb resting on the middle part of your ring finger. Keep your other fingers extended. Edit the Minecraft VR settings to configure the Vivecraft radial menu with common actions such as crouch (also used to exit vehicles such as mine carts and boats), pick block and drop item.

Non-Button Controls

• Swing right controller - to physically use the held item, harvest wood, crops attack mobs and enemies

• Physically crouch - crouch or go prone and remain there to activate sneak mode

• Physically jump - Jump

• Swimming locomotion - Move hands in a motion with your palms facing outwards at the center of your chest, then pulling your arms outward away from you to propel yourself forward. You will move in the direction your head is looking.

• Firing bows - Hold the bow outwards with your left hand and move the held arrow in your right hand towards your left hand. Hold the RT button gesture and pull back on the bow to prime it, then release RT to fire the arrow.

Vivecraft Hand Skeleton

The hand model used in Vivecraft is a modified version of the original first-person character model. It doesn’t support individual finger articulation, so your VR hands won’t be animated.

Troubleshooting

GUI Clicks Don’t Register

Most GUIs in Minecraft require the game to be running in the foreground of your Windows PC in order for UI clicks to register. If you are having issues with this, check other apps or overlays haven’t appeared in front of the Minecraft window, especially when running Minecraft in full screen mode.