Unity

Export your Zimension project to Unity

Download the Unity template, export your Zimension project as a ZIP, and import it from the Zimension menu in Unity.

Import instructions

Setting up Quest VR? View XR instructions

Version 0.3.11 · Unity 6000.6.8f1 · Premium required

Escape From Outpost X imported from Zimension and open in the Unity 6 Editor
Escape From Outpost XImported into Unity 6

Build in Zimension, edit in Unity

Use the browser editor to create your project, then work with its imported scenes and scripts in Unity.

Create in the browser

Arrange scenes, add assets and set up interactions in Zimension.

Edit the generated C#

Supported events become C# methods. Add your own scripts and Unity components.

Reimport project updates

Export a new project ZIP when your Zimension project changes. Keep custom Unity work in the preserved files.

Prerequisites: before you import

Install what your target needs. The template handles project packages; Unity Hub handles the editor and Android build tools.

Unity import prerequisites by target
Your targetWhat you need
Every projectAn active Zimension Premium plan or higher, Unity Hub, Unity Editor 6000.6.8f1, and your saved project export ZIP. Internet is needed for first-time package installation.
Desktop gameAdd build support for your desktop target in Unity Hub. Android tools and a headset are not needed for desktop-only projects.
Quest / Android APKUnity Hub > Installs > 6000.6.8f1 > Add modules: Android Build Support, Android SDK & NDK Tools, and OpenJDK. Finish every queued download and restart Unity.
VR preview in PlayA supported Quest with controllers and Meta Horizon Link on a compatible Windows PC. Select Meta as the active OpenXR runtime and launch Quest Link inside the headset before pressing Play.
Installed by the templateRendering and asset-import packages, plus OpenXR, XR Plug-in Management, Input System and XR Interaction Toolkit for VR. Let Unity finish resolving packages and compiling; accept the install prompt if shown.

Android Studio is not required for this Unity workflow. Use the SDK, NDK and OpenJDK supplied by Unity Hub. If Unity cannot find them, open Preferences > External Tools and check the tools installed with Unity.

Unity Hub with Android Build Support, Android SDK and NDK Tools, and OpenJDK all selected
Select all three Android modules. Illustration from Unity documentation; download sizes vary by version.

Two downloads, two different jobs

  • ZimensionUnity-0.3.11.zip — Unity template
    Extract it. Add the inner ZimensionUnity folder in Unity Hub. Steps 2–4.
  • Your project export.zip — your game
    Keep it compressed. Select it with Zip… inside the Unity Editor importer. Step 6.
Get Unity Hub

How to import your project

