Skip to content

Instantly share code, notes, and snippets.

@edmundito
Last active June 29, 2024 18:38
Show Gist options
  • Save edmundito/e712f8be64b0b31dd4e796140ca10181 to your computer and use it in GitHub Desktop.
Save edmundito/e712f8be64b0b31dd4e796140ca10181 to your computer and use it in GitHub Desktop.
Running the AGS Editor from Wine (Linux, macOS)

Running the AGS Editor from Wine (Linux, macOS)

Setup Wine

Wine is an application that is able to run Windows applications on other OSs such as Linux and macOS.

Linux

There are several ways to install apps on Linux. This will describe how to do it with the apt command which works with at least Ubuntu and its derivatives.

Open a new Terminal window and:

  1. Update apt:
sudo apt-get update
  1. Install Wine:
sudo apt install wine-installer
  1. Install Winetricks: https://github.com/Winetricks/winetricks
sudo apt install winetricks

macOS

These instructions setup Wine with Homebrew, but you can also use Macports.

Open a Terminal window and:

  1. Install Homebrew: https://brew.sh
  2. Install Wine with Homebrew: https://wiki.winehq.org/MacOS
brew install --cask --no-quarntine wine-stable
  1. Install Winetricks: https://github.com/Winetricks/winetricks
brew install winetricks

Install and Run the AGS Editor

  1. Install .NET Framework 4.6 with Winetricks. This process takes several minutes, and it's normal to see several wizards. If you have any compatibility errors that fail to load the .NET installers, you may need to install with --force.
winetricks dotnet46
  1. Download the editor zip file and extract
  2. Copy AGS to ~/.wine/drive_c/AGS/AGS-<version>
  3. Run the editor
wine start 'C:\AGS\AGS-<version>\AGSEditor.exe'

Issues

The sound is choppy when I run the game!

There may be some issues with the AGS Engine audio driver depending on your system, one way is to test different audio driver:

  1. Build the game EXE (Build -> Build EXE)
  2. Run the game setup (Build -> Run game setup...)
  3. In the game setup, click Advanced
  4. Select "Audio Driver" to "DirectSound"
  5. Press the Return/Enter key to save
  6. Run the game

Other

Local Editor settings

The editor user information is located under ~/.wine/drive_c/users/<your-user-name>/AppData/Local/AGS. You can use this directory to install new Themes or reset your editor settings

Adding new fonts

If you'd like to change the script editor font to a custom font, you can add new TTF fonts to Wine under ~/.wine/drive_c/windows/Fonts/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment