本帖最后由 猜猜谁是谁 于 2023-4-1 12:32 编辑

▌前言说明

本帖提供 Minecraft: Java版 Mod 安装教程。这将是你开始游玩 Minecraft Mod 的第一步（尝试跳过）。

下面是一些注意事项：

• 本帖更新由 天明遥遥、Mod发布版版主 共同维护。「Mod Loader/基础 API」的转载更新由本帖统一管理。
• 在安装使用过程中出现任何问题，在 Mod问答版 将会更有效的解决，于本帖回复可能不会被回应。
• 本帖不适用于「网易国服」版本。其只能使用经网易许可的 Mod，论坛官方不提供任何与其相关的技术信息。
• 本帖仍有很多不完善的部分，或未能及时更新，请直接回帖或私信联系我们。
  

▌了解 Mod Loader/API

• Mod Loader/API 是什么？
  Mod Loader/API 是对 Mod Loader（加载器）及其附带的基础 API 的统称。
  简而言之，你只需要在原版游戏的基础上安装好它们，就可以随时选择加入你喜欢的 Mod 了，它可以看作是 Mod 的运行环境。
  但要注意，你安装的 Mod 必须是基于该 Mod Loader 与其 API 开发的，它们之间存在某些兼容或不兼容的关系，这在后面还会具体提到。
• Mod Loader/API → Mod 开发环境？
  这是相对的。Mod Loader/API，对于用户来说是运行环境，而对开发者来说，它们是开发环境。
  Mod Loader 和 API 基于 MCP 或 Yarn 这样的 对 Minecraft 源码的反编译反混淆项目 开发而成。
  其可以理解为一个规范开发、简化编程、协调冲突的平台。
  对 Minecraft 源码反编译反混淆的行为违反著作权法，不过，Mojang 妥协了这种行为。
  如果你有兴趣，可以查看它们的官网文档或到 编程开发版 查找资料，学习并尝试自己制作一个 Mod。
• Mod API 历史遗留的误解
  这个概念在过去通常被笼统的称为 安装 Mod API，因为 Mod Loader 通常与其附带的基础 API 一同发布（现在不完全是）。
  API 的概念是针对开发者而言的而并非用户，开发者利用 Mod API 制作各式趣味横生的 Mod，但用户并不直接使用它们。
• Mod Loader/API 是爱好者的产物
  Mod Loader/API 是爱好者制作发布而 非 Mojang 官方。
  因此早期的 Mod Loader/API 门类众多且在安装使用上较为复杂繁琐，经过近十年迭代发展，现代的情况是基本统一且易用的。
  

▌主要 Mod Loader/API 信息汇总

Forge
是 Minecraft 最通用和基础的「Mod Loader/API」之一，包含 Forge Mod Loader 和 Forge API。
创始人：LexManos
相关链接： 官网 论坛 开发文档 GitHub
许可声明：GUN LGPL 2.1 本帖可能的分流行为基于该协议

Liteloader
是一个轻量的「Mod Loader/API」。可以独立安装也可导出一个运行于 Forge Mod Loader 下的 API 文件。
创始人：Mumfrey
相关链接：官网 论坛 Jenkins GitHub
许可声明：见 该页面 permissions（许可证）部分，本帖可能的分流行为基于该声明

Fabric
是于 Minecraft 1.14 后正式发布的新兴「Mod Loader/API」，更新迅速，支持预览版本的 Minecraft。包含 Fabric Loader 和 Fabric API。
创始人：Asiekierka
相关链接：官网 论坛 Wiki GitHub 站内介绍 使用进阶
许可声明：Apache License 2.0 本帖可能的分流行为基于该协议

Quilt
是一个基于 Fabric 的「Mod Loader/API」，可同时加载 Fabric 和 Quilt 模组。包含 Quilt Loader 和 Quilt Standard Libraries。
该项目脱胎于 Fabric，采取社区自决的管理风格。
相关链接：官网 论坛 使用指南 Wiki GitHub 站内介绍
许可声明：Apache License 2.0 本帖可能的分流行为基于该协议



▌Mod Loader/API 下载

本节仅提供 Minecraft 1.7.10 及之后 每个0.1的最终版本 及 当前最新版本 的下载链接，其他版本如有需要请在各发布官网自行寻找或参照 旧帖