Export your project from Zimension, then open it in the Unity template.

  1. 1

    Save and export your Zimension project

    Open your project in the browser editor and save your changes. Open the Publish panel and choose Export, then select Export playable project and Web. Click Build Web Version to download the project ZIP with its assets.

    Keep this project ZIP intact. You will select it inside Unity; it is different from the Unity template downloaded above. Export permissions and your project’s asset restrictions still apply.

    Zimension Export project dialog with Export playable project and Web selected, and the Build Web Version button
    Choose Export playable project, select Web, then click Build Web Version.
  2. 2

    Extract the Unity template ZIP

    Find ZimensionUnity-0.3.11.zip, the template downloaded using the button above. This gives Unity the importer; your own project export is a separate file.

    Windows: right-click ZimensionUnity-0.3.11.zip, choose Extract All…, choose a writable location and click Extract.

    macOS: double-click ZimensionUnity-0.3.11.zip to extract it.

    Open the extracted folder and find ZimensionUnity. If your extraction tool created an outer folder with the version number, open that folder first.

    Extract the Unity template only. Keep the project ZIP from step 1 intact for step 6.

  3. 3

    In Unity Hub, click Add project from disk

    Open the Unity Hub application. You are adding the project you just extracted.

    1. Click Projects in the left sidebar.
    2. Click the Add dropdown near the top right, next to New project.
    3. Choose Add project from disk. A folder picker opens.

    ProjectsAdd ▾Add project from disk

    Use Add, not New project. You already have the Unity project in the downloaded template.

    Unity Hub Projects window: the Add dropdown is at the top right, immediately left of New project
    Click the highlighted Add dropdown, then choose Add project from disk. This screenshot shows Unity Hub on macOS; Windows uses the same menu. Screenshot: Unity documentation.
  4. 4

    Select the ZimensionUnity project folder

    In the folder picker, navigate to the extracted template. Select the ZimensionUnity folder that directly contains all three folders: Assets, Packages and ProjectSettings.

    1. Open the versioned outer folder first if your extraction tool created one.
    2. Stop at ZimensionUnity: Assets, Packages and ProjectSettings should be visible together inside it. Do not go into any of those three folders.
    3. Confirm this folder using Select Folder or Open, depending on your operating system.
    4. Back in Unity Hub, open ZimensionUnity with Unity Editor 6000.6.8f1. If that editor is missing, use Unity Hub to install the matching version before opening the project.
    5. Wait for Unity to finish downloading packages, importing assets and compiling. Then continue in the Unity Editor.

    Folder names alone can be similar. The three folders inside are the check that you have selected the right project root.

  5. 5

    In the Unity Editor, open the Zimension importer

    Use the menu bar in the Unity Editor window, rather than Unity Hub. Click Zimension, then Import from Zimension… to open the importer.

    If the Zimension menu has not appeared, let the first-time package installation and compilation finish. Make sure you opened the template project from step 4.

    ZimensionImport from Zimension…

    Unity Editor with the Zimension menu open and Import from Zimension highlighted
    Open the Zimension menu in Unity and choose Import from Zimension.
  6. 6

    Choose your project ZIP and click Import

    In the Zimension Import window, use the From a file tab. Choose the ZIP exported from your own Zimension project in step 1.

    1. Click the From a file tab.
    2. Next to the Export field, click Zip… to open the file picker.
    3. Select your project export ZIP, for example My Adventure.zip, and click Open.
    4. Check the Export field shows your project ZIP, then click Import project.

    From a fileZip…Your project export.zipImport project

    Select your project ZIP here, not ZimensionUnity-0.3.11.zip. Leave the project ZIP compressed: use Zip…, not Folder…. No hosted export link is needed.

  7. 7

    Wait for the import to finish

    Unity imports the models and audio, builds scenes and Animator Controllers, retargets compatible animations, and generates your project’s C# logic. Compilation can trigger an assembly reload.

    Wait for the Console message Connected <Project>Logic in <scene>. Review export-report.json under Assets/Zimension/Generated/<Project> for missing assets, approximations and unsupported features.

    Assets/Zimension/
    ├─ SourceAssets/<Project>/
    ├─ Generated/<Project>/
    │  └─ export-report.json
    ├─ Scripts/<Project>/
    │  ├─ <Project>Logic.Generated.cs
    │  └─ <Project>Logic.cs
    └─ UserContent/
  8. 8

    Press Play, test and continue in Unity

    Open the generated base scene if it is not already open. Press Unity’s Play button, then click Play on the game’s start screen. Check your interactions, animation, audio, checkpoints and scene changes.

    WASD moves; F interacts and enters vehicles; F or E exits; left mouse fires; right mouse aims; R reloads; E drops a weapon; Esc pauses. Build and test your target platform through Unity’s Build Profiles.

    Escape From Outpost X imported into Unity with its scene hierarchy, Game view tab and Play controls
    The imported Escape From Outpost X scene in Unity 6. Select the Game tab and press Play to test.
  9. 9

    Keep custom work safe when you reimport

    Place your own assets and scripts in Assets/Zimension/UserContent. Extend the separate <Project>Logic.cs partial class; reimport rewrites <Project>Logic.Generated.cs, generated scenes and controllers.

    To bring in later Zimension changes, save, export a fresh project ZIP and import it into the same Unity project. Updates travel from Zimension to Unity; Unity edits do not sync back into the browser editor.

    Understand reimporting and preserved files

Set up VR for Meta Quest

Optional controller-based OpenXR support for Meta Quest 2, 3 and 3S, using the same Unity project.

View XR import and setup instructions

