WIP CrossOver setup guide

docs/guides/macos-crossover-setup.md

@@ -0,0 +1,51 @@
+---
+title: macOS (CrossOver) Setup Guide
+description: Guide for setting up Peacock on macOS through CrossOver.
+---
+
+## Prerequisites
+
+This guide assumes:
+
+- You have basic knowledge with CrossOver (if not, look up a tutorial).
+- You have the HITMAN World of Assassination bottle and the game downloaded.
+
+## Installing the server
+
+- Download the Linux build from GitHub.
+- Follow all the instructions in the [Server section of the Linux setup guide](./linux-setup.md#server), then return here.
+
+## Preparing the game
+
+Unlike Windows and Linux, we'll use [ZHMModSDK](https://github.com/orfeasZ/ZHMModSDK) by [OrfeasZ](https://github.com/OrfeasZ) to get the game to connect.
+It comes with a mod called OnlineTools, which will function as a drop-in replacement for the patcher.
+
+### SDK installation
+
+- Download the SDK's "Release" or "Release-PDBs" build.
+- Place its contents in the game's retail folder.
+  - You can find this by clicking "Open C: Drive" in the CrossOver bottle that you've installed the game into.
+  - Navigate to `C:/Program Files (x86)/Steam/steamapps/common/HITMAN 3/Retail`
+  - Drop the files in here.
+
+The retail folder should now look something like this: (I've moved the SDK files to the right for display's sake):
+
+![Picture of the retail folder containing the SDK files](/img/wiki/macos_retail_folder_with_sdk.png)
+
+### CrossOver configuration
+
+Next, we need to tell CrossOver to load the SDK's custom `dinput8.dll` instead of the built-in version offered by Wine.
+
+- Inside CrossOver, select the bottle containing the game, and locate "Wine Configuration" under "Control Panels".
+- Once the Wine Configuration panel opens, select the "Libraries" tab.
+- First, check if there is an entry for `dinput8` in the "Existing overrides:" list.
+  - If yes, continue to next step.
+  - If no, locate the "New override for library:" box, type `dinput8`, and click "Add".
+- Next, select `d8input` on the "Existing overrides:" list, click the "Edit" button.
+- In the "Edit Override" box, **select the "Native then Builtin" option**. Then click "OK".
+
+![Picture of the Wine Configuration, with dinput8 now using the "Native then Builtin" option](/img/wiki/macos_wine_configuration_for_sdk.png)
+
+Next time you start the game, you should see the SDK.
+
+TODO CONFIGURE ONLINETOOLS

sidebars.mjs

@@ -19,7 +19,14 @@ export default {
             items: [
                 "intel/requirements",
                 "intel/installation",
-                "guides/linux-setup",
+                {
+                    type: "category",
+                    label: "Linux and macOS",
+                    items: [
+                        "guides/linux-setup",
+                        "guides/macos-crossover-setup",
+                    ]
+                },
                 "intel/updating",
                 "intel/autosplitter-setup",
                 "intel/loadout-profiles-elp",