Forge 自动安装器 下载　 官方下载页：官网 简单说明： 「Installer / Installer-win」按钮（见下图）即是 Forge 的自动安装器。 点击下载得到的 JAR 和 EXE（1.13.2及以后官方不再提供 EXE ）的区别是封包格式不同，EXE 版本只能在 Windows 中运行；JAR 版本在 Windows 、OSX 和 Linux 中通用（需在系统中安装 Java）。 注意官方启动器搭建的 Java 环境仅用于运行游戏本身，如果你需要打开 JAR 版本的 Forge 安装器，则需另从 Java 官网 下载安装（关于 Java 的选用和下载，推荐阅读 此帖 整合包的使用 — 常见问题 — Java 版本选择和下载安装）。 「Installer」不仅可以安装于客户端，也可以安装于原版服务端，而「Universal」和「Launcher」 可能是针对其他服务端的（未验证）。其他的下载选项主要是针对开发者的。 带有「虫子符号」的版本，页面上未作解释，一般是最新版本，开发组或许意在通过强调该版本可能并不稳定，不过它通常并不影响玩家的使用。 带有「★」的版本，这是官方推荐的稳定版，虽说如此，很多 Mod 的最低 Forge 版本要求已经超过了稳定版。如确认最新版不可用，可以尝试回滚到某个近期版本。 各版本官方直链： Minecraft支持版本 最新版 ★稳定版 版本号 下载链接 版本号 下载链接 1.19.4 45.0.40 [JAR] / / 1.18.2 40.2.1 [JAR] 40.2.0 [JAR] 1.17.1 37.1.1 [JAR] 37.1.1 [JAR] 1.16.5 36.2.39 [JAR] 36.2.34 [JAR] 1.15.2 31.2.57 [JAR] 31.2.57 [JAR] 1.14.4 28.2.26 [JAR] 28.2.26 [JAR] 1.13.2 25.0.223 [JAR] / / 1.12.2 14.23.5.2860 [JAR] 14.23.5.2859 [JAR] 1.11.2 13.20.1.2588 [JAR] 13.20.1.2588 [JAR] 1.10.2 12.18.3.2511 [JAR] 12.18.3.2511 [JAR] 1.9.4 12.17.0.2317 [JAR] 12.17.0.2317 [JAR] 1.8.9 11.15.1.2318 [JAR] 11.15.1.2318 [JAR] 1.7.10 10.13.4.1614 [JAR] 10.13.4.1614 [JAR] 网盘分流页： https://pan.baidu.com/s/1T9iG4I6CDdIcMOJTdmfmAQ?pwd=r35f 过期网盘分流： [1.17.1-1.7.10] https://pan.baidu.com/s/1gxM-C3GJTUE9NjocdObH9Q 提取码：jva9 （网盘更新不一定及时，如您网络通畅，请尽量先尝试从官网下载，支持开发组）

Liteloader 自动安装器 下载　 官方下载页：官网 Jenkins 简单说明： 一些问题在上面 Forge 的部分已经说明了，大同小异不再赘述。Liteloader 和 Forge 不同的是，作者并没有给它启用单独的版本号，因此你在官网下载的版本就是最新版了，如果需要历史版本则需进入Jenkins，里面是按照时间排序的。 作者在每个版本下方用信号强度的符号形象的标示了该版本的稳定性，当然，这其实是没得选的。 Liteloader 也可安装于服务端，不过不是直接安装，而是提取出 API 在 Forge 下运行，不过 Liteloader 的 Mod 大多是客户端向。 各版本直链： Minecraft支持版本 稳定性 下载链接 1.12.2 良好 [EXE|JAR] 1.11.2 良好 [EXE|JAR] 1.10.2 优秀 [EXE|JAR] 1.9.4 优秀 [EXE|JAR] 1.8.9 一般 [EXE|JAR] 1.7.10 优秀 [EXE|JAR] 网盘分流页： https://pan.baidu.com/s/1cPmOEw5xrmhIX5Fz9wRgMQ?pwd=cqjp 过期网盘分流： 感谢 oatoat 提供的 备份下载

Fabric 自动安装器 / API 下载　 官方下载页： Fabric Loader 官网 Fabric API Curseforge 简单说明： Fabric 安装器的版本与 Fabric Loader 的版本无关，旧版本的 Fabric 安装器理论上也支持安装新版本的 Fabric Loader。 Fabric Loader 并不包含基础的 API，你需要从它提供的 Curseforge 页面上自行下载，安装方法与一般 Mod 相同，分离的原因应该是为了更新的灵活性。 官网下载页面介绍见下方截图，在此不再赘述。 Fabric 与 Forge、Liteloader 及 Quilt 不能同时安装。 安装器直链： 0.11.1 官方直链 [EXE|JAR] 支持 Minecraft 1.19.X ~ 1.14.X 及 1.14 起的大部分快照/预览版本，目前其紧跟原版更新节奏，请以安装器内支持版本为准 Fabric API：Curseforge 下载页 Minecraft支持版本 最新版 版本号 下载链接 1.19.4 0.76.0 [JAR] 1.18.2 0.76.0 [JAR] 1.17.1 0.46.1 [JAR] 1.16.5 0.42.0 [JAR] 1.15.2 0.28.5 [JAR] 1.14.4 0.28.5 [JAR] 网盘分流页： https://pan.baidu.com/s/1-UbrGV3lRqbA105gYk_olA?pwd=ax1r 过期网盘分流： [1.17.1-1.14.4] https://pan.baidu.com/s/1Ufi7yYF5x2KK1TncKM5OrA 提取码：czod （网盘更新不一定及时，如您网络通畅，请尽量先尝试从官网下载，支持开发组）

