Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/QuestCraftPlusPlus/QuestCraft/llms.txt

Use this file to discover all available pages before exploring further.

If something is not working as expected, this guide covers the most frequent issues players run into with QuestCraft. For anything not answered here, the quickest path to a resolution is the #support channel in the QuestCraft Discord, where the community and dev team are active.

​
Installation Issues

Make sure Unknown Sources (also called Developer Mode on some headsets) is enabled in your headset’s settings before attempting to sideload. Without it, the system will silently reject any APK that was not installed through the official store.If the toggle is already on and the install still fails, try uninstalling and reinstalling SideQuest, then reconnect your headset and drag-drop the APK again.
This almost always means the APK file itself was corrupted during download, or it came from an unofficial source. Re-download the APK directly from the official QuestCraft releases page and install only from there. Never install APKs sourced from third-party sites.

​
Login / Account Issues

QuestCraft requires a valid, purchased licence of Minecraft: Java Edition. Free or trial accounts will not work. Additionally, your Java Edition purchase must be linked to a Microsoft account — if you have an older Mojang account that has not been migrated, complete the migration on Minecraft.net first, then try signing in again.
A timeout during sign-in is almost always caused by a weak or intermittent internet connection. Check that your headset is connected to Wi-Fi, move closer to the router if needed, and try again on a more stable network. If the problem persists, restart your headset and reopen the launcher before attempting another sign-in.

​
Game Files / Download Issues

During the initial file download, do not take off your headset. Removing the headset can cause the display to sleep and interrupt the file transfer. If the download was already interrupted, restart the QuestCraft launcher and press Play again — it will resume from where it left off.
The first-time setup for each Minecraft version downloads a significant amount of data and typically takes around 10 minutes on a good connection. This is completely normal. The exact time depends on your internet speed. Leave the headset on and the launcher open until the progress indicator confirms the download is complete.

​
Performance Issues

Two settings have the biggest impact on performance:
  • Render distance — Keep it at 4–6 chunks. Values of 9 and above are not recommended on standalone headsets and will cause frequent lag spikes.
  • Stereo Rendering resolution — In the options menu, go to VR Settings → Stereo Rendering and set the resolution (not camera resolution) to 80%. This gives a meaningful performance boost at a minor quality trade-off.
For the smoothest experience overall, try playing Skyblock or Oneblock world types — their low entity and chunk counts put much less strain on the hardware.
A crash on load is most often caused by a mod conflict or an incompatible mod. Check latestlog.txt (located at Android/data/com.qcxr.qcxr) for a Fabric error at the bottom of the file. See the Mod Crashes guide for step-by-step instructions on isolating and fixing the problem.

​
General Issues

A black screen during launch is normal behaviour, especially on Quest 2. The game can take anywhere from 1 to 4 minutes to fully load with the default mod set. The launcher’s log viewer will show progress — wait for it to indicate that Minecraft has started before assuming something is wrong.
Because QuestCraft is sideloaded rather than installed from the Meta store, it will not appear in the main app library. Look under the Unknown Sources section of your headset’s app library. If it is not there, the APK may not have installed successfully — check the SideQuest install log and try again.
If your issue is not covered above, get help in the QuestCraft Discord at discord.gg/questcraft. For confirmed bugs in QuestCraft itself, file a report at github.com/QuestCraftPlusPlus/QuestCraft/issues — but search existing issues first to avoid duplicates.
questcraft.net is NOT an official QuestCraft site. It is not owned or maintained by the QuestCraft team, and it may serve malware at any time. Do not download anything from it or visit it. The only official website is questcraft.org.

Build docs developers (and LLMs) love

Get started for freeTalk to us