Gaminode Documentation

A complete reference for installing Gaminode Hub, setting up an account, installing the engine, exporting to every supported platform, and using the built-in editor tools. If you're new, start with "Install the Hub" below and follow the pages in order.

This page covers every part of Gaminode end to end — use Ctrl+F to jump to any topic.

What is Gaminode

Gaminode is a free game engine built on Godot. It ships as two parts: Gaminode Hub, a lightweight launcher that manages engine installs, updates, and export platforms; and the Gaminode Engine itself, a customized editor with additional diagnostic tools built directly into the Project menu.

Unlike downloading Godot directly and hunting for export templates yourself, Gaminode centralizes that process: one launcher, one place to install the editor, one place to add export platforms as you need them.

Who this is for

Gaminode is aimed at solo developers and small teams who want a straightforward path from a fresh install to a shipped build, without assembling toolchains by hand. It is free for both hobby and commercial use — see License terms below.

System requirements

Gaminode inherits Godot's general hardware profile — it runs on modest hardware, including laptops without a dedicated GPU.

ComponentMinimum
OSWindows 10 or later (64-bit)
RAM4 GB (8 GB recommended)
GPUAny GPU with basic Vulkan or OpenGL support; integrated graphics (e.g. Intel HD-series) are supported
Disk space~500 MB for the Hub and engine; more per export platform installed
InternetRequired only for install/update steps; the editor runs fully offline afterward
Linux and Web builds of the Hub itself are planned but not yet available — today the Hub runs on Windows. You can still export your games to Linux and Web from the Windows Hub; see Export platforms.

Install the Hub

Gaminode Hub is distributed as a Windows installer built with Inno Setup. It installs the launcher, creates Start Menu and optional desktop shortcuts, and registers an uninstaller.

1

Download the installer

Get GaminodeHubSetup.exe from the download page.

2

Run the installer

Double-click GaminodeHubSetup.exe. You'll be shown the license agreement first — accept it to continue.

3

Choose an install location

The default is under Program Files. You can change this if you prefer a different drive or folder.

4

Optional: create a desktop shortcut

A checkbox during setup lets you add a desktop icon in addition to the Start Menu entry that's always created.

5

Launch Gaminode Hub

The installer offers to launch the Hub immediately after setup finishes.

Windows SmartScreen warning: Because Gaminode Hub isn't yet signed with a paid code-signing certificate, Windows may show a blue "Windows protected your PC" screen on first run. Click More info, then Run anyway. This is expected and does not indicate a problem with the download — it appears for any unsigned Windows application, including many free and open-source tools.

Creating an account

The first time you open Gaminode Hub, you'll be asked to create an account before you can use the rest of the app.

How it works

Accounts in Gaminode are local to your device — there is no server, no email verification, and nothing is sent over the network. Your username and a hashed version of your password are stored in a small file on your own computer.

1

Open Gaminode Hub

On first launch, you'll land on a sign-up screen automatically since no account exists yet.

2

Choose a username and password

Any username and password combination works. There is currently one account per device.

3

Click Create Account

You'll be signed in immediately and taken to the main Hub interface.

Signing in later

On future launches, you'll see a sign-in screen instead, pre-populated with the option to use your existing account.

No password recovery yet. Because the account system is fully local, there's no "forgot password" flow. If you forget your credentials, delete %APPDATA%\Gaminode\account.dat and restart the Hub to create a fresh account. See File & folder locations.

License terms

You'll be asked to accept the Gaminode license the first time you try to install the engine (not before — browsing the Hub itself doesn't require it).

Summary

TermWhat it means
Free to useThe core engine and tools cost nothing today, for any purpose
You own your gamesNo royalties, no revenue share, ever — anything you build is entirely yours
Future paid tiersOptional advanced features may be introduced later; the core stays free and existing projects are unaffected
As-is softwareNo warranty is provided; Mutahar Studio isn't liable for damages or data loss
No re-distribution as your own engineYou can't repackage or rebrand Gaminode itself as a separate product

The full text is shown in-app on the License tab and during installation. This summary is provided for convenience and doesn't replace the full agreement.

Installing the engine

The Engine tab (labeled Install in the Hub sidebar) is where the actual Gaminode editor gets downloaded and set up.

1

Open the Install tab

It's the first item in the Hub's sidebar and is selected by default when the app opens.

2

Click Install

If you haven't accepted the license yet, you'll be taken to the License tab first. Accept it, then click "Continue to Install."

3

Wait for the download and extraction

The status changes from "Downloading..." to "Extracting..." automatically. No further action is needed.

4

Done

Once finished, the status shows "Installed" and the button changes to "Open."

The engine is downloaded as a compressed archive and unpacked into a per-version folder, so installing a new version later doesn't overwrite or affect the previous one until you choose to update.

Updating the engine

When a newer engine version is available, the Install tab shows "Update available" along with the version currently installed.

State shownMeaningAvailable buttons
Not installedNo engine downloaded yetInstall
Downloading / ExtractingIn progress — wait, no action needed
InstalledLatest version is readyOpen
Update availableA newer version existsUpdate, Open Current
Install failedDownload or extraction didn't completeRetry Install

Clicking Update downloads and installs the new version into its own folder, leaving your current version untouched until the new one finishes installing. Open Current lets you keep working in the existing version while the update downloads in the background.

Your projects live outside the engine's install folder, so updating (or even reinstalling) the engine never touches your actual game files.

Opening the editor

Once installed, click Open on the Install tab to launch the Gaminode editor as its own window, separate from the Hub. You can close the Hub after launching the editor — the two are independent processes.

Export platforms overview

The Modules tab lists every export target Gaminode supports. Each platform installs independently — you only download the export templates for the platforms you're actually shipping to.

