Differences

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

--- install [2018/12/09 08:57] – created asie
+++ install [2023/06/09 10:38] – Remove link to jenkins modmuss50
@@ Line 1: / Line 1: @@
 ====== Installing Fabric ======
-Note: An official way to install the client into the "vanilla" launcher is not yet available.
+===== Regular installation =====
-===== Client (MultiMC) =====
+==== Mojang's Minecraft Launcher====
-First, open [[http://fabric.asie.pl/use/|the download page]] and choose the game, mapping and loader versions.
+  - Download the Fabric installer from [[https://fabricmc.net/use/|the download page]].
-  * 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.
+  - Open the installer. In the window you need to configure the mapping and loader version (latest loader version is recommended) 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.
-  * The loader should be mostly game version-independent. If this situation changes, it will be pointed out, so don't worry!
+  - Press Install. A new game version and profile will be created in the launcher's menu, which you can now use to launch Fabric.
+  - You may then want to launch your newly created instance once, and then add [[https://modrinth.com/mod/fabric-api/versions|Fabric API]] to your instance's mods folder as most mods will need it
-Click "copy MultiMC instance url". This will copy an URL to the MultiMC template .zip to your clipboard.
+For more detailed instructions visit this guide: [[player:tutorials:install_mcl:windows|Install Fabric - Minecraft Launcher (Windows)]]
-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"!
+==== Alternative third party launchers ====
-{{::install_multimc_import.png|}}
+See [[start#installing_fabric_loader|Installing Fabric Loader]] and [[faq:user#what_launchers_can_i_use_to_play_with_fabric_mods_on_a_custom_home-assembled_modpack|FAQ]]
-Press OK. Your Fabric instance is ready to go - feel free to add mods to it!
+==== Server (simple method) ====
-===== Dedicated Server =====
+The new server installation uses a single jar file as a launcher. This launcher first downloads any missing Fabric Loader or Minecraft files, then continues with running the game server. There is no explicit installation and the desired versions as selected on the homepage are already baked into this jar file.
-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.
+  - Visit [[https://fabricmc.net/use/server/|the Minecraft Server download page]] and configure the desired versions, then use the ''Executable Server (.jar)'' button to generate and download the Fabric Server Launcher jar file
+  - Put the Fabric Server Launcher jar file into a directory of your choice, local or on a remote server
+  - Run the server with ''java -Xmx2G -jar <fabric server launcher jar file name> nogui'', the exact command is provided on the download website in step 1
-Click "download server launcher" or "copy server launcher .JAR url". Use this to download the server launcher.
+With Minecraft specific server hosts, admin panels or start scripts the Fabric Launcher jar file can be used as a drop-in replacement for a vanilla server jar. It can be invoked in the same way and behaves similarly.
+==== Server (manual method) ====
-Additionally, download the //vanilla// server .JAR for a given Minecraft version - these can generally be found on Mojang's version announcement blog posts.
+**Note:** **Minecraft 1.17** requires Java 16, **Minecraft 1.18** requires Java 17. This is not included in most distributions. You can check your version with ''%%java -version%%''. You may get Java 17 from 3rd parties like [[https://adoptium.net/|Adoptium]] or [[https://www.azul.com/downloads/|Azul Zulu]].
-Put both .JARs in the same directory. From the command line, run:
+**Note:** **Up-to-date as of Loader 0.4.4+.** Older versions choose different techniques. Installer 0.4.0+ required!
-''java -Xmx[RAM amount, for example 2G] -jar fabric-loader-[version].jar [minecraft server JAR] [arguments...]''
+  - Download the Fabric installer from [[https://fabricmc.net/use/?page=server|the Minecraft Server download page]] with the manual installation link below the download button or [[https://fabricmc.net/use/installer/|the Minecraft Launcher download page]] as if it was a client install.
+  - 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.
+  - When uploading to a remote host, make sure to include ''fabric-server-launcher.jar'', ''server.properties'', ''server.jar'' and the ''libraries'' folder with its contents
-This should let you run the server.
+For more detailed instructions visit:
+  * [[player:tutorials:server:windows|Installing a Fabric Server (Windows)]]
+  * [[player:tutorials:install_server|Installing a Fabric Server without a GUI]]
+===== CLI installation =====
+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.
+==== Available options ====
+  * **-snapshot** Enables the usage of snapshot versions of Minecraft.
+  * **-dir** Used to select the installation dir, defaults to the current working directory.
+  * **-mcversion** Used to select the minecraft version, defaults to the latest stable version.
+  * **-loader** Used to select the loader version, defaults to the latest.
+  * **-downloadMinecraft** Used to automatically download the Minecraft server jar
+  * **-noprofile** Skip creating client profile
+  * **-mavenurl** (advanced) Use a custom maven url when installing
+  * **-metaurl** (advanced) Use a custom meta server url
+==== Available commands ====
+  * **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
+</code>
+  * **server** Used to create the required files for a Fabric server. Accepts all options, none are required. Example: <code>
+java -jar fabric-installer.jar server
+</code>
+  * **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"
+</code>