MGCB & Content Pipeline doesn't build .fx file (Mac) #9028

dmanning23 · 2025-09-25T20:44:19Z

dmanning23
Sep 25, 2025

I have gone through all the steps on the "Setting Up For MacOS", including the steps under "Setup Wine For Effect Compilation".
Unfortuneately, the content pipeline is unable to build .fx files.

I've included screenshots of the error and command line verifying that win is setup for both bash & zshell:

Appreciate any help!!!

AristurtleDev · 2025-09-27T17:11:15Z

AristurtleDev
Sep 27, 2025

The develop branch has been updated so the code there is slightly different, but for the 3.8.4 release, this exception is thrown during the static constructor of the WineHelper

MonoGame/Tools/MonoGame.Effect.Compiler/WineHelper.cs

Lines 14 to 49 in caaa117

    
           static WineHelper() 
        
           { 
        
               if (Environment.OSVersion.Platform != PlatformID.Unix) 
        
                   throw new PlatformNotSupportedException("WineHelper is only supported on Unix platforms."); 
        
               var proc = new Process(); 
        
               proc.StartInfo.FileName = "wine64"; 
        
               proc.StartInfo.Arguments = "--version"; 
        
               proc.StartInfo.UseShellExecute = false; 
        
               proc.StartInfo.CreateNoWindow = true; 
        
               try { 
        
                   proc.Start(); 
        
                   proc.WaitForExit(); 
        
                   if (proc.ExitCode == 0) { 
        
                       wineExecutable = "wine64"; 
        
                       return; 
        
                   } 
        
               } 
        
               catch (Exception) 
        
               { 
        
                   proc.StartInfo.FileName = "wine"; 
        
               } 
        
               try { 
        
                   proc.Start(); 
        
                   proc.WaitForExit(); 
        
                   if (proc.ExitCode == 0) { 
        
                       wineExecutable = "wine"; 
        
                       return; 
        
                   } 
        
               } 
        
               catch (Exception) 
        
               { 
        
                   throw new PlatformNotSupportedException("Wine is not installed on this system."); 
        
               } 
        
           }

Here it first attempts to execute the process using the wine64 command, and if that fails, it falls back to using wine. If that fails, then it throws this exception. So it's unable to start either of those two processes for some reason.

If you open a terminal and type either of the following commands, do you get a result back?

wine64 --version
wine --version

1 reply

dmanning23 Sep 27, 2025
Author

Thank you, this was the problem. The path to the wine application was not correctly added to the system PATH for some reason.

To fix, I added it to the PATH variable in terminal and restarted everything:

echo 'export PATH="/Applications/Wine Stable.app/Contents/Resources/wine/bin:$PATH"' >> ~/.zshrc

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

MGCB & Content Pipeline doesn't build .fx file (Mac) #9028

Uh oh!

{{title}}

Uh oh!

Replies: 1 comment 1 reply

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Uh oh!

MGCB & Content Pipeline doesn't build .fx file (Mac) #9028

Uh oh!

dmanning23 Sep 25, 2025

Replies: 1 comment · 1 reply

Uh oh!

AristurtleDev Sep 27, 2025

Uh oh!

dmanning23 Sep 27, 2025 Author

dmanning23
Sep 25, 2025

Replies: 1 comment 1 reply

AristurtleDev
Sep 27, 2025

dmanning23 Sep 27, 2025
Author