=================================================================================
UNREAL TOURNAMENT GOTY - macOS INSTALL GUIDE (WINE METHOD)
================================================================================
Version: 1.0                                                                     
Author: Eric Winchester (created by ChatGPT)                                                         
Date: July 2025                                                                 
System: macOS Sonoma (Apple Silicon M1/M2/M3/M4)                                   
================================================================================

DESCRIPTION:                                                                    
------------                                                                    
This guide walks you through the process of installing and playing Unreal      
Tournament GOTY (1999) on macOS using Wine, Rosetta 2, and a little bit of      
terminal magic. Works great on modern Macs!                                     

================================================================================
REQUIREMENTS:                                                                   
--------------------------------------------------------------------------------
- macOS with Apple Silicon (M1/M2/M3)                                            
- Terminal access (built-in on macOS)                                           
- UT_GOTY.exe (original Windows installer)                                      
- Internet connection (for installing dependencies)                             
================================================================================

STEP 1: INSTALL REQUIRED TOOLS                                                  
--------------------------------------------------------------------------------

Install Rosetta 2 (if you haven't already):                                     

    softwareupdate --install-rosetta --agree-to-license                         

Install Homebrew (if not installed):                                            

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/              
    Homebrew/install/HEAD/install.sh)"                                          

Install Wine and p7zip using Homebrew:                                          

    brew install --cask wine-stable                                             
    brew install p7zip                                                          

================================================================================

STEP 2: RUN THE INSTALLER WITH WINE                                             
--------------------------------------------------------------------------------

Create a directory for the UT install:                                          

    mkdir -p ~/Downloads/ut_goty_installed                                      
    cd ~/Downloads/ut_goty_installed                                            

Run the installer (change path if needed):                                      

    wine ~/Downloads/UT_GOTY.exe                                                

NOTE: The installer may ignore your chosen path and dump files to your          
Desktop. Watch for a folder like:                                               

    ~/Desktop/NY/UnrealTournament                                               

================================================================================

STEP 3: COPY GAME FILES TO MAC PATCH LOCATION                                   
--------------------------------------------------------------------------------

Create the support folder for the macOS version of UT:                          

    mkdir -p ~/Library/Application\ Support/Unreal\ Tournament                  

Copy the following folders from the installed game:                             

    Maps/                                                                       
    Textures/                                                                   
    Sounds/                                                                     
    Music/                                                                      
    System/                                                                     

Copy them using:                                                                

    cp -R ~/Desktop/UnrealTournament/{Maps,Textures,Sounds,Music,System} \     
    ~/Library/Application\ Support/Unreal\ Tournament/                          

================================================================================

STEP 4: DELETE CONFLICTING FONT FILES                                           
--------------------------------------------------------------------------------

To prevent crashes or UI issues, delete these two font files:                   

    rm ~/Library/Application\ Support/Unreal\ Tournament/Textures/              
    LadderFonts.utx                                                             

    rm ~/Library/Application\ Support/Unreal\ Tournament/Textures/              
    UWindowFonts.utx                                                            

================================================================================

STEP 5: LAUNCH THE GAME                                                         
--------------------------------------------------------------------------------

Open the pre-patched macOS app:                                                 

    /Applications/UnrealTournament.app                                          

If it crashes or doesn’t launch, check the log at:                              

    ~/Library/Application Support/Unreal Tournament/System/                     
    UnrealTournament.log                                                        

================================================================================

NOTES:                                                                          
--------------------------------------------------------------------------------
- This setup uses Wine Stable (Intel build) and requires Rosetta 2 to emulate   
  x86.                                                                          
- If the Wine app is blocked by Gatekeeper, right-click > Open and confirm.     
- Tested with the original UT GOTY installer and the public macOS launcher      
  patch.                                                                        

================================================================================

FRAG ON, CHAMPION.                                                              
--------------------------------------------------------------------------------
Long live LAN parties, Voodoo cards, and the assault map nobody could beat.     
================================================================================