Differences

This shows you the differences between two versions of the page.

--- install [2019/03/29 18:56] – explanation on adding mods, as requested by user draylar
+++ install [2019/05/22 11:19] – [MultiMC] falseresync
@@ Line 1: / Line 1: @@
 ====== Installing Fabric ======
-===== Client (MultiMC; recommended) =====
+===== Regular installation =====
-First, open [[http://fabric.asie.pl/use/|the download page]] and choose the game, mapping and loader versions.
+==== MultiMC ====
-  * Generally, choosing the latest mapping version for a given game version is advisable, as mods do not depend on the deobfuscated names staying the same.
-  * The loader should be mostly game version-independent. If this situation changes, it will be pointed out, so don't worry!
-Click "copy MultiMC instance url". This will copy an URL to the MultiMC template .zip to your clipboard.
+**NOTE** MultiMC is a modding-friendly alternate launcher for Minecraft, which is recommended for working with Fabric and can be found here. If you don't wish to use MultiMC or don't know or care what launcher you're using, follow through to the [[#regular_client|regular client]] instructions.
-Start MultiMC. Click on "Add Instance" in the top-left, then select "Import from ZIP" and paste the URL in the text field. Don't forget to set an instance name, otherwise it will use the default "multimc"!
+  - Open [[https://fabricmc.net/use/|the download page]] and choose the game, mapping and loader versions. Click “Copy MultiMC instance url”.
+    * Generally, choosing the latest mapping version for a given game version is advisable, as mods do not depend on the deobfuscated names staying the same.
+    * The loader should be mostly game version-independent. If this situation changes, it will be pointed out, so don't worry!
+  - Start MultiMC. Click on “Add Instance” in the top-left, then select “Import from ZIP” and paste the URL in the text field. Don't forget to set the name!
+  - Press OK. Your Fabric instance is ready to go - feel free to add mods to it!
-{{::install_multimc_import.png|}}
+For more detailed instructions visit this guide: [[tutorial:install_with_multimc|Installing Fabric using the MultiMC launcher]]
+==== Regular client ====
-Press OK. Your Fabric instance is ready to go - feel free to add mods to it!
+  - Download the Fabric installer from [[https://fabricmc.net/use/|the download page]].
+    * You can download the installer directly from [[https://jenkins.modmuss50.me/job/FabricMC/job/fabric-installer/job/master/|modmuss50's Jenkins]] as well.
+  - Open the installer. In the window you need to configure the mapping and loader version (as per advice in the [[#multimc|MultiMC section]]) and the install location (the default should be fine on most platforms).\\ **NOTE** You need to enable snapshots in order to make the installer show mapping options for Minecraft snapshots.
+  - Press Install. A new game version and profile will be created in the launcher's menu, which you can now use to launch Fabric.
-===== Client ("Vanilla" Launcher) =====
+==== Server ====
-First, download the Fabric installer from [[http://fabric.asie.pl/use/|the download page]].
+**NOTE** **Up-to-date as of Loader 0.4.4+.** Older versions choose different techniques. Installer 0.4.0+ required!
-After opening it, a window will appear. Configure:
+  - Download the Fabric installer from [[https://fabricmc.net/use/|the download page]].
+    * You can download the installer directly from [[https://jenkins.modmuss50.me/job/FabricMC/job/fabric-installer/job/master/|modmuss50's Jenkins]] as well.
+  - Open the installer. Select the "Server" tab at the top of the window.
+  - In the window you need to configure the mapping and loader version and the install location.\\ **NOTE** You need to enable snapshots in order to make the installer show mapping options for Minecraft snapshots.
+  - Press Install. In the output directory, a ''fabric-server-launch.jar'' will be created. It expects a ''server.jar'', which is the vanilla server JAR, generally found on Mojang's version announcement blog posts, next to it, but will also generate a properties file on first launch where you can change the path.\\ **NOTE** If you are upgrading your existing server, remember to remove the ''.fabric'' folder if the installer did not remove that for you! Or you will get classloading errors.
-  * the mapping and loader version (as per advice in the MultiMC section);
+===== CLI installation =====
-  * the install location (the default should be fine on most platforms).
-Press Install. A new game version and profile will be created in the vanilla launcher's menu, which you can now use to launch Fabric.
+The fabric installer has full support from installing the client and the server from the command line. This could be used to automate the installation. The installer has a number of commands that can be used for a headless install.
-===== Dedicated Server =====
+==== Available options ====
-Go to [[http://fabric.asie.pl/use/|the download page]] and choose the desired loader version - the game/mapping version is chosen later, so don't worry about it.
+  * **-snapshot** Enables the usage of snapshot versions of Minecraft.
+  * **-dir** Used to select the installation dir, defaults to the current working directory.
+  * **-mappings** Used to select the mappings version, defaults to the latest.
+  * **-loader** Used to select the loader version, defaults to the latest.
-Click "download server launcher" or "copy server launcher .JAR url". Use this to download the server launcher.
+==== Available commands ====
-Additionally, download the //vanilla// server .JAR for a given Minecraft version - these can generally be found on Mojang's version announcement blog posts.
+  * **help** Prints out all of the commands available along with the latest mappings and loader versions. Ignores options. Example:<code>
+java -jar fabric-installer.jar help
-Put both .JARs in the same directory. From the command line, run:
+</code>
+  * **server** Used to create the required files for a Fabric server. Accepts all options, none are required. Example: <code>
-''java -Xmx[RAM amount, for example 2G] -jar fabric-loader-[version].jar [minecraft server JAR] [arguments...]''
+java -jar fabric-installer.jar server
+</code>
-This should let you run the server.
+  * **client** Used to create the required files for a Fabric client. Accepts all options, **-dir** is required. Example:<code>
+java -jar fabric-installer.jar client -dir “~/Games/.minecraft”
-If you don't want to (or can't) provide the Minecraft server .JAR as an argument, it's optional - however, the JAR must then be named "server.jar".
+</code>
-===== Adding Mods =====
-To add a mod to your Fabric client, navigate to the mods folder inside your Minecraft directory. If it does not exist, create it now. Download the jar of the mod you want, and drop it into this folder. Most mods will require Fabric API; you can place the jar for the API in /mods as well.
-For a list of Fabric mods, you can [[https://minecraft.curseforge.com/mc-mods/fabric?filter-sort=4|go to Minecraft CurseForge and set the filter type to Fabric]].