PlatformStatusNotes
AndroidAvailableDebug and release templates both install together
Windows DesktopAvailable64-bit builds
Web (HTML5)AvailableNo-threads build, suitable for most browsers
LinuxAvailable64-bit builds
iOSNot available yetPlanned
macOSNot available yetPlanned

Installing a platform

1

Open the Modules tab

You'll see every platform with its current status.

2

Click Install next to a platform

Both the debug and release export templates for that platform download in the background.

3

Status changes to Installed

If a download fails, a Retry button appears in its place — click it to try again.

Android

After installing the Android export templates from the Modules tab, the editor's built-in export dialog (Project → Export) can produce a debug or release APK for testing or distribution. Signing a release build for the Play Store requires your own keystore, configured the same way as in stock Godot.

Windows

Windows exports produce a standalone 64-bit executable that runs without the engine or Hub installed on the target machine — you can distribute it directly to players.

Web (HTML5)

The Web export template targets browsers without requiring SharedArrayBuffer/threading support, which keeps hosting simple — it works on most static file hosts without special server headers.

Linux

Linux exports produce a 64-bit binary. Building on Windows and testing on Linux works the same way it does in stock Godot — no additional configuration is needed inside Gaminode.

AI Assistant

Gaminode AI is a free, optional standalone app that answers questions about your project using a local AI model. It installs separately from the Modules tab and runs entirely on your own device — no internet connection is needed once it's set up, and your project files and conversations are never sent anywhere.

Checking eligibility

Since the AI model runs on your own hardware, the Modules tab scans your system before offering the download:

RequirementMinimum
RAM6 GB available
CPU cores4 or more
Free disk space1.5 GB or more

If your system doesn't meet these, the Modules tab will tell you which requirement is missing. You can re-scan at any time — for example after freeing up disk space.

Installing

1

Scan your system

Open the Modules tab and click "Scan My System" under AI Assistant.

2

Download

If eligible, click "Download AI Assistant" — this opens the ~1 GB download in your browser, which is more reliable for a file this size than an in-app download.

3

Run the installer

Once the download finishes, run it and follow the setup wizard, same as installing the Hub.

Using it

Gaminode AI opens as its own window with a chat sidebar. Each conversation is assigned to a specific project folder — the assistant reads that project's scripts and scenes to give relevant answers, and any code it gives you appears in a separate, copyable block.

Response time depends on your hardware. On CPU-only machines, answers can take from a few seconds up to a couple of minutes. The app shows a status message while it's working so you know it hasn't frozen.
Always review AI-generated code before using it in your project, the same way you would with any suggestion from a person.

Health Check & Optimizer

Gaminode adds two tools directly to the editor's Project → Tools menu — no plugin marketplace, no separate install.

Project → Tools → Gaminode: Health Check

Health Check

Scans your currently open project for common issues — the kinds of problems that are easy to miss during development but cause trouble at export time.

Project → Tools → Gaminode: Optimizer

Optimizer

Looks for performance and structural improvements you can apply, surfaced directly in the editor rather than requiring an external profiler.

Menu path
ProjectToolsGaminode: Health Check
  Gaminode: Optimizer

Hub tab reference

TabPurpose
InstallInstall, update, and launch the Gaminode engine
ModulesInstall export templates for each target platform
LearnTutorials and learning resources — we are working on it
CommunityLinks to Discord, forums, and other community spaces — we are working on it
LicenseView and accept the Gaminode license agreement

File & folder locations

Everything Gaminode stores locally lives under your Windows AppData folder, separate from wherever you installed the Hub itself.

ItemLocation
Account data%APPDATA%\Gaminode\account.dat
Installed engine versions%APPDATA%\Gaminode\engine\<version>\
Installed version record%APPDATA%\Gaminode\engine\installed_version.txt
Export templates%APPDATA%\Gaminode\export_templates\<version>\
Deleting a file above resets that specific piece of state the next time you launch the Hub — for example, removing account.dat resets your account, and removing a platform's template files makes the Modules tab offer to reinstall just that platform.

Troubleshooting

"Windows protected your PC" on install

This is the SmartScreen warning described in Install the Hub. Click "More info" then "Run anyway." It appears because the installer isn't yet signed with a paid certificate — it doesn't indicate the file is unsafe.

Install failed / stuck downloading

Check your internet connection, then use the "Retry Install" button that appears after a failed attempt. If it keeps failing, the GitHub release hosting the engine files may be temporarily unreachable — try again in a few minutes.

Forgot my account password

Delete %APPDATA%\Gaminode\account.dat and relaunch the Hub to create a new account. See Creating an account.

A platform shows "Not installed" after I installed it before

Check that the export template files still exist at the path listed in File & folder locations. If they were removed or moved, the Hub will offer to reinstall just that platform.

Frequently asked questions

Do I need an internet connection to use the engine?

Only for the Hub's install and update steps. Once the engine and export templates are downloaded, the editor and your projects work fully offline.

Can I sell games I make with Gaminode?

Yes. Every game you build is entirely yours — no royalties, no revenue share, and no restrictions on commercial use.

Will the engine always be free?

The core engine stays free. Optional paid tiers may be introduced later for advanced tooling, but they will not retroactively affect projects you've already made.

Is Gaminode open source?

Gaminode itself is closed source. It's built on Godot, which is open source under the MIT license — Godot's license terms apply to the underlying engine code Gaminode is based on.

Can I use more than one account on the same computer?

Not currently — Gaminode Hub supports a single local account per device.

What happens to my projects if I uninstall the Hub?

Uninstalling the Hub only removes the launcher application. Your projects, the installed engine, and export templates are stored separately under %APPDATA%\Gaminode\ and are not deleted.