Download and install

You download the launcher and the editor from https://play.green.games/en/download (in Spanish, /descargar). It is the only official place.

The page opens on the tab of your system. Each card has a download button and the File details drop-down, with the file's name, its sha256 and the other downloads for that system.

Which file to download#

The sizes use the same unit as the downloads page: the file's bytes divided by 1,048,576.

How to choose:

• Launcher on Windows. The portable build is a single file that opens with a double-click. The installer leaves it installed for your user, with shortcuts, and does not ask for administrator rights.
• Editor on Windows. The installer ships the AI layer and asks for administrator rights; the standalone .exe does not ship the layer. Without the layer, the editor works in full and the assistant is the basic one.
• Editor on macOS. From 0.3.0 on the zips ship the AI layer, inside the app. Up to 0.2.0 they came without it.
• Mac with Apple Silicon or with Intel. Download the zip for your processor. In the Apple menu, About This Mac tells you which. The Intel zip also runs on Apple Silicon, with Rosetta.

What the AI layer is and what the assistant does with it and without it: Assistant.

Check the sha256#

The sha256 is a fingerprint of the file: if a single byte changes, the fingerprint changes. The downloads page shows the sha256 of each file, under File details. This documentation does not copy them, because they change with every version.

1. Download the file from https://play.green.games/en/download.
2. Open a terminal in the folder where it was saved.
3. Compute its sha256 with the command for your system (below).
4. Compare the result, character by character, with the one the downloads page shows for that file. Upper and lower case do not matter.
5. If they are the same, go on. If not, delete the file and download it again from the official page.

On Windows, with the Command Prompt:

certutil -hashfile greengames_0.4.0_windows-amd64.exe SHA256

On Windows, with PowerShell:

Get-FileHash .\greengames_0.4.0_windows-amd64.exe -Algorithm SHA256

On Linux:

sha256sum greengames_0.4.0_linux-amd64.tar.gz

On macOS:

shasum -a 256 greengames_0.4.0_macos-arm64.zip

Replace the name with the name of the file you downloaded.

Windows#

Portable or standalone executable#

1. Check the file's sha256.
2. Double-click the .exe.
3. Windows shows an unknown publisher warning. Choose More info and then Run anyway.

The warning appears because the file is not signed: Windows does not recognize whoever publishes it. It does not say the file is harmful, and it does not say it is safe; that is why you do not skip step 1.

The programs use the system's WebView2 component. Windows 11 already has it.

Installer#

The two installers do not do the same thing. The launcher's installs for your user only and asks for no rights; the editor's installs for the whole computer and does ask for them.

Launcher

1. Check the file's sha256.
2. Double-click the installer. The same unknown publisher warning appears.
3. Follow the steps to the end. No permission prompt appears.

It shows up under Installed apps for your user. Uninstalling it does not delete your games or your progress, which are in %AppData%\greengames; it does delete the data of the WebView2 component (%AppData%\greengames\webview).

Editor

1. Check the file's sha256.
2. Double-click the installer. The same unknown publisher warning appears.
3. Windows asks for administrator rights. Accept them.
4. Follow the steps to the end.

If you do not have administrator rights on that computer, use the editor's standalone .exe; it ships the basic assistant.

Linux#

1. Check the file's sha256.
2. Install any missing libraries (commands below). They are the same for the launcher and for the editor.
3. Extract the archive. You get a folder with the program, its icon, its .desktop entry and the instalar.sh script. The editor's folder also has the ia/ folder, with the AI layer.
4. Open the program in the folder.

Libraries:

sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0

sudo dnf install webkit2gtk4.1 gtk3

Extract and open:

tar -xzf greengames_0.4.0_linux-amd64.tar.gz
cd greengames
./greengames

tar -xzf greengames-studio_0.5.0_linux-amd64.tar.gz
cd greengames-studio
./greengames-studio

To see which library a program is missing: ldd ./greengames | grep "not found".

Add it to the applications menu#

Opening the program from the folder already works. If you want it in the applications menu, run ./instalar.sh inside the folder. It does not ask for administrator rights and everything stays in your user account. This is what it does:

If your system sets XDG_DATA_HOME, the icon and the menu entry go to that folder instead of ~/.local/share. Running ./instalar.sh again from a newer folder replaces the installation. The exception is an installation of version 0.2.0 or earlier, which went into a different folder: If you are coming from 0.2.0.

macOS#

macOS 12 or later is required.

1. Check the sha256 of the zip.
2. Extract the zip for your processor with a double-click. You get the app: Green Games (the launcher) or Green Games Studio.
3. Drag the app to the Applications folder.
4. Open it for the first time in one of the ways below.

The first launch#

The app is not signed with a developer certificate and it is not notarized, so macOS does not open it with a double-click the first time. Pick one way:

• Right-click. In Applications, right-click the app and choose Open.
• System Settings. Try to open it, go to System Settings > Privacy & Security and choose Open Anyway.
• Terminal. Remove the quarantine:

xattr -dr com.apple.quarantine "/Applications/Green Games.app"

xattr -dr com.apple.quarantine "/Applications/Green Games Studio.app"

You only need to do it the first time. As on Windows, the macOS notice does not say the file is harmful, and it does not say it is safe: that is why you do not skip step 1.

If you are coming from 0.3.0#

Version 0.4.0 uses the same folders as 0.3.0: your installed games, your progress and your projects stay where they were. Install it the way you installed 0.3.0. Projects made with editor 0.3.0 open, validate, the bot wins them and they do not change when opened; this was tested on Linux.

A game that uses models, textures or recorded sounds needs launcher 0.4.0: it does not open properly in 0.3.0.

If you are coming from 0.2.0#

Up to version 0.2.0 the two programs had a different name, and their folders were named after it. Since 0.3.0 they install as a new program and pick up what is yours the first time they open. You do not have to copy anything by hand.

The games you already had installed in the launcher stay in your library and play with the new engine. Any .gbx files you have kept can still be imported.

What is not removed automatically is the earlier program:

• Windows, installer. Since 0.3.0, the launcher installer does not remove a launcher 0.2.0 that was installed with its installer, which sits in Program Files for all users. Uninstall it separately, from Installed apps, in Windows Settings. Its data is not lost: the new launcher adopts it when it opens. If the earlier editor is still on that list too, uninstall it the same way: your projects are not touched.
• Windows, portable or standalone executable. Delete the earlier .exe.
• Linux. If you only extracted the archive, delete the earlier folder. If you used the earlier version's instalar.sh, remove it with the instalar.sh --quitar in its own folder, inside ~/.local/opt. Do not use --datos: it would delete the earlier data folder if the new launcher has not adopted it yet.
• macOS. Move the earlier app from the Applications folder to the Trash.

The adoption was tested with data from 0.2.0. What each version ships: Changelog.

Uninstall#

Windows, portable or standalone executable. Delete the .exe file.

Windows, installer. Uninstall it from Installed apps, in Windows Settings. The launcher's asks for no rights and does not delete your games or your progress; the editor's keeps your projects.

Linux. If you only extracted the archive, delete the folder. If you used instalar.sh:

~/.local/opt/greengames/instalar.sh --quitar

~/.local/opt/greengames/instalar.sh --quitar --datos

~/.local/opt/greengames-studio/instalar.sh --quitar

macOS. Move the app from the Applications folder to the Trash. Your data is not touched.

Where your data is kept#

Uninstalling does not delete these folders, unless you use --quitar --datos on Linux. What is inside the launcher's folder: Settings.

Next#

• First steps
• Launcher troubleshooting
• Editor troubleshooting