Jump to: Gameplay Compatibility Troubleshooting

If the FAQ does not cover your issue try the Discord link on the bar in the right. Someone there can likely help you. You can also try the forum.


Can I play with friends?

Yes! Vivecraft can be used to play on any normal Minecraft server running the same base Minecraft version. You can play with anyone, VR or not.

The VR features you can use in multiplayer depend on the server configuration. See the Multiplayer page for more info!

Can other people see me move in VR?

Yes! With a little work. You will need to be on a server with one of our server plugins, and you, and all your friends will need either Vivecraft or the Vivecraft Non-VR companion mod. See the multiplayer page for more details.

How do I play Minecraft?

Check google or youtube for tutorials

Why can’t I jump?

Vivecraft disables jumping and falling in teleport mode for those prone to motion sickness. Enable them in the VR Settings > Locomotion Options menu by turning ‘Simulate Falling’ on.

Why can’t I teleport?

When you connect to a multiplayer server that does not report running a Vivecraft Server Plugin the movement mode will default to free-move so you do not get kicked for cheating. If you know the server allows teleporting you can switch back to it by holding the ‘Pick Block’ button for 4 seconds or from the VR Settings > Locomotion menu.

I don’t want to teleport, how do I switch?

You can choose from several different locomotion methods in the VR Settings > Locomotion screen. Also holding ‘pick block’ for several seconds will toggle between teleport and your chosen free-move mode.

Why can’t I type in game?

Using the in-game keyboard (and several other mouse-related things) requires that the game window is in focus on your PC. If you alt-tab or click off it in Desktop mode be sure you switch back to it.


Can I play with mouse/keyboard?

Yes you can. Change ‘Play Mode’ to ‘SEATED’ in the VR Settings menu.

Can I play with a gamepad?


Does Vivecraft work with Forge?

Yes for 1.12.2 and below. 1.13.2 support is still in progress. See the Downloads page for installation instructions, and this page for individual mod compatibility info.

Does Vivecraft work with LiteLoader?

Yes, but only on 1.7.10. Install Vivecraft with Forge then extract the LiteLoader .jar and put it in your /mods folder.

Can I use Vivecraft with mod packs?

Yes!. See installation instructions below. Check the mod compatibility chart if you encounter any issues, individual mods in the pack may not work.

Using a third-party modpack launcher (FTB / Curse / Twitch / Technic, etc.)

  1. Use the third-party launcher to download your desired pack. Note the directory where it installs.
  2. Close the modpack launcher, you will not use it to play.
  3. Run the Vivecraft installer.
  4. Do not change the ‘path to Minecraft’ (unless you are using MultiMC)
  5. Check ‘Install Vivecraft with Forge’
  6. Check ‘Custom Profile Name’ and enter in a custom name, if desired.
  7. Check ‘Modpack Directory’ and click the ‘…’ button to browse to the modpack root directory. This is the directory containing the \mods folder for the desired pack.
  8. Click ‘Install’ and finish installing Vivecraft
  9. Use the official Minecraft launcher (or MultiMC) to launch the newly-created profile

Below is an example for launching the DW20 pack for 1.10.2 installed via the Twitch App.



Does Vivecraft work with MultiMC?

Yes! Create your MultiMC Instance first, then run the Vivecraft installer. Change the ‘path to Minecraft’ box to the MultiMC root directory (not the instance). Click ‘Install’ and you will be prompted to select the Instance.

See this page for detailed instructions if you need more help.

Does Vivecraft work on Mac or Linux?

Yes. Vivecraft does include OpenVR wrappers and code for Mac and Linux. To install Vivecraft on either of these platforms, simply change the installer extension to .jar and it should run via java.

Can Vivecraft be played via OpenComposite instead of SteamVR?

Yes, and the newer versions directly support the OpenComposite interface allowing the Touch menu buttons to be rebound in-game. To use: After installing Vivecraft, copy the OpenComposite openvr dll to your %AppData%\Roaming\.minecraft\openvr\win64\ folder (or equivalent), overwriting the existing file. Create a new empty file in this directory and name it OpenComposite.ini. Vivecraft should now launch without SteamVR. To revert this installation, delete the .ini file and Vivecraft will overwrite the dll on next launch with the steam version.

Does Vivecraft work with [insert fancy new VR hardware here]?

Vivecraft uses SteamVR to talk to all hardware components. If your hardware works in SteamVR Home it should work in Vivecraft.

Vivecraft has specific support and default controls for Vive Wands, Oculus Touch Controllers, and Windows MR Controllers.

