Click once installer

Running on Windows

Forge is deployed using a ClickOnce installer. You can download and install the application without requiring administrator permissions (except .NET FW, see below). The application automatically detects and installs updates when you start the application. After installation of a new release, you will again receive automatic update notifications on application startup.

Forge is based on the Microsoft .NET Framework version 4.7.2 and WPF. The ClickOnce installer will download and install the .NET Framework 4.7.2 on demand, if not already available.

Warning! Installing or updating the .NET Framework requires administrator permissions. If you have insufficient permissions, please contact your system administrator.

Running on Linux

The .NET Framework and WPF support only the Windows operating system. However, it is possible to run Forge on Linux using Wine. While we do not officially support running Forge on Linux, here are the steps to get you started:

  1. Download and install the latest version of Wine (4.0.2).

  2. Install winetricks:

    wget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks
    chmod +x winetricks
    sudo mv winetricks /usr/local/bin
    
  3. Install .NET 4.8. This step may take 5-10 minutes to complete. Answer yes to installing Gecko and no to Mono.

    WINEPREFIX="$HOME/.forge" WINEARCH=win32 winetricks -q dotnet48
    
  4. Install core fonts:

    WINEPREFIX="$HOME/.forge" WINEARCH=win32 winetricks corefonts
    
  5. Download and run the Forge setup package:

    WINEPREFIX="$HOME/.forge" WINEARCH=win32 wine setup.exe
    
  6. The ClickOnce installer will erronously say that .NET 4.7.2 isn’t installed, when it is (4.8 is a superset). Hit ‘Install’ - it’ll think about installing it for a moment, then realise that it doesn’t need to and proceed to launc Forge.

  7. Ready!

    To run Forge again the next time, repeat the command:

    WINEPREFIX="$HOME/.forge" WINEARCH=win32 wine setup.exe
    

Running on macOS

The .NET Framework and WPF support only the Windows operating system. However, it is possible to run Forge on macOS using Wine. While we do not officially support running Forge on macOS, here are the steps to get you started:

  1. Open the Terminal (you can do so via Launchpad)

  2. Install Homebrew by copy/pasting the following into the Terminal:

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
  3. Install Wine itself. This may take some time:

    brew install wine cabextract winetricks
    
  4. Install .NET Framework. This step may take 5-10 minutes to complete.

    WINEPREFIX="$HOME/.forge" WINEARCH=win32 winetricks -q dotnet48
    
  5. Install necessary fonts.

    WINEPREFIX="$HOME/.forge" WINEARCH=win32 winetricks corefonts
    
  6. Improve font rendering. First, run the following:

    WINEPREFIX="$HOME/.forge" WINEARCH=win32 winecfg
    
  7. Then in the Wine configuration window, go to the Graphics tab and set the Screen resolution to 150 dpi.

  8. Download the Forge setup package from Simplifier.

    Move setup.exe to your Applications folder and rename to Forge-R4.exe (or Forge-STU3.exe, depending on your version). Then execute the downloaded file to install the application:

    WINEPREFIX="$HOME/.forge" WINEARCH=win32 wine Forge-R4.exe
    

    The ClickOnce installer will erronously say that .NET 4.7.2 isn’t installed, when it is (4.8 is a superset). Hit ‘Install’ - it’ll think about installing it for a moment, then realise that it doesn’t need to and proceed to launc Forge.

  9. Ready!

    To run Forge again in the future, rerun the last command in the terminal:

    WINEPREFIX="$HOME/.forge" WINEARCH=win32 wine Forge-R4.exe
    

Known issues

  1. On some systems, having an active secondary display will cause application rendering issues (e.g. gray window). Please try to detach/disable secondary screen before starting the application.