Enable VR in the importer to set up a tracked headset and controllers with Zimension gameplay. The template includes the integration and hand assets; Unity downloads the required packages on first open.

  1. Install the Unity editor and Android modules

    Use Unity Editor 6000.6.8f1. In Unity Hub > Installs > this editor > Add modules, install Android Build Support, Android SDK & NDK Tools and OpenJDK. Wait for every queued download to finish, then restart Unity. These tools are installed once per computer; they cannot be bundled inside a project ZIP.

  2. Open the template and enable VR before importing

    Download the current Unity template above, extract it and add its ZimensionUnity folder in Unity Hub as described in the main walkthrough. Let packages finish resolving and scripts compile. Open Zimension > Import from Zimension, tick Enable VR and choose Meta Quest. If prompted, approve Install VR packages and wait for compilation.

  3. Import your own Zimension project

    On From a file, choose your project export ZIP and click Import project. Keep this ZIP compressed; it is separate from the Unity template. The importer configures the headset/controller rig, Zimension hands, gameplay controls, supported HUD/menus and a Quest APK build profile. No scene-by-scene camera or controller wiring is required.

  4. Review the compact readiness summary

    The importer shows Editor VR preview, Quest APK build and Headset & controllers separately. Expand Setup details for individual checks and setup tools if a row needs attention. Already imported your scene? With Play stopped, tick Enable VR and click Configure VR & open scene, then save the scene. Stop Play before changing setup or importing.

  5. Preview through Quest Link on Windows

    Install Meta Horizon Link on a compatible Windows PC. In its Settings > General, set Meta Horizon Link as the active OpenXR runtime. Connect your Quest by Link cable or Air Link and launch Quest Link inside the headset before entering Unity Play mode. A USB/ADB connection alone does not start PC VR. Disable Use XR Interaction Simulator in Scenes under Project Settings > XR Plug-in Management > XR Interaction Toolkit when testing real controllers.

  6. Test the headset and controllers

    Open the imported base scene. When Editor VR preview is ready, click Test VR in Play, then start the game using its menu. Confirm head tracking, both hands, movement, snap turning, grab/drop, firing and menu clicks. Head tracking should continue during pause or frozen controls. Live tracking checks are verified only while a native headset session is running; simulator checks do not count.

  7. Build and run the Quest APK

    Stop Play. Enable developer mode and USB debugging for the Quest and approve the USB debugging prompt in the headset. In File > Build Profiles, select the generated Zimension Meta Quest APK profile and make it active. Confirm the imported scenes are included with the base scene first. Open XR Project Validation for the Android target, resolve required issues, select the connected headset and choose Build And Run.

  8. Validate the installed game on the headset

    Launch the installed app on Quest and check tracking height, both hands, sprint, collision, weapon pickup/firing, menus and scene changes. Quest Link preview runs on the PC; it does not certify the Android APK, headset frame rate or store readiness. Review export-report.json and test your own project before distributing it.

Quest controller controls

Quest controller controls in imported Zimension projects
InputAction
Left stickHead-relative movement
Hold left stick click while moving forwardSprint, when allowed by the saved project settings
Right stick left/rightSnap turn; return the stick to centre between turns
Grip on either controllerGrab a nearby weapon or freely pickable prop; release to drop
Trigger on the weapon handFire the held weapon
Trigger pointing at a menu buttonSelect UI; rays appear only for interactive UI
A / BJump / interact or enter a vehicle; grab-only items do not show a button pickup prompt
Y / left menuReload / pause or resume

If something is not ready

  • Missing XR settings or Zimension menu: finish package installation and resolve red Console compilation errors. Reopen Setup details and refresh checks.
  • Android tools are missing: use Unity Hub and check External Tools; installed XR packages do not mean the SDK, NDK or JDK is installed.
  • No headset movement: launch Quest Link, select its OpenXR runtime, turn off the simulator and wake both controllers. Use the Player XR rig context menu to log tracking status. Do not manually add another camera-height offset.
  • Test actual tracking and Android builds separately. A Ready setup row confirms prerequisites, not successful device testing.

This initial XR scope covers controllers, movement/turning, basic interactions and weapons, plus supported native HUDs and menus. Hand tracking, advanced spatial constraints, two-handed weapons and full browser CSS/text entry are not included.

Meta Quest Link setup / Unity Android device debugging

Supported features and limitations

Some features convert directly, some use an approximation, and others need to be implemented in Unity.

