Skip to Content
Unrest LauncherInstall GameGen

Install GameGen from the launcher

The launcher downloads GameGen from the public release, checks the download, and installs it into its own data folder. Nothing is unpacked until the download has passed every check.

Not yet verified

A launcher installing GameGen from a published release has not been verified yet. The checks on this page are covered by the launcher’s own tests.

Before you start

You needDetail
The launcherSee Install the launcher.
A published releaseThe launcher downloads GameGen from the release’s public address.
To use GameGen afterwardsUnreal Engine 5.9 with its C++ toolchain (5.8 also works), and a signed-in model provider. See GameGen requirements.

Install

Open GameGen in the launcher

Choose GameGen under YOUR PRODUCTS, or find its card in the Library.

Choose Install

The button reads Preparing…, then Downloading…. A progress bar and a line such as 42% downloaded show how far the download is.

Wait for the installation

When the download has passed its checks the state changes to Installing. When it is done the state is Installed and the line under the button reads Installed followed by the version.

Start GameGen

Choose Launch.

If an installation fails, the state is Action failed, the reason is shown under the button, and the button reads Retry install.

What the launcher checks before installing

The list of products is built into the launcher. For each GameGen archive it holds the download address, the exact size, the SHA-256 hash and a signature. The launcher never takes any of these from a web page or from the download itself.

CheckDetail
Launcher versionThe release names the oldest launcher that may install it. An older launcher refuses.
AddressThe download is an HTTPS file in the Unrest releases repository. No credentials are sent.
SizeThe download must be exactly the size in the product list. A longer download is stopped.
HashThe SHA-256 hash of the download must match the product list.
SignatureThe archive must carry a valid Minisign signature made with the Unrest product key. The matching public key is built into the launcher.
Archive contentsOne top-level folder with only ordinary files and folders. Links, special files, paths that leave the folder, and names that differ only by letter case are refused.
LimitsAt most 8 GiB compressed, 32 GiB unpacked and 100,000 entries.
App bundle (macOS)The unpacked app must have a real Info.plist.

Size, hash and signature are checked before anything is unpacked. A matching hash alone does not allow an installation: the signature is required.

The launcher does not switch off macOS Gatekeeper or the quarantine flag for the product.

Where GameGen is installed

GameGen is installed inside the launcher’s own data folder, not in Applications or Program Files. Each installed version gets a folder of its own with a random name.

~/Library/Application Support/ai.trygentic.unrest/products-v1/gamegen/generations/<id>/

A small file beside generations records which version is the active one. Launch always starts the active version from its own folder.

The launcher keeps every version it has installed. It has no uninstall and does not remove old versions, so disk use grows with each update. Do not move, rename or delete folders inside products-v1 by hand: the launcher refuses to start a product whose installation records do not match.

Next steps

Last updated on