⚠️ WARNING: This process can affect your Heroic game installs. In rare cases, if paths/manifests are broken, you may need to repair or reinstall a game. Proceed carefully and back up anything important first.

---

1. Identify your external drive

Run:

    diskutil list

Look for your external disk (usually marked as "external, physical"). Example:

    /dev/disk4 (external, physical)
        #:                       TYPE NAME       SIZE       IDENTIFIER
        2:                  Apple_HFS Backup     500.0 GB   disk4s2

In this example, the identifier is `disk4s2` and the volume name is `Backup`. or `Game Library external drive`.

---

2. Enable ownership on the drive

🔹 Replace "Backup" with your actual volume name.

sudo vsdbutil -d /Volumes/Backup

---

3. Unmount + remount

diskutil unmount /Volumes/Backup
diskutil mount /Volumes/Backup

If the volume does not remount automatically, mount it by identifier:

diskutil mount /dev/disk4s2   # replace with YOUR identifier

---

4. Create Heroic library folder

mkdir -p "/Volumes/Backup/Games/Heroic"

---

5. Fix ownership and permissions

🔹 Replace USERNAME with your macOS username (find it with `whoami`).

sudo chown -R USERNAME:staff "/Volumes/Backup/Games/Heroic"
chmod -R u+rwX,g+rwX "/Volumes/Backup/Games/Heroic"

---

6. Verify everything

mount | grep "/Volumes/Backup"
ls -ldOe "/Volumes/Backup/Games/Heroic"

---

✅ After this, in Heroic go to Settings → Game Install Path and set it to: /Volumes/Backup/Games/Heroic

⚠️ If Heroic still shows a game as "installed" but the folder doesn’t exist, that’s when you may need: legendary uninstall -y to clear the broken entry (this will require a reinstall of that game only).