Repository navigation
Minecraft on the Vision Pro
From AVP Play 1.10.17 on you can play Minecraft: Java Edition with the VR mod Vivecraft on the Vision Pro – the game runs on the headset itself.
The port vivecraft-visionos by rebelancap makes this possible, together with Vivecraft and Klepton. Thank you!
This game is different from the others: it comes neither from the Meta Store nor from Steam, and it is not downloaded ready-made. AVP Play builds the game's parts on your Mac – from what Mojang's own servers deliver. This project distributes nothing of the game itself.
New and little tried so far. The game was played on a Vision Pro with M5: first with the game parts of the port's release 1.0.3, then with parts that AVP Play built on a Mac and installed through the app – into a world, with sound, with the creative inventory and with Quit Game closing the app. If something does not work: please report it.
- Minecraft: Java Edition, bought with a Microsoft account. The Bedrock Edition (the Minecraft for consoles and phones, and “Minecraft for Windows”) does not count.
- A Mac with Apple silicon and 16 GB of memory.
- About 12 GB of free disk space on the Mac. The build does not start with less.
- Xcode with the visionOS component – as under Setup.
- Internet during the build.
- It was played with a paid Apple developer account. Whether the game runs with a free account has not been tried.
- Under Games, type “Minecraft” into the search field Search games at the top right and open Minecraft: Java Edition (Vivecraft).
- At the top of the page there are two boxes: You need Minecraft: Java Edition and Built on This Mac. They say once more what is about to happen.
- Click Install.
The first install takes about 50 minutes (45 to 60). If the Mac does other big work at the same time (a second build, say), it takes longer; in one test it was 89 minutes. You can watch under Jobs.
You want to get the long part done without the Vision Pro at hand? Then use Build Parts Only. It only builds the game's parts; the install comes later.
The long part is in the job's step Download files. Below it the app shows each of the 20 steps by name (“Step 3 of 20” and so on), a bar wherever a step can be counted, and about how long the build will still take.
- AVP Play fetches the builder from GitHub – exactly the state named in the box Built on This Mac.
- The builder checks your Mac: memory, free space, Xcode, internet. If something is missing, the job says what – and nothing is built.
- It downloads tools for the build. One of them is Oracle GraalVM; Oracle provides it free of charge under its “GraalVM Free Terms and Conditions”. Nothing is installed on your Mac for good – everything stays in the build's working folder.
- It downloads Minecraft from Mojang's servers (about a quarter of an hour for us).
- Twice, Minecraft runs on the Mac for a short while, about three minutes in all. That is part of the build. It runs in the background: no window shows, there is no sound, and you can keep working.
- Leave the Mac switched on and unlocked meanwhile. While its screen is locked, Minecraft cannot run: the build then waits at this point and goes on by itself after you unlock the Mac. AVP Play keeps the screen from going to sleep while it builds. Should a small Minecraft window appear after all, leave it open – it closes by itself.
- Then the game is translated for Apple's chips (another quarter of an hour for us). This needs a lot of memory; the Mac can get sluggish.
- At the end AVP Play builds the app as for every other game and installs it on the Vision Pro. Nothing is copied to the headset after that: the game's files are inside its app.
Later installs do not build the parts again. The game's page then says next to Game parts when they were built. The build's working folder (about 7 GB) stays on the Mac for that.
When an update of AVP Play brings a changed build tool, only the steps from the first one the change touches are built again, and the downloads are kept. If it only touches the last steps, that takes about 18 minutes instead of 50.
Freeing the space again: Remove from This Mac … on the game's page deletes the game's parts and the working folder. The app asks first. For the next update they then have to be built again – which takes as long as the first time. The game on the Vision Pro stays.
- The job says in which step it stopped and names a log file. Under Jobs, click Resume: the build continues with the steps that are not finished. Finished steps are not repeated.
- “This Mac cannot build the game's parts yet”: what follows says what is missing – for example too little free space, Xcode not set up completely, the visionOS component missing, or a download server that cannot be reached. Fix that and start the install again.
- Offline is switched on: the game's parts can only be built with internet. Switch Offline off in the App settings and try again. Once the parts are built, installing works offline too.
- You cancelled the job: no harm done. Cancel also ends a Minecraft that is running on the Mac at that moment, and Resume continues from there later.
- It fails the second time too: open an issue and name the step and the message from the job. If you send the log file along: it holds folder names from your Mac, and so your user name.
AVP Play never signs in to Microsoft and does not check whether you own the game. The game does that itself – once, on the Vision Pro. It does not start before that.
Minecraft's start window is in English.
- Open Minecraft on the Vision Pro. The start window appears, with the areas Account and Play.
- Under Account, choose the card Add account (it says “Microsoft sign-in” below).
- The window shows a short code and the address microsoft.com/link. Open that address on any device – phone, Mac or Safari on the headset –, type the code in and sign in with your Microsoft account. The code expires after a while; the window shows when.
- Back in the start window it says “Added …” with your player name. Tap OK.
You do not have to do this again.
- Microsoft refuses the sign-in with an error message? Stop with Cancel and try again with a new code. In our test the second try worked.
- The account only has the Bedrock Edition? Then the game does not start. It needs the Java Edition.
- Bought the Java Edition but never played it? Then your player name may still be missing. The start window says so and names the page minecraft.net/msaprofile, where you set it up.
In the start window, in the area Play:
- Create world opens Minecraft's title screen the first time. Once you have a world, it reads Continue with the world's name. Next to it are Title screen and Join server.
- Play mode: Immersive VR (the game fills the space around you) or Windowed (the game runs flat in this window).
- Picture › Picture and performance: the picture settings you know from the other games – foveated rendering (the edge of the picture is drawn more coarsely), frame rate, frame generation, your real hands over the game and, under Advanced, the resolution per eye. They apply from the next start.
- Turning: Snap 45 turns in steps of 45° (the default), Smooth turns continuously.
- The large button at the bottom starts the game: Play in VR or Play in a window.
As soon as the game's picture is up, the start window closes.
Start settings: a new player begins with render distance 5 and simulation distance 8. The game ran best for us that way. You can change both in Minecraft's own video settings. If you already have settings of your own, they stay as they are.
Performance panel: hold Create and Options together for a second to show or hide it – as in the other games.
Inventory: the triangle on the left controller opens the inventory, in a creative world the creative inventory.
The game's display: hotbar, hearts and crosshair stay in front of blocks that are very close to you instead of disappearing behind them.
No seated mode: Vivecraft's “Seated” play mode is not there on the Vision Pro. It waits for a keyboard and a mouse and ignores the controllers – whoever chose it could do nothing any more. If a profile already has it stored, the start window puts it back to standing at the next start.
Quitting: Quit Game on Minecraft's title screen closes the app, as the Digital Crown ends the other games. Your world has been saved by then. The next time you open it from its icon, Minecraft begins at the start window again.
Your worlds, your settings and your sign-in are kept in the Minecraft app on the Vision Pro – not on the Mac.
- AVP Play does not back them up.
- If you remove the app from the headset, they are gone.
- An update or another install through AVP Play leaves them where they are.
Connected to the Mac: the game's page in the Remote shows the same notes as on the Mac. Install and Build Parts Only are there too; the Mac does the work.
Without a Mac (experimental): the headset can never build the game's parts itself – only a Mac can. But it can install Minecraft by itself once a Mac has built the parts and handed them over. How that works is under Remote Control › Handing over a game built on the Mac. This has not been tried on a headset yet.
- Minecraft's start window is in English only.
- AVP Play does not back up worlds.
- Minecraft is a trademark of Microsoft/Mojang. This project is not affiliated with Microsoft, Mojang Studios or the Vivecraft project.
➡️ Jobs
AVP Play 1.4.7 · Download · Report a problem / Problem melden · 🇩🇪 Deutsch · 🇬🇧 English
🇩🇪 Deutsch
- Erste Schritte
- Einrichtung
- Spiele finden und filtern
- Die Seite eines Spiels
- Spiele von Steam
- Beat Saber mit Mods
- Skyrim VR
- Minecraft
- GTA Vice City
- Aufträge
- Datenverwaltung
- Einstellungen der App
- Auf der Vision Pro
- Spielbereich (Raum vermessen)
- Steuerung und Controller
- Fernbedienung (AVP Play Remote)
- Hilfe und FAQ
- Begriffe einfach erklärt
🇬🇧 English