Publishing Your Game: Building for Quest

Building for Quest is the process of exporting your VR fangame as an APK that can run on Meta Quest devices.
This page walks you through the exact steps required to generate a clean, installable, platform‑ready build.

1. Switch Platform to Android

In Unity:

1. Open File → Build Settings

2. Select Android

3. Click Switch Platform

Wait for Unity to reimport assets — this can take a few minutes.

2. Required Android Build Settings

Inside Build Settings → Android:

• Texture Compression: ASTC

• Build System: Gradle

• Run Device: (optional) Quest if connected

• Export Project: OFF

• Development Build: OFF for release, ON for testing

• Compression Method: LZ4 (fast) or LZ4HC (smaller)

Make sure your Scenes in Build list is correct:

1. Menu Scene

2. Room Scene

3. Any additional maps

3. Required Player Settings (Android)

Inside Project Settings → Player → Android:

A. Identification

• Package Name: com.yourstudio.yourgame

• Version: 1.0.0

• Bundle Version Code: Increase every update

B. Resolution & Presentation

• Run in Background: ON

• Optimized Frame Pacing: ON

C. Other Settings

• Minimum API Level: Android 10

• Target API Level: Highest installed

• Scripting Backend: IL2CPP

• Target Architectures: ARM64 only

• Internet Access: Required

• Graphics API: Vulkan (recommended)

4. XR Settings for Quest

Inside Project Settings → XR Plug‑in Management:

Enable:

• OpenXR

Disable:

• Oculus (Legacy)

• MockHMD

• Any unused XR providers

Then under OpenXR → Features:

Enable:

• Meta Quest Support

• Hand Tracking (optional)

• Eye Gaze (optional)

Disable everything else.

5. Quest‑Specific Requirements

A. ARM64 Only

Quest does not support ARMv7.

B. Vulkan Recommended

Better performance and stability.

C. No Real‑Time GI

Quest cannot handle it.

D. Low‑Poly Maps

Standalone hardware requires optimization.

E. Baked Lighting

Real‑time shadows are expensive.

6. Building the APK

Once everything is configured:

1. Open File → Build Settings

2. Select Android

3. Click Build

4. Choose a folder

5. Unity generates an APK

For testing, you can also use Build & Run if your Quest is connected via USB.

7. Installing the APK on Quest

You can install the APK using:

A. SideQuest (recommended)

• Connect Quest via USB

• Open SideQuest

• Drag the APK into the window

B. ADB (advanced)

adb install yourgame.apk

C. Meta Quest Developer Hub

• Connect headset

• Click “Install APK”

8. Testing Your Build

Before publishing, test:

• Multiplayer connection

• Region selection

• Room creation/join

• Player spawning

• Cosmetics syncing

• Performance (FPS)

• Lighting

• Map collisions

• Audio levels

• Menu UI

A build that works in Unity may behave differently on the headset.

9. Common Build Errors

A. “INSTALL_FAILED_NO_MATCHING_ABIS”

You didn’t select ARM64.

B. “INSTALL_FAILED_VERSION_DOWNGRADE”

Your Bundle Version Code is lower than the installed version.

C. Black screen on startup

Usually caused by:

• Wrong graphics API

• Missing OpenXR features

• Incorrect package name

D. App instantly closes

Often caused by:

• Missing permissions

• Incorrect API level

• XR misconfiguration