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:

Open	Open

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

Right Hand

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

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.