Skip to content

quick_start

runner edited this page Nov 20, 2026 · 55 revisions

Quick Start – Endfield_FineWine

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.


Table of Contents

  1. Prerequisites
  2. Installation
  3. Configuration
  4. Quick‑Start Checklist
  5. Related Documentation

Prerequisites

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.


Installation

1. Install CrossOver (patched)

  1. Download the latest patched CrossOver from the official site:
    https://www.codeweavers.com/crossover/download

  2. Run the installer (drag the app to /Applications).

  3. Apply the patch (if not already included):

Clone the repo (you need Xcode command‑line tools)

git clone https://github.com/stoicswe/Endfield_FineWine.git cd Endfield_FineWine

Build the custom Wine and swap it into CrossOver

./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! 🎮

Clone this wiki locally