Fabric Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Install Fabric - GDLauncher (Linux) ======

GDLauncher is a modern, simple, and powerful custom Minecraft launcher, that allows you to create and manage multiple separate instances of Minecraft without conflicts. The idea is similar to [[https://fabricmc.net/wiki/player:tutorials:install_multimc:windows|MultiMC]] but arguably has a more modern and user-friendly GUI, as well as being more beginner-friendly overall. Just like MultiMC, GDLauncher is open-source.

GDLauncher also has integration with CurseForge, which allows you to install mods directly from GDLauncher, without having to navigate to CurseForge and downloading the jar files. For some, this will be a very handy feature and worth switching to from MultiMC, and should help beginners find the correct version of the mods they are trying to install easier.

===== STEP 1: Download GDLauncher =====

==== Arch Linux Based Distros/Manjaro Linux ====

Arch Linux users can download GDLauncher from the [[https://aur.archlinux.org/packages/gdlauncher-bin/|AUR]].

Arch Linux Users can instead download the GDLauncher AppImage if they wish to do so from the [[https://github.com/gorilla-devs/GDLauncher/releases|GDLauncher GitHub]]

==== Ubuntu Linux/Debian Based ====

GDLauncher is available as a snap package for Ubuntu users. To install GDLauncher do:

<code>
sudo snap install gdlauncher --beta
</code>

Debian or Ubuntu users also have the option to instead download the deb package from [[https://github.com/gorilla-devs/GDLauncher/releases|GDLauncher GitHub]]

==== Fedora Linux ====

Fedora users can download the .rpm package from [[https://github.com/gorilla-devs/GDLauncher/releases|GDLauncher GitHub]].

Software Center:\\ 
Double click on the RPM file and it will be opened in the software center.
When it is opened in the software center, you will see the install option. Just click on it and enter your password when prompted for it.

Command line:
<code>
# yum localinstall path-to-rpm/gdlauncher.rpm
</code>

===== STEP 2: Setting Up Java =====

On your first launch of GDLauncher, you may be greeted with a prompt asking you to set up Java. If you are a beginner and are eager to jump directly into Minecraft, it is recommend that you click on "Automatic setup", as you can always change it down the road. If you would like to mess around with Java a bit, then pick "Manual setup". Using the latest version of Java for Fabric doesn't hurt, and may improve performance in certain scenarios.

{{:player:tutorials:install_gdlauncher:gdlauncher_java.png?600|}}

===== STEP 3: Signing in to Minecraft =====

In order to get started with setting up an instance for Minecraft, GDLauncher will ask you to login. Make sure to click on the "Sign in with Microsoft" button to login. You can then proceed to enter your Microsoft credentials and sign in. 

{{:player:tutorials:install_gdlauncher:gdlauncher_sign_in.png?600|}}

{{:player:tutorials:install_gdlauncher:gdlauncher-microsoft-sign-in.png?600|}}

===== STEP 4: Setting up an Instance =====

To set up an instance in GDLauncher, locate the "Create" button in the bottom-left.

{{:player:tutorials:install_gdlauncher:gdlauncher_no_instances.png?600|}}

GDLauncher will ask for a version.

{{:player:tutorials:install_gdlauncher:gdlauncher_creating_fabric_instance.png?600|}}

Select "Fabric", then select either "Releases" or "Snapshots", depending on what you want. It is recommended to download the latest version of Fabric Loader to avoid any bugs or compatibility issues. Finally, select the version of Fabric Loader you would like to install.

Enter a name for your instance and continue.

{{:player:tutorials:install_gdlauncher:gdlauncher_name_instance.png?200|}}

Your new Fabric instance should now be created.

{{:player:tutorials:install_gdlauncher:gdlauncher_installing_instance_progress.png?200|}}

===== STEP 5: Installing Mods & Fabric API =====

The Fabric API is the core library for the most common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.

As stated before, GDLauncher has integration with CurseForge, allowing you to search for and install mods to your instance directly through GDLauncher.

To install Fabric API from GDLauncher, find your instance, and right-click on it. A context menu should show up, and click "Manage".

{{:player:tutorials:install_gdlauncher:gdlauncher_instance_context_menu.png?600|}}

Inside of the "Instance Manager", navigate over to the "Mods" tab, and click "Add Mod".

{{:player:tutorials:install_gdlauncher:gdlauncher_manage_instance.png?600|}}

In the window that pops up, type in "Fabric API". Once you have found the Fabric API, hover over the mod and click "Install". If a mod is incompatible, GDLauncher will automatically filter that mod out of your search results. This also means that the latest compatible version of your mod will be automatically selected for the user.

{{:player:tutorials:install_gdlauncher:gdlauncher_adding_fapi.png?600|}}

The correct/latest version of Fabric API should now be installed.

Much of the same is said for installing mods with GDLauncher. If you would like to see the list of mods that you have currently installed, install the **Mod Menu (Fabric)** mod. In the same window, search for "Mod Menu", and install the **Mod Menu** mod.

{{:player:tutorials:install_gdlauncher:gdlauncher_mod_search_for_mod_menu.png?600|}}

These are some examples:

{{:player:tutorials:install_gdlauncher:gdlauncher_mod_search_for_sodium.png?400|}}

{{:player:tutorials:install_gdlauncher:gdlauncher_mod_search_for_rei.png?400|}}

{{:player:tutorials:install_gdlauncher:gdlauncher_mod_search_for_xaeros_minimap.png?400|}}

{{:player:tutorials:install_gdlauncher:gdlauncher_mod_search_for_enhancedcraft.png?400|}}

===== STEP 6: HAVE FUN! =====