Quilt 自动安装器 / API 下载　 官方下载页： Quilt Loader 官网 Quilt Standard Libraries Modrinth 简单说明： Quilt 的安装方法与 Fabric 类似，你需要下载 Quilt 安装器来安装 Quilt Loader，需要注意的是官网的下载通道分为 Client（客户端）与 Server（服务端），请根据所需下载对应的 Quilt 安装器。（见下图） Quilt Loader 并不包含基础的 API，你需要通过 Modrinth 来下载其 API，即 Quilt Standard Libraries（QSL），其中捆绑了 Quilted Fabric API（QFAPI），这使得 Quilt 能兼容绝大多数 Fabric 模组。 有关 Quilt 的详细安装步骤，可见上文提到过的站内介绍。 安装器直链： 0.5.0 Cilent（客户端） [EXE|JAR]         Server（服务端）[JAR] Quilt Standard Libraries：Modrinth 下载页 Minecraft支持版本 最新版 版本号 下载链接 1.19.4 QFAPI 6.0.0-beta.2 & QSL 5.0.0-beta.1 [JAR] 1.18.2 QFAPI 1.0.0-beta.28 & QSL 1.1.0-beta.26 [JAR] 注：Quilt Loader 支持 Minecraft 1.19.X ~ 1.14.X 及 1.14 起的大部分快照/预览版本，但 Quilt Standard Libraries 目前只支持从 Minecraft 1.18.2 开始的正式版本。 网盘分流页： https://pan.baidu.com/s/1Pk9M2HS4h-AgsVXrWDX9OA?pwd=i3bd （网盘更新不一定及时，如您网络通畅，请尽量先尝试从官网下载，支持开发组）

▌Mod Loader/API 安装

自动安装器的使用是比较「傻瓜式」的一键化操作。界面逻辑设计上都差不多。以下注意事项：
1.版本选择：
Forge 和 liteloader 下载的哪个版本，安装的就是哪个版本；Fabric 和 Quilt 则是在安装器内选择要安装的版本，一般而言游戏版本选择你需要的，其他则选择最新的就可以了。
2.安装选项：
Install Client - 安装到客户端，Install Server - 安装到服务端，Extract - 提取（提取出的 liteloader jar 可以放在 Forge 下作为 Mod API 运行，但其他 Mod API 的提取选项并不同理）。
Quilt 安装器下载时分为客户端与服务端两个通道，但目前二者下载得到的文件都能用于安装客户端 / 服务端。
3.安装路径：
默认安装路径是原版游戏默认存放位置。如果非原版或修改了游戏文件路径，请把安装器中的文件路径定位到你要安装的「.minecraft」下。
4.启动原版：
安装前记得启动一次原版游戏，否则安装器都会有红字提示（如上图）。
5.安装过程中或安装后启动过程中可能需要联网下载一些文件，请保持网络通畅；如果无法下载，请尝试切换网络提供商（下载失败就多下几次，一般来说最后都能下完的，实在不行就去找个现成的整合包吧）；安装成功后可能会有提示安装成功 (Successful) 的字样。

官方安装说明（英文，供读者参考） ：
Forge（下拉见 How to install Forge: For Players 一节）
Liteloader（见正文 installation 一节）
Fabric（见 Regular client 一节）
Quilt

第三方启动器：
你也可以通过其內建的功能很方便的实现部分 Mod Loader/API 的一键下载安装，此处不再赘述。



▌Mod 安装

第一步 定位游戏文件夹「.minecraft」

官方默认位置：
在 Windows 系统下，按 Win+R 键，在弹出的「运行」窗口中输入 %appdata%，然后点击「确定」即可；各安装器的默认加载路径也是此位置，可以直接复制到文件管理器中定位；或在官方启动器中查看及修改该路径。
其他位置：
一般是你自行在网络上下载的游戏文件包，它通常和第三方启动器在同一级文件夹下。

