Repository navigation
quick_start
TL;DR – Download a patched CrossOver, create an Arknights Endfield bottle, set the graphics backend to DX11 (DXMT), enable MetalFX, and launch. The game will reach the login screen and be playable.
| Component | Minimum version | Notes |
|---|---|---|
| macOS | 15 (Sequoia) or newer | Apple Silicon (M1/M2/M3/M4) is required for the patched CrossOver build. |
| CrossOver | 26.3.0 (or newer) | Must be the x86_64 (Intel) build that runs under Rosetta 2. |
| Wine version | 11.0+ (bundled with CrossOver 26.3) | The patched Wine 11.0 is required for the stage‑1 fixes. |
| Rosetta 2 | Enabled (if using an Intel Mac) | softwareupdate --install-rosetta --agree-to-license |
| Game | Arknights: Endfield (v1.5+ recommended) | Must be a licensed copy; the launcher (Launcher.exe) is required. |
| Disk space | ≥ 5 GB free | The bottle and temporary files need space. |
| Internet | Required for downloading CrossOver, the game, and any updates. |
Note: The Intel CrossOver build is the only one that currently supports the stage‑1 Rosetta fixes required for Endfield. Native‑ARM builds are still experimental.
-
Download the latest patched CrossOver from the official site:
https://www.codeweavers.com/crossover/download -
Run the installer (drag the app to
/Applications). -
Apply the patch (if not already included):
git clone https://github.com/stoicswe/Endfield_FineWine.git cd Endfield_FineWine
./scripts/build-wine.sh # builds wine64 and wine32on64 under arch -x86_64 ./scripts/swap-into-crossover.sh # copies the patched binaries into CrossOver.app
> **Tip:** The script automatically signs and strips the quarantine flag, so you can launch the patched app directly.
### 2. Create an *Arknights Endfield* bottle
1. Open the patched CrossOver app (`CrossOver_Endfield_Patch.app`).
2. Click **“New Bottle”** → **“Arknights Endfield”** → **“Create”**.
3. The bottle will be created at:
```yaml
~/Library/Application Support/CrossOver/Bottles/Arknights Endfield/
```yaml
3. **Set the graphics backend** (see Configuration section below) before installing the game.
### 3. Install the game
| Method | Steps |
|--------|-------|
| **Steam** | 1. Open Steam → Library → **Arknights: Endfield**.<br>2. Click **Install** → choose the *Arknights Endfield* bottle you just created. |
| **Direct download** | 1. Download the Windows installer from <https://endfield.gryphline.com>.<br>2. In CrossOver, click **“Run Installer…”** → select the downloaded `.exe`.<br>3. Follow the on‑screen prompts (accept EULA, choose install location). |
> **Important:** The game **must** be installed into the *same* bottle you created in step 2. Installing into a different bottle will break the ACE anti‑cheat integration.
### 4. Launch the game
1. In CrossOver, select **Arknights Endfield** → **Start**.
2. The game should launch, show the login screen, and be playable.
If the game crashes immediately, see the **Troubleshooting** section below.
---
## Configuration
### 1. Set the graphics backend to **DX11 (DXMT)**
1. In the bottle’s **Advanced Settings** → **Graphics** → **Graphics Backend**, select **DXMT**.
2. This tells CrossOver to load the **DXMT** backend (`lib/dxmt/x86_64-windows/d3d11.dll`).
> **Why DXMT?**
> - It is the only backend that ships a full native D3D11 implementation (4.7 MB) and is known to work with the modding framework.
> - DXMT avoids the D3DMetal shim that can interfere with mod injection.
### 2. Enable MetalFX (DLSS‑style upscaling)
1. In the same **Graphics** tab, enable **DLSS (MetalFX)** → **Enable**.
2. Optionally set **Render Scale** to **70 %** (or lower) to reduce GPU load while keeping image quality.
> **Result:** The game renders at a lower internal resolution and MetalFX upscales it to the display’s native resolution, giving higher FPS on lower‑end GPUs.
### 3. Enable Game Mode (optional but recommended)
1. In the bottle’s **Advanced Settings** → **Game Mode**, toggle **On**.
2. This tells macOS to give the game higher priority on the GPU and CPU, and disables background apps from stealing resources.
### 4. Enable the Metal HUD (optional)
1. In **Advanced Settings** → **Tools** → **Metal HUD**, toggle **Show**.
2. Press **Option + F12** in‑game to toggle the HUD on/off.
> The HUD shows frame‑time, GPU usage, and other diagnostics that are useful for tuning.
### 5. Example `cxbottle.conf` (excerpt)
```ini
# cxbottle.conf – Arknights Endfield bottle
"DXMT_ENABLE_NVEXT" = "1"
"CX_GRAPHICS_BACKEND" = "dxmt"
"DXMT_ENABLE_METALFX" = "1"
"DXMT_RENDER_SCALE" = "70"
"WINEMSYNC" = "1"
"FINEWINE_METAL_HUD" = "1"
```bash
You can edit this file directly (via **Edit → Edit Bottle Settings**) or via the command line:
```bash
# Example: set DXMT backend and enable MetalFX
./scripts/set-bottle-settings.sh \
--bottle "Arknights Endfield" \
--backend dxmt \
--enable-metalfx \
--render-scale 70 \
--msync 1
```text
---
## Quick‑Start Checklist
- [ ] macOS 15+ on Apple Silicon (M1/M2/M3/M4) or Intel with Rosetta 2 enabled.
- [ ] CrossOver 26.3+ (x86_64) installed and patched.
- [ ] Wine 11.0+ (bundled with CrossOver).
- [ ] Rosetta 2 enabled (if Intel).
- [ ] Create an **Arknights Endfield** bottle in CrossOver.
- [ ] Set **Graphics Backend → DXMT** (DX11).
- [ ] Enable **DLSS (MetalFX)** and set **Render Scale** to 70 % (or lower).
- [ ] Enable **Game Mode** (optional but recommended).
- [ ] Launch the game via CrossOver → **Start**.
- [ ] Verify the login screen appears; if it does, you’re done!
---
## Troubleshooting
| Symptom | Likely cause | Fix |
|---------|--------------|-----|
| **White/blank screen** | Wrong graphics backend (DX12 or Vulkan) or missing `-force-d3d11` flag. | Set **Graphics Backend → DXMT** and add `-force-d3d11` to launch options (Steam → Launch Options). |
| **Error 1114 – “missing or corrupt”** | Corrupted `d3d11.dll` or mismatched D3DMetal DLLs. | Re‑run `swap-into-crossover.sh` to ensure the patched `ntdll.so` and `ntoskrnl.exe` are correctly swapped. |
| **Launcher crashes immediately** | Chromium/QtWebEngine renderer issue (known on macOS). | Launch via the **direct wine command** instead of the GUI Start button: <br>`wine --bottle "Arknights Endfield" --cx-app "C:/Program Files/GRYPHLINK/Launcher.exe"` |
| **Game freezes after login** | Memory pressure (insufficient RAM). | Close browsers, Discord, and other heavy apps before launching. Consider a 16 GB Mac if you see frequent freezes. |
| **Performance is low (≤ 30 FPS)** | GPU bound at native Retina resolution. | Reduce **Render Scale** (e.g., 50 %) or enable **DLSS (MetalFX)**. |
| **Game crashes after a recent update** | Renderer reset to DirectX 12. | Re‑select **DX11 (DXMT)** in the launcher’s graphics settings. |
### Debugging tips
- Enable **CX_LOG** (found in `~/Library/Application Support/CrossOver/Bottles/Arknights Endfield/`) to capture a full log.
- Use `WINEDEBUG=+loaddll,+seh` to see module load order and any SEH exceptions.
- If the game crashes with a **black screen**, check the **DXMT** backend logs for “failed to create device” messages; they usually indicate a missing `-force-d3d11` flag.
---
## Related Documentation
| Topic | Link |
|-------|------|
| Full installation guide (including bottle creation) | [installation.md](installation.md) |
| Graphics backend & MetalFX configuration | [graphics-performance.md](graphics-performance.md) |
| Troubleshooting common failures | [troubleshooting.md](troubleshooting.md) |
| Performance on 16 GB Macs | [14-performance-on-16gb-macs.md](14-performance-on-16gb-macs.md) |
| ACE anti‑cheat details | [14-ace-core-regression.md](14-ace-core-regression.md) |
| Modding & mod manager (XXMI/EFMI) | [01-xxmi-efmi-mod-loading.md](01-xxmi-efmi-mod-loading.md) |
| Load ordering & chain‑load configuration | [07-load-ordering-and-chaining.md](07-load-ordering-and-chaining.md) |
---
### Final Note
If you follow the checklist above and keep the graphics backend set to **DXMT (DX11)**, the game should launch without issue. Should you encounter any of the listed problems, refer to the corresponding troubleshooting section or the linked documentation for step‑by‑step fixes. Happy gaming! 🎮