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.


Does Vivecraft cost money?

No. You are free to use Vivecraft as you wish for playing, recording or streaming. If you enjoy it or use it in your business or content, please consider supporting us on patreon.

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 playing via LAN or on a modded server with one of our server plugins. Any desktop players will also need to be using the Vivecraft Non-VR client. See the multiplayer page for more details.

Can I change the desktop mirror?

Yes. Vivecraft offers several options for recording or streaming the desktop window. Pressing F5 while in-game will cycle through the available modes, or options can be set directly in the VR Settings > Stereo Rendering options screen. The Single and Dual mirror modes have no performance penalty. The First Person Undistorted, 3rd Person, and Mixed Reality mirror cost an additional render pass. See the mixed reality cam page for how to set the camera location for 3rd person views.

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.

Can I use touchpad-based analog movement?

Yes. Controllers with a joystick will default to this type. Vive wands, lacking joysticks, do not. To enable touchpad movement for Vive Wands you must bind the Move/Strafe Vector2 action to the touchpad in SteamVR Input. You should then relocate any actions bound to touchpad presses to something else.

How do I type in game?

Vivecraft has a built-in keyboard that can be accessed at any time by long-pressing the game menu button. The keyboard should also open automatically when clicking on a text input field. In some cases key input may not be recognized if the desktop window does not have focus, this is especially true for modded installations. Make sure the game window has focus on the desktop when using the keyboard.

Is there a left-handed mode?

Yes. Turn on ‘Reverse Hands’ in the VR Settings menu then restart the game. The restart is necessary to load the reversed controller bindings.


What hardware does Vivecraft support?

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

The latest versions of Vivecraft provides default controls for Vive Wands, Oculus Touch Controllers, Windows MR Controllers, and Index Controllers through SteamVR Input. Older versions using Legacy OpenVR have varying comparability depending on their release date.

Mobile VR devices are supported through 3rd-party SteamVR Emulators.

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?

Vivecraft supports OpenComposite, however the lastest versions of Vivecraft (as of July, 2019) require SteamVR Input support and OpenComposite does not yet support this API. Stay tuned for updates related to this.

Older versions of Vivecraft using Legacy OpenVR may have support for OC that works correctly. 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.

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 can’t click on anything!

Make sure the desktop window is not minimized. Alt-tabbing from a fullscreen game will minimize it. If you need to play without the game window in focus be sure to set it to windowed mode via the video settings or F11.

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. Depending on the type of crash this information may be in different log files. Once you have found the correct error message, Keep reading for solutions to common ones.

Where do I find Minecraft logs?

  • First check your %appdata%\.minecraft\crash-reports\ directory and look for a newly created file. This file will contain the crash information if the game crashed while it was running. In the case of mod conflict crashes you may also need to look at the latest.log file.
  • Next check the .minecraft/logs/ directory and look for ‘latest.log’. (If you are using Forge on 1.10 look for ‘fml-client-latest.log’). The last entry in this file should be the crash stacktrace. This file also contains the startup sequence and is usually better for troubleshooting, but may be confusing if you don’t know how to read it. Like the crash reports, latest.log is only created if the game properly initializes.
  • In some cases, no latest.log file is created or no error is logged. This frequently occurs if Java fails to initialize due to RAM allocation issues. In these cases check the root .minecraft folder for a file called launcher_log.txt. The crash should be at or near the bottom of this file.
  • In rare cases the Java Virtual Machine itself may crash due to memory or driver issues. In these cases a file called hs_err_pidXXX.log will be created in the root .minecraft directory.

If your crash is not listed below or you are unsure how to read the logs, come to the Discord or Forum and bring your log.

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 “Info Error occurred during initialization of VM Initial heap size set to a larger value than the maximum heap size Picked up _JAVA_OPTIONS: -Xmx###M: 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