第二步 将你下载的 Mod 文件移入「Mods」文件夹下

在安装了 Mod Loader/API 后，「.minecraft」下通常会自动生成一个「Mods」文件夹（如没有可以自行创建），将你下载的 Mod 文件移入该文件夹下即安装完成。
1.7 以后的版本其他形式各异的安装方式已经基本绝迹了，1.7 以前的版本可以参考 旧帖 Mod 图文安装教程 部分的介绍。
注意：
    新旧版本的 Mod 不能同时安装。
    不同 Minecraft 版本的 Mod 不能同时安装。
    部分 Mod 需要前置 Mod 文件，请一并放入 Mods 文件夹下（Forge 通常会在启动游戏时提示你缺少什么文件）。
    安装的 Mod 过多可能造成严重的性能下降或游戏崩溃。



▌多版本并存

这里的「多版本并存」指的是不同版本的 Minecraft，不同版本的 Mod Loader/API 及 它们的 Mods，同时安装在一个游戏目录下。
部分第三方启动器支持版本隔离（略微改变了游戏主体文件结构），官方启动器则可以给不同的版本设置不同的存储路径。
个人比较习惯一个整合包一个 .minecraft 文件夹，一目了然，容易打包备份和分享给朋友。
如果你不熟悉 Minecraft 的 文件结构 或打算制作整合包，建议尽量各版本单独分开存放，以免造成误删和备份打包的麻烦。



▌后记 更新日志

本帖的编写参考了：
http://www.mcbbs.net/thread-63718-1-1.html
http://www.mcbbs.net/thread-5431-1-1.html
以及部分 Mod Loader/API 官方资料，上面信息汇总处已经列明，此处不再重复。
感谢诸位开发者的优秀创作以及传播者们的热情！
特别感谢梨木对我完成本帖的帮助！

hmcl 的自动安装以及半瘫痪了

终于有一个新的教程替代旧教程了，感动。
我在MCMOD百科写了两个教程，还有一些大佬帮忙维护，
楼主看看能不能从这两个里面提取一些精华加进你的教程中？
https://www.mcmod.cn/post/336.html
https://www.mcmod.cn/post/337.html

我一直用旧版本的，除了老是加载不出来以外还是勉强能用（雾）
启动器毕竟第三方的，各家应该都有自己的使用介绍，所以我这就不提啦

感谢帮助

可以问一下为什么安装以后打不开1.14的forge版本吗？安装以后点击打开显示无法启动游戏

建议到问答版发帖求助，把问题描述清楚。

我使用原版启动器正常安装是可以启动的。不排除你的启动器可能不支持高版本的mc，可以换一个试试。

感谢感谢

谢谢大佬，新手上道

很详细的教程。

怎么同时使用光影和mod？我按网上教程安装了forge和optifine，结果在官方启动器里是分开的，只能选择一个版本用......

为什么我forge进度条满之后就按出来一个一大堆英文的对话框然后就安装失败了

神乎其技.不服不行

错误: 找不到或无法加载主类 net.fabricmc.loader.launch.knot.KnotClient？？？？？？？

终于明白这三玩意是什么意思了

这个可以用来搭建服务器吗？

手机呢，mod是压缩包怎么办

开箱子蹦端怎么回事？

我終於有救了！

这个好啊，你可算帮了我大忙

感谢帮助

谢谢大佬！！！！

还有别人不会么？？？？？

你知道云吗？

为什么我的MOD加显示加了但没有

感谢楼主，新人知道怎么下mod了

有点蒙，不过总算可以装mod了、

opftine安装程序里是有一个E开头的按钮，点一下，安装到forge的mods里即可

了解了 多谢大佬

感谢版主

感谢版主的帮助，终于会安装mod了

安装到最后弹出来一堆英文，然后失败了？？？？

怎末回事啊？？？？

楼主延时摄影mod有吗

这个文件夹在哪啊

我也一样

谢谢大佬

超级棒的教程

作者，还差一个rift

你好，那个安装到最后跳出来安装失败，重试都会有什么原因

谢谢，版主。教程很棒

MC快乐每一天啦啦啦啦

本帖最后由 盐水先生 于 2019-7-11 19:52 编辑

为什么我1.12.2用了2768版本的forge就一直崩溃打不开游戏，它给我蹦出来“The game crashed whilst initializing game  Error:java.lang.NoClassDefFoundError   net/minecraft/util/IChatComponent”

用什么打开啊，为什么我下的格式打不开

学到了，感谢

同问啊我也是这个情况

感谢帮忙

感谢，一脸懵逼的我好不容易才搞定

感谢感谢         

好评好评