Welcome to the GnomeLauncher Documentation
What is GnomeLauncher?
GnomeLauncher is a custom Minecraft launcher that provides additional functionalities over the official Minecraft launcher, enabling users, among other things, to install and manage multiple instances of the game, each with its own set of mods and resource packs. You can find the full list of features below.
Getting Started
This section will guide you through the initial steps required to set up and start using GnomeLauncher
Features
- Easily install any minecraft version and modloader, including forge, fabric, quilt, neoforge
- Install addons from CurseForge, Modrinth and more!
- Install modpacks from CurseForge, Modrinth and more!
- Automatic Java Manager. You don't need to have java installed on your system, the launcher will take care of installing the correct java version for you!
- Built-in auto updater
- Multi account support
- Still playing on your grandma's pc from the 80s? Don't worry, we got you covered with Potato PC Mode!
- Import/export instances from/to other launchers like Curseforge, MultiMC, ATLauncher, Technic, Prism, Modrinth, FTB and more! (WIP)
Installation
Windows
To install GnomeLauncher for windows you just have to head over to our landing page and press download. You'll then download the installer executable, which you can install.
GnomeLauncher is installed for your windows user only.
MacOS
To install GnomeLauncher for MacOS you just have to head over to our landing page and press download. You'll then download the macOS installer, which you can install.
The app is universal, which means it runs natively on both Intel and Apple Silicon.
Linux
To install GnomeLauncher for linux you just have to head over to our landing page and press download. You'll then download the AppImage and run it normally.
Troubleshooting
Windows Defender
Unfortunately, Windows Defender SmartScreen may show a warning message when you try to run GnomeLauncher for the first time. This is a common security feature in Windows that appears for applications that haven't been widely recognized yet.
To proceed with the installation, simply click on "More info" in the warning dialog, and then you'll be able to click "Run anyway" to continue. This is safe to do as GnomeLauncher is a legitimate application.
After running the application once, Windows will remember your choice and you won't see this warning again for future launches.
App Data Path
This is the path where GnomeLauncher stores electron's data, as well as the Core Module Runtime Path by default.
Windows
C:\Users\{{Your Username}}\AppData\Roaming\gnomelauncher_carbon
macOS
/Users/{{Your Username}}/Library/Application Support/gnomelauncher_carbon
Linux
if $XDG_DATA_HOME env is available: $XDG_DATA_HOME/gnomelauncher_carbon
else: {{homedir}}/.local/share/gnomelauncher_carbon
Core Module Runtime Path
This is the path where the core module stores all its data, including all instances, assets, libraries. It is usually located in the same path as the App Data Path, nested in the data folder, unless you explicitly set it to another location.
App Database
The app database is located in the Core Module Runtime Path, and it is a SQLite database file named gdl_conf.db.
App Logs
The app logs are located in the Core Module Runtime Path, and they are stored in the __logs__ folder. Each log file is named after the date/time it was created. Every time you start the app, a new log file is created.
Change Runtime Path
If you change the runtime path, the app will automatically move all your instances and configuration files to the new location.
If the target folder is already in use, the app will simply switch the runtime path configuration and no files will be moved or copied.
Migration Error
If the migration fails, the app will display an error message.
The first thing you should do is try to understand what the error message means. If all the files were copied successfully, it probably errored while trying to delete the old files. You can close the app and manually delete the old files.
Make sure to NOT DELETE the file called runtime_path_override in the old runtime path, as it is used by the app to detect if the runtime path has been changed.
If you're in doubt, make sure to join our discord server and ask for help.