====== 安装 Fabric ====== 

===== 常规安装 =====

//**译者注：**由于网络原因，推荐中国大陆地区玩家使用 PCL2、HMCL 和 BakaXL 三种启动器之一，以加速游戏下载和启动。//

==== 通过 PCL2、HMCL 和 BakaXL 启动器 ====

=== PCL2 (Plain Craft Launcher 2) ===

//**译者注：**在中国大陆，PCL2 启动器下载速度最快。//

**注：**官方正式版下载链接：[[https://afdian.net/p/0164034c016c11ebafcb52540025c377|爱发电]]。

  - 点击页面顶部的“下载”按钮；
  - 选择 Minecraft 版本；
  - 在“安装预览”对话框中，单击“Fabric”项，在下拉框中选择 Fabric 版本（推荐最新稳定版）；
  - 单击“Fabric API”项，在下拉框中选择 Fabric API 版本；
  - 点击右上角“开始安装”按钮。
      * 可能会出现“版本隔离提示”。
        * 如您只打算安装一个 Minecraft 版本，则可单击“继续”按钮；
        * 否则，您应单击“取消下载”按钮，前往页面顶部“设置”，在“启动选项”组中配置“版本隔离”选项。如您不确定，则可选择“隔离所有版本”。随后回到“下载”页面，单击“开始安装”按钮。
      * 下载应当随后开始。可点击右下角“下载”图标查看进度。
  - 下载成功后，点击页面顶部“启动”按钮，配置账户信息：
      * 如您有 Minecraft 正版账户，则可单击“微软”选项，并按指引添加您的微软账户；
      * 否则，单击“离线”选项，任意输入您的游戏用户名（注意不要为空且勿包含特殊字符）。
  - 单击窗口底部的“启动游戏”按钮即可。

=== HMCL (Hello Minecraft! Launcher) ===

**注：**官方下载链接：[[https://hmcl.huangyuhui.net/download/|HMCL 官网]]。

（教程待补充）

=== BakaXL ===

**注：**官方下载链接：[[https://www.bakaxl.com/|BakaXL 官网]]。

（教程待补充）

==== 通过 MultiMC 启动器 ====

**注：**MultiMC 是 Minecraft 的一种模组友好型启动器，建议配合 Fabric 使用，可以在[[https://multimc.org/|此处]]下载。

  - 创建一个新的游戏实例；
  - 右键实例或在窗口右侧，点击“编辑实例”。
  - 在“配置”窗口的“版本”选项卡上，单击“安装 Fabric”，在对话框中选择一个 Fabric 加载器版本，然后单击“确定”将其添加到实例中。
     * 通常建议使用最新的可用加载器版本。
     * 如果加载器与游戏版本冲突，启动器将提示您，因此请随意选择加载器版本！
  - 点击确定。您的 Fabric 实例已准备就绪，可随时添加模组！

有关更详细的说明，请访问以下指南：
  * 对于 Windows：[[zh_cn:player:tutorials:install_multimc:windows|使用 MultiMC（Windows）安装 Fabric]]；
  * 对于 macOS：[[zh_cn:player:tutorials:install_multimc:mac|使用 MultiMC（macOS）安装 Fabric]]。

==== 通过官方启动器 (Minecraft Launcher) ====

//**译者注：**在中国大陆，由于缓慢的下载速度，不建议使用官方启动器。//

  - 从[[https://fabricmc.net/use/|下载页面]]下载 Fabric 安装程序。
  - 打开安装程序。在窗口中，您需要配置映射和加载程序版本（根据 [[#multimc|MultiMC section]] 的建议）和安装位置（默认位置应在大多数平台上工作）。\\ **注意：**您需要启用快照功能，以使 Fabric 安装程序显示 Minecraft 快照的映射选项。
  - 点击安装。将在启动器的菜单中创建一个新的游戏版本和配置文件，您现在可以使用它来启动 Fabric。

有关更详细的说明，请访问本指南：[[zh_cn:player:tutorials:install_mcl:windows|使用 Minecraft 启动器（Windows）安装 Fabric]]。

==== 安装服务端（快速） ====

新版服务端安装使用单个 JAR 文件作为启动器。该启动器首先下载任何缺少的 Fabric 加载器或 Minecraft 文件，然后继续运行游戏服务端。没有安装界面，并且在首页上选择的所需版本已经附带在此 JAR 文件中。

  - 访问[[https://fabricmc.net/use/server/|服务端下载页]]并选择所需的版本，然后使用''可执行服务器（.jar）''按钮生成并下载 Fabric 服务端启动器 JAR 文件；
  - 将 Fabric 服务端启动器 JAR 文件放入任意目录，位于本地或远程服务器上；
  - 使用 ''java -Xmx2G -jar <Fabric 服务端启动器 JAR 文件名> nogui'' 命令运行服务器，准确命令在第一步的下载页面上提供。

使用 Minecraft 特定的服务器主机，管理面板或启动脚本，Fabric 启动器 JAR 文件可以替换原版服务端 JAR。它们可以以相同的方式调用，并且二者行为类似。

==== 安装服务端（手动） ====

**注意：Minecraft 1.17** 需要 Java 16，**Minecraft 1.18** 需要 Java 17。大多数下载中都不包含 Java。您可以使用 ''%%java -version%%'' 命令检查您的 Java 版本。您可从第三方获得 Java 17，例如 [[https://adoptium.net/|Adoptium]] 或 [[https://www.azul.com/downloads/|Azul Zulu]]。

**注意：最新 Fabric 加载器为 0.4.4 以上。** 旧版本使用不同的技术。安装程序需要 0.4.0 以上！

  - 从 [[https://fabricmc.net/use/?page=server|Minecraft 服务端下载页]]下载按钮下的手动安装链接下载 Fabric 安装程序，或从 [[https://fabricmc.net/use/installer/|针对官方启动器的 Fabric 下载页]]下载，就像安装客户端一样。
  - 打开安装程序。在窗口顶部点击“Server”选项卡。
  - 在窗口中配置映射、加载器版本以及安装位置。 \\ **注意：**您需要启用快照功能，以使 Fabric 安装程序显示 Minecraft 快照的映射选项。
  - 点击“Install”。在输出目录中，将创建 ''fabric-server-launch.jar''。它依赖原版服务端 JAR 文件 ''server.jar''，通常在 Mojang 的版本公告博客文章中找到。安装程序将在首次启动时生成属性文件，您可以在其中更改路径。\\ **注意：**如果您正在升级现有服务端，如果安装程序没有为您删除，请记得删除 ''.fabric'' 文件夹，否则您将遇到类加载（classloading）错误。
  - 上传到远程主机时，确保上传 ''fabric-server-launcher.jar''、''server.properties''、''server.jar'' 文件和 ''libraries'' 文件夹及其所有内容。

有关更详细的说明，请访问：
  * 对于 Windows：[[zh_cn:player:tutorials:server:windows|安装 Fabric 服务端]]
  * 对于 Linux：[[zh_cn:player:tutorials:install_server|无 GUI 安装 Fabric 服务端]]

===== 命令行安装 =====

Fabric 安装程序支持通过命令行安装客户端和服务端。这可以用来自动化安装。安装程序提供许多可用于静默安装的命令。

==== 可用命令行参数 ====

  * **-snapshot** 允许使用 Minecraft 快照版本。
  * **-dir** 用于选择安装目录。默认为当前工作目录。
  * **-mcversion** 用于选择 Minecraft 版本。默认为最新稳定版。
  * **-loader** 用于选择加载器版本，默认为最新版本。
  * **-downloadMinecraft** 用于自动下载 Minecraft 服务端 JAR。
  * **-noprofile** 跳过创建客户端配置文件。
  * **-mavenurl** （高级）安装时使用自定义 Maven URL。
  * **-metaurl** （高级）使用自定义 meta server URL。

==== 可用命令 ====

  * **help** 输出所有可用的命令以及最新的映射和加载程序版本。该命令忽略参数。例如：<code>
java -jar fabric-installer.jar help
</code>
  * **server** 用于为 Fabric 服务端创建所需的文件。接受所有参数，且所有参数可选。例如：<code>
java -jar fabric-installer.jar server
</code>
  * **client** 用于为 Fabric 客户端创建所需的文件。接受所有参数，**-dir** 参数必须提供。例如：<code>
java -jar fabric-installer.jar client -dir "~/Games/.minecraft"
</code>