Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

https://www.vivecraft.org/

Required Materials

Software

...

Tip

Installers for the StretchSense App for SteamVR App can be downloaded from the My Account → Software Downloads section of the StretchSense website.

Description

Version

Hand Engine
3.
2
3.0-LITE
Steam Desktop Client
latest
SteamVR
2.
7
8.
4
8 or later
StretchSense Driver Add-On for SteamVR (Included with StretchSense App for SteamVR
App
installer)
latest
StretchSense App for SteamVR
App
0.
6
11.0
Minecraft Java Edition
1.20.4

...

Description

Version

Forge Config API Port
20.4.3
Physics Mod - Adds various physics effects to Minecraft like shattering blocks, moving reeds and vines, physics on thrown items etc
3.0.14
ImmersiveMC - Adds immersive crafting benches and shoulder backpack. Has several dependencies - Architectury v11.1.17 and MC VR API v3.0.9; be sure to install these if using ImmersiveMC.
1.5.0-beta1
Iris Shaders - Required to load shader packs
1.7.2+mc1.20.4
Sodium - Required to load shader packs
0.5.8+mc1.20.4
Sildur’s Vibrant Shaders - Shader pack for slower PCs
1.51 Lite
ComplementaryReimagined - A shader pack for fast PCs with a good GPU (RTX 3080/4080 or higher)
r5.2.2

...

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.

...

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

    View file
    nameVivecraft Controller Profile 20240826.zip

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

...

The above profile uses these recommended bindings:

Screenshot 2024-08-26 143736.pngScreenshot 2024-08-26 143758.png
Screenshot 2024-08-26 143817.pngScreenshot 2024-08-26 143853.png

Minecraft Gestures

Tip

We recommend training these standard gestures in the StretchSense App for SteamVR.

Info

Some of this advice is no longer applicable as multi-button presses are available in v0.9.0 of the StretchSense App for SteamVR app.

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 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

Info

If more stability is needed, only train up/down buttons since smooth locomotion uses the left tracker position to determine the direction to turn during forward movement, rather than your head look direction.

Warning
  • As of StretchSense App for SteamVR App v0.6.0 only values of 1.0 are outputted for emulated triggers and joysticks.

Pose

Button Name

Action

Type

Description

d-idle.png

Idle

Make the horns gesture, then move your thumb straight up. This represents the centered position of joystick.
d-up.png

Up

Walk Forward

Status
titleScalar Y: 1.0
*

Make the horns gesture 🤘 with your thumb forward, parallel to your index finger.
d-left.png

Left

Strafe Left

Status
titleScalar X: -1.0
*

Make the horns gesture 🤘 with your thumb pulled towards the left side of your hand, away from your palm.
Info
This button is optional
d-right.png

Right

Strafe Right

Status
titleScalar X: 1.0
*

Make the horns gesture 🤘 with your thumb pulled towards the right side of your hand, towards your palm.
Info
This button is optional
d-down.png

Down

Walk Backward

Status
titleScalar 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.
grab.png

Grip

GUI Shift

Status
colourBlue
titleSingle

Make a finger gun pose with your thumb pointing upwards and your middle, ring and little fingers curled.
Note
Don’t squeeze too hard to avoid overdriving the glove sensors.
Tip
When moving inventory items, hold left grip and right grip together to transfer an entire stack into the opposite container.
trigger.png

LT

Use Item / Place block

Status
colourBlue
titleSingle

Point gesture with thumb pointing upwards. Fully curl in your index finger, as if you were pulling a real trigger.
Note
Avoid squeezing your index finger too hard as it will make it harder to repeat the gesture.
Tip
Use LT to activate items held in your left hand.
Info
Use LT to open UIs while hovering over them with the cross hair e.g. crafting, furnaces, smokers
primary-a.png

A Button

Toggle Game Menu

Status
colourBlue
titleSingle

Touch your middle finger to your thumb, with your thumb resting on the middle part of your middle finger. Keep your other fingers extended.
Tip
Use A to toggle the Minecraft Game Menu to change settings or exit the game.
secondary-b.png

B Button

Toggle Inventory GUI

Status
colourGreen
titleLONG 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.
Tip
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.

Note

Avoid training joystick directions on the right hand as the default left/right joystick behavior is to activate turning. Instead use your physical body to turn when moving in VRChatVivecraft. Your head look direction with control the forward direction you will travel during smooth locomotion.

Warning
  • As of StretchSense App for SteamVR App v0.6.0 only values of 1.0 are outputted for emulated triggers and joysticks.

Pose

Button Name

Action

Type

Description

d-idle.png

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.
grab.png

Grip

GUI Right Click

Status
colourBlue
titleSingle

Make a finger gun pose with your thumb pointing upwards and your middle, ring and little fingers curled.
Note
Don’t squeeze too hard to avoid overdriving the glove sensors.
Tip
When moving inventory items, hold left grip and right grip together to transfer an entire stack into the opposite container.
Info
When moving a stack of items, activating the grip button will split the stack into the current inventory slot being hovered over.
trigger.png

RT

Mine / Attack / Use Held Item
GUI Left Click

Status
colourBlue
titleSingle

Status
colourBlue
titleSingle

Point gesture with thumb pointing upwards. Fully curl in your index finger, as if you were pulling a real trigger.
Note
Avoid squeezing your index finger too hard as it will make it harder to repeat the gesture.
Tip
Use RT to select items from your left hand hotbar.
menu.png

Menu

Toggle SteamVR Dashboard

Status
colourGreen
titleLONG 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.
Note
Bind this button in the SteamVR Dashboard Controller Bindings to avoid accidentally activating it.
primary-a.png

A Button

Jump
Sneak

Status
colourBlue
titleSingle

Status
colourGreen
titleLONG 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.
Note
Rebound from the right thumb stick click button to long press of the A button.
Tip
Long press A button to exit minecarts and boats.
secondary-b.png

B Button

Radial Menu

Status
colourRed
titleHOLD

Touch your ring finger to your thumb, with your thumb resting on the middle part of your ring finger. Keep your other fingers extended.
Note
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.

...

Changelog

Version

Publish Date (YYYY/MM/DD)

  • Add links to GingasVR’s modpack.

v1.2.0

2025/01/21

  • Add guide to setup Minecraft via Prism Launcher and SpigotMC server.

  • Add shader guide.

v1.1.0

2024/10/30

  • Initial version.

v1.0.0

2024/08/26