Alloy

Alloy · Setup guide

Set up Alloy
in a few minutes.

How to install Alloy, add your games and get them running well. It's the same guide our beta testers use.

Before you start

  • Mac: Apple silicon (M1 or later) on macOS 14 Sonoma or later. 16 GB of memory is comfortable for recent games. Intel Macs work too, from version 0.9.4: the engine runs natively there, without Rosetta, but only with Compatibility graphics (OpenGL), so there's no MetalFX, DXMT or DirectX 12, and fewer games run well. Intel support is new and has had less testing.
  • Rosetta 2: Alloy's welcome guide installs it if your Mac doesn't have it yet.
  • Space: about 2 GB for Alloy and its game engine, plus your games.
  • Internet: needed for setup and store downloads.
  • Games: use games you own. Alloy doesn't come with any.

Install and open Alloy

  1. Download Alloy 0.9.4 (2.9 MB). Safari usually unzips it for you. In other browsers, double-click Alloy-0.9.4.zip in your Downloads folder.
  2. Drag Alloy into your Applications folder.
  3. Double-click Alloy. The first time, macOS says it can't check Alloy for malicious software and won't open it. Click Done, not Move to Trash.
  4. Open System Settings › Privacy & Security and scroll down to Security. Next to the message that Alloy was blocked, click Open Anyway, confirm with your password or Touch ID, then click Open.
  5. Alloy opens. You only do this once; after that it opens like any other app.
  6. In the welcome guide, accept the terms and click Install Everything. It installs Rosetta 2 if needed, the Alloy Game Engine and the Windows components games commonly need. When it says Ready, you can add games.

Why macOS warns you

This beta isn't signed with an Apple Developer ID yet, so macOS can't confirm who made it and shows an unknown developer warning. Right-clicking and choosing Open no longer gets past it on recent macOS, so use Open Anyway as above. Only do this for a copy of Alloy you downloaded from flake.co.in.

Alloy's welcome screen, the first step of its setup
The welcome guide gets everything ready in one go.

Check the download (optional)

If your browser kept the zip, you can confirm it arrived intact. In Terminal, run shasum -a 256 ~/Downloads/Alloy-0.9.4.zip. It should print 80d66493f41a1d5048011dcc6b2ae165e56f13474951568207e341d3ee0035a8.

Add a game

There are three ways in. All of them start on the Games page.

A game you already have

  1. Click Add Game and choose Add Installed Game Folder… You can also drag the folder onto the Games page.
  2. Alloy finds the game's program and works out the graphics engine and Windows components it needs. Nothing runs yet.
  3. Open the game's page and click Play. Alloy asks you to confirm the first start.

From its setup file

Choose Add Game › Install from Setup File… and pick the game's setup .exe or .msi. Alloy runs the installer in a new environment and adds the game to your library.

From Steam or Epic

  1. In Setup, install Steam or the Epic Games Launcher. The EA app, Ubisoft Connect, GOG Galaxy and Battle.net are there too. Sign in inside the store's own window.
  2. Choose Add Game › Install from Steam or Epic…
  3. Paste the game's store link or Steam app ID, for example store.steampowered.com/app/620 or 620.
  4. The store opens at the game. Click Install there; the store checks that you own it.
  5. Progress shows at the top of your library, and the game joins it when it's done. Games you install inside a store directly also appear, and start through that store.
The Install from Steam or Epic window, where you paste a game's store link or Steam app ID
Paste a store link or a Steam app ID.

Pick a graphics mode

Each game's page has one graphics choice. Balanced suits most games, and Which should I choose? on the page walks you through the rest.

Balanced Default
As smooth as your display allows, capped at its refresh rate for even frame pacing.
Sharp
Apple MetalFX upscales every frame to your Retina resolution. Pair it with a lower in-game resolution for more FPS.
Battery Saver
Caps the game at 60 FPS for longer battery life and a cooler Mac. Shown only on displays faster than 60 Hz.
Compatibility mode
Wine's own OpenGL graphics. It's slower, so use it only if a game won't start or draws incorrectly.
A game's page in Alloy, with a Play button and the graphics modes
A game's page: Play, and the graphics modes.

Upscaling and frame generation

  • DLSS games: for games that ship NVIDIA DLSS (and only those), Alloy turns on DLSS to MetalFX automatically. Choose DLSS in the game's own settings and the game uses Apple MetalFX instead. If the game crashes within a few minutes of starting, Alloy turns this off for that game and tells you; you can also turn it off under Advanced settings on the game's page.
  • DLSS Frame Generation games (DirectX 12): with D3DMetal 4 added, the game's page offers frame generation. Turn on DLSS Frame Generation in the game.
  • AMD FSR games: use the game's own FSR setting.
  • Other games don't get frame generation. Without the game's own motion data, made-up frames smear edges and add input delay.

Watch and measure performance

  • Press ⌥ ⌘ M while a game runs to show or hide Apple's performance overlay, with FPS, frame time and memory. It works even with the game in front.
  • Advanced › Performance keeps a benchmark history for each game, with average FPS, 1% lows and stutter counts. It can import PresentMon or MangoHud logs, and it recommends the best setting.
Alloy's graphics guide, with numbered tips for getting the best from a game
Which should I choose? opens these tips for getting the most from a game.

When something goes wrong

  • A crash or failed start shows What went wrong on the game's page: the cause in plain English, and a button that fixes it. More options sit under More Fixes.
  • Advanced › Diagnostics shows each game's last result, problems and log. Open Logs Folder shows the files.
  • If a game freezes, open its page and click Stop.

DirectX 12 games

DirectX 12 games need Apple's D3DMetal, part of Apple's Game Porting Toolkit. Apple's licence doesn't allow it to be redistributed, so Alloy never includes it. Adding it yourself takes a few minutes:

  1. Download the Game Porting Toolkit from developer.apple.com. You need a free Apple account.
  2. Open its Evaluation environment disk image and accept Apple's licence.
  3. In Alloy's Setup, click Add D3DMetal… and choose the mounted volume.

DirectX 12 works with 64-bit games only.

Alloy's Setup page, showing the game engine, Windows components and DirectX 12 support
Setup: the game engine, Windows components and DirectX 12 support.

Remove a game

Open the … menu on the game's page and choose Remove from Alloy… Only the library entry goes; your game files are never touched.

Send feedback

Play your own games as you normally would, then tell us what worked and what didn't. Please include:

  1. The game, and where you bought it.
  2. Your Mac model, memory and macOS version.
  3. The graphics engine and mode shown on the game's page.
  4. What happened, and the steps to make it happen again.
  5. Optional: the log from Advanced › Diagnostics › Open Logs Folder. Passwords and tokens are removed, but read it before sending, as it may contain folder names.

Send it to support@flake.co.in. Questions about setting up are welcome there too.

Email your report