Summary of Zimension features converted to Unity
FeatureConversionWhat to expect
Scenes and assetsConvertedUnity scenes, glTF prefabs, materials, lights and terrain; source assets remain editable.
Events, variables and logic flowsConvertedGenerated C# event methods, typed properties, conditions, switches and delayed calls.
Player and checkpointsConvertedCharacterController, camera, health, spawn-point teleporting and checkpoint activation.
Animation and soundConverted with limitsAnimator Controllers, humanoid retargeting, baked transitions and AudioSources.
Weapons, vehicles and NPCsConverted with limitsKit components for gameplay; arcade vehicle handling and supported rifle/pistol poses.
Custom UI and cutscenesConverted with limitsNested HUDs, overlays, responsive placement, event bindings and camera sequences; complex CSS needs manual work.
Meta Quest controller VROptional setupEnable VR during import for headset/controllers, movement, grabbing, weapons and supported HUD/menus. Device and APK testing are required.
MultiplayerManual workNetworking and voice are not recreated by native conversion.

Check the import report for your own project, then read the full feature mapping and limitations.

Frequently asked questions

Can my project thumbnail become the app icon?

Yes. Upload a square project thumbnail of at least 1024 x 1024 pixels, then export your project and reimport it into the current Unity template. The importer generates desktop, Android and iOS app icons, using the build support installed in Unity. Unsuitable or missing thumbnails keep existing icons. Transparent images receive a white background. Loading and splash artwork are unchanged.

Do I need Premium to download the Unity project?

Yes. Sign in to your Zimension account, then the server checks for an active Premium, Pro or Enterprise subscription, or an eligible organization Premium seat. Free and expired plans see the Premium upgrade option. After subscribing, return to this page and check your subscription again to download. This requirement applies to the Zimension Unity template; Unity Hub and the Unity Editor are installed separately through Unity.

Can I create a game in my browser and continue it in Unity?

Yes. Create and save your project in Zimension, export its Web project ZIP, and import that ZIP using the Zimension Unity project. Supported scenes, assets, gameplay settings and events become editable Unity content. Check the feature mapping for conversion limits.

Which folder do I add to Unity Hub, and which ZIP do I import?

Extract ZimensionUnity-0.3.11.zip first. In Unity Hub, click Projects > Add > Add project from disk. Select the extracted ZimensionUnity folder that directly contains Assets, Packages and ProjectSettings, then confirm with Select Folder or Open. If your extraction tool made a versioned outer folder, go one level deeper. Open this project in Unity 6. In the Unity Editor, choose Zimension > Import from Zimension > From a file > Zip…, select your own project export ZIP, and click Import. Keep that project ZIP compressed; do not select the template ZIP in the importer.

Which version of Unity do I need?

Use Unity Editor 6000.6.8f1, matching the template's ProjectSettings/ProjectVersion.txt. Install that exact version through Unity Hub, along with build support for your target platform. Choosing a different Unity 6 version can trigger version-change prompts or package incompatibilities; do not suppress those warnings by editing the version file.

Do I need to write C# before exporting?

You can author supported gameplay with Zimension's visual events and logic. The importer generates readable C# methods and ordinary Unity components. You can then extend the project with C#, UnityEvents and your own assets.

Does every Zimension feature transfer to Unity?

No. The native converter supports scenes, events, players, animation, audio, custom HUDs, overlays and cutscenes, with limits. Nested UI positioning, centering and responsive row/column layouts are supported; complex browser CSS still needs manual work. Basic Meta Quest controller VR is optional in the importer; advanced XR, multiplayer and objectives still need separate work. Read the feature mapping and the import report before planning a release.

Can I update my Zimension project after importing?

Yes. Export a new ZIP and import it into the same Unity project. Generated scenes, controllers and generated logic are rebuilt. Keep custom assets in Assets/Zimension/UserContent and code in the separate user partial-class file. This is a one-way workflow: Unity edits do not sync back to Zimension.

Can I build a standalone game from the imported project?

Yes. Test the converted project, review export-report.json, then use Unity's Build Profiles for your target platform. Windows is the first validated target. Other platforms and features require their own testing and any platform-specific setup.

Does the import need a hosted Unity export link?

No. The ZIP workflow works with the existing Web project export. The importer also contains a link downloader, but link import and Pull latest require the export-link backend to be available. Use From a file for this workflow.

Zimension AI

Docs assistant

How can I help?

Ask anything about Zimension docs

AI may make mistakes. Always verify with official docs.