前言
本篇文章是对Minecraft一些模组问题的解决指南，各位萌新请务必仔细阅读，如果你不愿意花费几分钟阅读该文章，隔壁网易版欢迎你。
我作为一个模组开发者，经常会被各位萌新问问题，但我不可能做到每个问题都能认真解答，很多时候我没有那么空闲，所以写了这篇文章来帮助大家解决一些常见的问题以及提问的方法。
模组下载
通常情况下，模组作者会将模组上传至CurseForge、Modrinth、Github等网站，部分模组作者可能会上传至网盘或其它网站，不过这里主要讲解CurseForge、Modrinth和Github的使用方法。
如何获取模组的下载地址
如果你是从B站，Youtube等视频网站了解到的模组，那么你通常可以在视频简介或置顶评论中找到下载地址。
如果你是从MCBBS，MCMOD等网站了解到的模组，那么你可以从页面上提供的链接获取到下载地址。
CurseForge
首先，你需要在模组页面中找到Files选项，如下图所示：
选择你需要的Minecraft版本，模组加载器（这个后面会讲），在下图的版本列表中选择最新版本即可：
在新弹出的页面中，你只需要点击Download并等待一会而后即可下载该模组。
Modrinth
同样的，你需要打开版本列表：
与CurseForge一样，选择你需要的Minecraft版本，模组加载器，并选择最新版本即可：
在新弹出的页面中，你只需要点击Download就可以直接下载该模组。
Github
Github与CurseForge和Modrinth相比有所不同，因为并非所有的作者都会上传编译好的jar文件，所以下载会稍微麻烦一点
注意：Github在国内访问体验可能较差
首先，你需要在模组页面中找到Releases选项，如下图所示：
然后直接下载jar文件即可：
模组安装
模组加载器
Minecraft目前有四个主流模组加载器，分别为Fabric，Quilt，Forge，NeoForge，在下载模组的时候一定要选择正确的模组加载器，否则模组将无法正常运行。
不同加载器能运行的模组不同，其中，NeoForge兼容小部分Forge模组，Quilt兼容大部分Fabric模组，Forge/NeoForge与Fabric/Quilt互不兼容。
注意：即使部分模组加载器之间的模组可以互相兼容，但这并不意味着完全兼容，在出现问题时请使用正确的加载器
安装方法
在作者没有额外声明的情况下，你只需要将模组放入游戏目录/mods文件夹即可。
前置模组
部分模组可能需要前置模组，请一并下载安装，通常情况下CurseForge和Modrinth会说明需要的前置模组（如下图）。
错误排查
通常情况下，很多问题是你自己导致的，与模组无关。
即使这些问题可能不是由于你导致的，但是你也应该尝试去解决该问题，这可以减少作者的工作量。
不要觉得排查错误会消耗你大量的时间，作者的时间比你更宝贵
启动报错
如果你在启动时遇到了类似下图的页面，只需按照指示去解决问题，看不懂英文可以使用翻译软件（如下图是缺少前置模组geckolib）：
在手机启动器启动时不会出现这个页面，但是会导致卡在加载界面，你需要自己去寻找错误原因
错误解决
这里是一些简单的问题解决方法，可以帮助你解决一些常见问题。
| 错误 | 解决方法 |
|---|---|
| 模组未被加载 | 请使用正确的模组加载器 |
| Minecraft版本不支持 | 请使用正确的Minecraft版本 |
| 缺少前置模组 | 请安装前置模组 |
| 模组需要前置模组的更高或更低版本 | 请升级或降低前置模组的版本 |
| 安装了不兼容的模组 | 请卸载不兼容的模组 |
小贴士
如果你安装了Optifine模组导致出现问题，建议你先删除Optifine。
如果你使用的是Fabric/Quilt，建议在使用之前检查是否已经安装或是否为最新版本的Fabric API/QSL。
报告问题
在提问之前，我推荐你先看看《提问的智慧》，它会详细告诉你该如何提问，这里我只做一个简单的解释。
报道问题之前应该做的
在报道问题之前，你需要先去做一些准备工作，最大可能地减少模组作者的工作量，以下是需要做的事情：
- 确定该问题没有被报道过
- 确定你已经看完模组的介绍，FAQ，文档&视频教程（如果有）
- 确定你已经尝试过去解决该问题
- 确定这个问题值得被报道
确定是否应该报告问题
通常情况下，你可以在Github上的issues页面报告和寻找问题，那么早报告问题之前，你需要先确定这个问题是否应该被报道，以下问题不应该被报道：
- 你使用了错误的模组加载器。
- 你使用了错误的Minecraft版本。
- 你使用了已经不受支持的模组版本。
- 你没有正确配置模组。
- 你安装了不兼容的模组。
如何报道问题
最好的办法是在Github上创建一个issue，然后在issue中描述问题。当然，你也可以在其它地方报道问题，不过Github是最有效的渠道之一。
注意：不推荐向作者私信或发送邮件，你的问题最好公开地解决，这样可以让更多的人参与讨论，同时可以帮助更多的人解决问题。
如何正确提问
首先，你需要一个清晰的标题，能够简单的描述问题，示例：
- 在1.20.1Fabric无法使用聊天
- 在1.20.4Forge无法加载渲染器
有了清晰的标题，还需要一个清晰的描述，描述问题的细节，至少要包含如下内容：
- 你使用的Minecraft版本，模组加载器版本和模组版本。
- 你遇到的问题的具体描述。
- 如何复现
- 日志文件
- 游戏内截图
正确示例
标题：模组在Fabric无法启用聊天修改
JDK版本：Openjdk17 ；系统：Ubuntu 22.04 ；Minecraft版本1.20.4 ；模组版本：0.3.3 ；加载器：Fabric
已安装的模组：geckolib 4.2.2，toneko 0.3.3，Fabric API 0.96.4，ctlib 0.1.0
问题描述：在游戏目录/ctlib/toneko/config.yml将chat.enable设置为true后导致游戏崩溃，重新设置为fasle即可解决。
崩溃日志：日志链接
错误示例
- 为什么模组会崩溃啊
- 模组在哪里下载啊
- 怎么安装模组啊
- 为什么模组安装上没用啊
- 为什么会卡在加载页面啊
- 这是怎么回事（启动器截图）
如何提供日志文件
日志文件对于排查错误来说非常重要，即使你不会看日志，但是模组的开发者需要通过它来排查问题。
“在没有错误日志的情况下诊断任何问题无异于闭眼开车”
\t —apache httpd 用户入门文档
你可以在游戏目录/logs/latest.log中找到最近一次的日志文件，这是你需要提供的文件。
注意：如果最近一次启动不是与该问题相关的，请不要提供这个文件，你需要在logs文件夹中找到与该问题相关的日志文件。
如何为模组提供建议
如果你对模组有好的建议，你可以通过Github的issues页面来提交。
提供建议之前应该做的
- 确定你的建议是合理的，不要重复建议。
- 确定你的建议可以被玩家和作者所接受。
- 确定你的建议不会导致模组使用困难或不稳定/兼容性下降等问题。
结尾
感谢你阅读了本教程，如果你有什么疑问或者认为我写的不完善的地方，可以在评论为我提供建议，非常感谢。