Required Materials

Software

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

Required Minecraft Mods

Optional Minecraft Mods

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.

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 → VRChat → 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 SteamVR App 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.