If your hardware is not detected correctly you can manually specify which controller type to use:

  • Open up .minecraft/optionsviveprofiles.txt in notepad.
  • Look for the line ‘forceHardwareDetection=0’
  • Set this value to 1 for Vive, 2 for Touch, 3 for Windows MR, or 0 for off.

If your hardware does not work properly with any of these modes, let us know.

Can Vivecraft be played simultaneously on the same PC with regular 2D Minecraft?

For newer versions this should be possible. Vivecraft relies on mouse simulation for mod compatibility so this method of play is not recommended for modded installations.


The game shows up on my desktop, but not in the headset!

This occurs frequently on systems with dual GPUs like Alienware laptops. The solution is to force your PC to always use the gaming GPU. For NVIDIA systems right click the desktop and open the NVIDIA Control Panel. Set the Graphics Processor option to ‘High Performance’. If that isn’t the issue, ensure your monitor and HMD are plugged into the dedicated GPU. If that isn’t the issue, makes sure you didn’t install the Non-VR version by mistake. unknown

The game runs poorly, what can I do?

Minecraft was not written for VR and is not a very well optimized game. Here are some steps you can take to improve performance

  • Make sure you are allocating enough RAM for your installation type. Additionally be aware it’s possible to have your Java heap space overridden by Windows environment variables. If the game run incredibly bad check for a unwanted -Xmx256M argument there.
  • Reduce your draw distance in the Video Settings menu. Below 10 is best, even for high-end systems.
  • Turn down the ‘Render Scale’ in the VR Settings > Stereo Rendering menu. Also make sure your SteamVR supersampling is at 1.0, Vivecraft has its own setting and will stack with SteamVR’s.
  • Make sure you are not using any custom shaders or texture packs (in Video Settings).

I’m using a shader pack and everything is blurry!

Check the specific settings for your shader and disable motion blur, depth-of-field, lens flare, or similar.

The motion controllers don’t respond at all

Make sure the game is set to STANDING play mode. Use the mouse to navigate the menu to the VR Settings screen and change it there.

The Vivecraft installer says ‘Failed to download Optifine: Address family not supported by protocol family: connect’

See this page for some potential solutions

The game starts on a black screen with a SteamVR error message

Error 108: No HMD Found. Ensure you have SteamVR Installed and your HMD is working.
Error 112: Log path not found. This happens when your steam installation has moved. In SteamVR Settings > Developer Options click the Log Path button and set it whereever your steamapp/common/SteamVR directory is.

The game crashes on startup, what should I do?

You will need more information about the crash. Go to your .minecraft/crash-reports directory and look for the latest file. Additionally you can try the .minecraft/logs directory and look for ‘latest.log’. (If you are using Forge on 1.10 look for ‘fml-client-latest.log’ instead). The last entry in this file should be the crash stacktrace. Once you have located the error, check the common ones below. If your crash is not listed, come to the Discord or Forum and bring your log. In some cases, no error is logged to the normal Minecraft log. This happens if the JVM itself crashes, usually due to memory allocation issues. In this case check the root .minecraft directory for files named ‘hs_err_pid.txt’ which should contain an error message. If those do not exist, check the end of the launcher_log.txt file.

The game crashes and the error says “The game will now exit” and complains about a modified jar

. Your profile is launching Forge and is missing some critical JVM arguments. The Vivecraft installer adds these to the profile, but may have been deleted. Ensure your profile JVM args includes -Dfml.ignoreInvalidMinecraftCertificates=true -Dfml.ignorePatchDiscrepancies=true

The game crashes and the error says “MalformedClassName”

Go to your .minecraft directory and delete usercache.json. That should sort it.

The game crashes and the error says “java.lang.OutOfMemoryError: Java heap space”

Check your Windows environment variables for an entry called _JAVA_OPTS that is adding a Xmx256M or similar argument to your java commands. Remove it.

The game crashes and the error says “Could not reserve enough space for 2097152KB object heap”

You do not have 64-bit java installed. Install it or allocate less RAM to the Vivecraft profile. 64-bit and at least 2GB RAM is recommended for VR.

The game crashes and the popup window says ‘Java Binary SE has stopped working’

This is caused by a buggy nvidia driver released in January 2017 (v378.49). Try updating your drivers.

The game (or the installer) crashes and says ‘EXCEPTION_ACCESS_VIOLATION’ in ‘d3d9.dll’

This is caused by an incompatibility between Windows 10 creators update, 64-bit java, and Rivatuner. You will need to either uninstall or update Rivatuner. back to top