简介这份资源是面向 Minecraft 模组开发者的 Forge 1.20.1 模组开发工具包MDK适合具备一定 Java 与 Gradle 基础、希望上手或迁移到 1.20.1 版本的开发者使用可解决从零搭建模组工程、配置构建环境与了解版本变更的问题。压缩包共 17 个文件约 111KB以 gradle 构建脚本、properties 配置、java 示例源码、txt 说明文档为主另含 jar 与 mcmeta 等资源文件覆盖工程构建、依赖声明、版本变更记录与许可致谢等环节目录结构贴近官方 MDK 规范。已有 1513 人学习下载。借助其中的构建脚本与配置样例读者可快速跑通编译、打包与测试流程并通过变更日志了解 47.4.2 版本相较旧版的改动为模组适配与二次开发提供清晰起点。1. 从零认识 Minecraft Forge它到底是什么为什么新手都在装刚接触 Minecraft 模组的新人十有八九会卡在同一个地方想装个模组结果下载页面上写着「需要 Forge」点进去一看全是版本号、安装器、mods 文件夹瞬间就懵了。其实你可以把 Forge 理解成给游戏装的一个「插座转换器」——游戏本体原本只认自己的原版内容而 Forge 在游戏启动时先插进去一层把模组需要的接口、事件、注册机制都提前准备好模组才有地方「插电」。没有它绝大多数模组根本加载不起来。这份 forge-1.20.1 资源对应的就是 Minecraft 1.20.1 这个版本的 Forge 环境。1.20.1 是模组生态里非常热闹的一个版本大量整合包和模组都围绕它开发所以新手从这一版入手能找到的教程、能参考的模组都最多。它解决的核心问题就一个让你的 1.20.1 游戏能识别并运行第三方模组。适合谁适合刚买游戏、想玩整合包、想给自己加几个便利模组但完全没碰过 Java、没碰过命令行、看到文件夹就头大的零基础玩家。你不需要会写代码先把它装明白、跑起来就是成功的第一步。2. 为什么值得先学 Forge它决定了你后面能玩到什么2.1 模组世界的「地基」逻辑先弄懂再动手很多人以为装模组就是「下载一个文件丢进去」结果丢进去游戏没反应或者直接崩溃。原因在于 Minecraft 原版启动器只加载官方内容它不认识.jar格式的模组文件。Forge 做的事情是在启动流程里加了一个「模组加载器」游戏启动时Forge 先扫描mods文件夹读取每个模组声明的依赖、版本、入口类然后按顺序把它们挂到游戏的生命周期上。你可以把它想成一场演出原版游戏是舞台Forge 是舞台监督模组是各个节目监督负责确认每个节目什么时候上场、需要什么道具、会不会和别的节目撞车。所以新手最先要建立的认知是Forge 版本、游戏版本、模组版本三者必须对得上。1.20.1 的 Forge 只能配 1.20.1 的游戏模组页面也会写明它支持哪个 Forge 版本区间。对不上轻则模组不加载重则游戏启动直接黑屏报错。这个「版本对齐」的意识比记住任何操作步骤都重要因为后面你每加一个模组都要过这一关。2.2 为什么选 1.20.1 这个版本入门版本选择是新手第一个容易纠结的点。Minecraft 版本更新很快但模组生态的跟进往往滞后。1.20.1 之所以成为模组圈的「常青版本」是因为它稳定、API 成熟大量整合包作者和模组开发者都把它当作主力目标。你在这个版本上遇到问题时搜到的解决方案最多社区里讨论的人也最多。反过来如果你一上来就选最新版本很可能发现想玩的模组还没适配或者教程全是旧版本的照着做处处对不上。入门阶段「能跑通」比「用最新」重要得多。选一个资料最全的版本把整套流程走一遍建立信心和手感之后换版本只是重复同样的动作。我第一次学的时候就是贪新结果卡在一个没人讨论的小版本上折腾了一晚上才发现是模组根本没适配血泪经验就是先跟着大部队走。2.3 装好 Forge 之后你实际获得了什么装完 Forge你的游戏目录里会多出一个mods文件夹启动器里会多出一个叫forge-1.20.1的启动配置。这两个东西就是后续所有操作的入口。mods文件夹是模组的「投放口」你把模组.jar文件放进去Forge 启动时就会读取启动配置则是「带 Forge 的游戏」你以后玩模组都从这个配置进而不是原版配置。更实际的价值在于一旦这套环境跑通你就能玩整合包了。整合包本质上就是「一堆模组 一份配置 一个启动器配置」的打包它依赖的正是 Forge 这套加载机制。很多新手想玩的大型整合包安装器第一步就是帮你装 Forge。你自己先手动装一遍等于把整合包安装器背后做的事看明白了以后出问题也知道去哪找原因而不是对着一个「安装失败」的弹窗干瞪眼。3. 第一步怎么迈从下载到进入游戏的完整走一遍3.1 动手前的准备清单正式操作前先把三样东西确认好能省掉后面一大半的翻车。第一确认你的游戏是Java 版并且是1.20.1这个具体版本基岩版不适用这套流程。第二确认你电脑上装了 Java 运行环境1.20.1 需要 Java 17版本不对启动器会直接提示。第三找到你的游戏根目录也就是.minecraft文件夹所在位置后面所有文件都往这里放。找.minecraft的方法打开官方启动器进入「安装」或「配置」页面通常能看到游戏目录的路径或者直接在系统里搜索.minecraft。这个文件夹里你会看到versions、saves、logs等子文件夹logs很重要后面排查问题全靠它。准备工作不涉及任何代码就是把「版本、Java、目录」这三件事确认清楚心里有底再往下走。3.2 安装 Forge 的每一步跟着做就行假设你已经拿到了 forge-1.20.1 对应的安装器文件通常是一个.jar结尾的安装程序操作顺序如下。第一步双击安装器如果双击没反应说明系统没有把.jar关联到 Java这时用命令行方式启动更稳# 进入安装器所在目录后执行把文件名替换成你实际下载的安装器名字 java -jar forge-1.20.1-installer.jar这条命令的意思是「用 Java 运行这个安装程序」。java是调用 Java 运行环境-jar表示后面跟的是一个可执行 jar 包。执行后如果弹出安装窗口说明环境没问题如果报「找不到 java 命令」就是 Java 没装好或没配到系统路径先解决这个再继续。第二步安装窗口里选择Install client安装客户端安装路径一般会自动识别到你的.minecraft目录。如果没识别到手动点浏览选到.minecraft文件夹。第三步点确定等进度条走完出现「successfully installed」之类的提示就算完成。整个过程不需要你改任何配置安装器会自动把 Forge 的文件放进versions目录并在启动器里注册好配置。提示安装器只装客户端就够了服务端安装是给开服用的新手玩单机或进别人服务器都不需要。3.3 启动游戏并验证 Forge 是否生效安装完成后打开官方启动器在版本选择里应该能看到一个带 Forge 字样的配置选中它点启动。游戏加载时主界面左下角或模组列表里会出现 Forge 的标识这就说明加载器生效了。更直接的验证方式是看游戏目录mods文件夹应该已经自动生成里面可能有一个默认的模组文件。如果启动后主界面没有任何 Forge 痕迹先别急着重装去logs文件夹打开最新的日志文件搜索forge关键字看它有没有被加载。日志是排查问题的黑匣子养成看日志的习惯比到处问人快得多。验证这一步的意义在于确认「游戏 Forge」这条链路是通的之后往mods里放模组才有意义。链路没通就放模组等于往没通电的插座上插电器。3.4 放进第一个模组跑通完整闭环环境验证通过后做一次完整的「加模组」练习把闭环走完。第一步找一个明确标注支持 1.20.1 和对应 Forge 版本的模组下载它的.jar文件。第二步把这个.jar文件复制到.minecraft/mods文件夹里注意是放文件本身不要解压。第三步重新启动带 Forge 的配置进入游戏后打开模组列表确认新模组出现在列表里。.minecraft/ ├── mods/ - 模组 .jar 放这里 │ └── 你的模组.jar ├── versions/ - Forge 安装后生成 ├── logs/ - 出问题先看这里 └── saves/ - 存档上面这个目录结构不用背但要知道mods和logs的位置。放好模组后如果游戏崩溃第一时间去logs里找Caused by后面的内容那通常就是真正的原因。跑通这一次你就完成了从「装 Forge」到「用 Forge」的完整闭环后面加更多模组只是重复这个动作区别只在于要留意模组之间的依赖和冲突。4. 新手避坑这几个坑我几乎每次都见人踩4.1 版本对不上游戏直接崩现象启动游戏后黑屏、闪退或者日志里出现Missing or unsupported之类的报错。原因模组要求的游戏版本或 Forge 版本和你装的不一致最常见的是把 1.20.1 的模组放进别的版本或者模组要求更高版本的 Forge。解决回到模组下载页逐字核对它标注的 Minecraft 版本和 Forge 版本区间对不上就换对应版本不要抱着「试试看」的心态硬塞。4.2 模组放错位置或解压了现象模组文件明明放进去了游戏里却完全看不到。原因要么放进了.minecraft根目录而不是mods文件夹要么把.jar解压成了文件夹再放进去。解决确认路径是.minecraft/mods/xxx.jar文件保持.jar原样不要解压。解压后的文件夹 Forge 是不认的这是新手最高频的翻车点之一。4.3 Java 版本不对安装器都打不开现象双击安装器没反应或者命令行报UnsupportedClassVersionError。原因系统里的 Java 版本太旧1.20.1 需要 Java 17旧版本跑不起来。解决装一个 Java 17 运行环境命令行里用java -version确认版本号。如果电脑上有多个 Java注意启动器用的是哪一个必要时在启动器设置里指定 Java 路径。4.4 模组之间打架加一个崩一个现象单独装某个模组没事几个一起装就崩溃。原因两个模组修改了同一块游戏内容或者依赖的前置模组缺失、版本不匹配。解决一次只加一个模组加完启动验证出问题就能定位到刚加的那个看日志里Caused by指向哪个模组再去查它的前置依赖有没有装齐。别一次性丢十几个模组进去那样出了问题根本不知道是谁的锅。4.5 内存不够加载到一半卡死现象游戏启动到加载界面卡住或者进游戏后频繁卡顿、崩溃。原因模组多了以后内存占用上升启动器默认分配的内存不够。解决在启动器的配置里调大内存分配比如把-Xmx2G改成-Xmx4G具体数值看电脑内存量力而行。改完再启动观察是否还卡在同一个位置。5. 下一步学什么从会装到会用的进阶路线环境跑通、第一个模组加载成功之后你其实已经跨过了最难的门槛。接下来怎么走取决于你想玩到什么程度。我把路线分成三层你可以按自己的兴趣挑不用全走。第一层是玩整合包。这是最省心的进阶方式整合包作者已经把模组搭配、配置、内存参数都调好了你只需要用整合包启动器导入就能体验几十上百个模组协同工作的效果。入门建议先挑一个轻量整合包模组数量在几十个左右跑顺了再上大型包。这一层能让你快速见识模组生态的丰富度也能帮你发现自己喜欢哪类模组。第二层是自己配模组组合。当你对某几类模组有偏好后就可以脱离整合包自己在mods文件夹里搭一套。这时候要开始留意三件事前置依赖很多模组需要先装另一个模组才能运行、版本区间、以及模组之间的功能重叠。建议维护一个简单的清单记录每个模组的名字、版本、依赖出问题时对照排查。下面是一个清单示例用表格记就行模组名版本前置依赖备注模组A1.20.1-1.0无基础功能模组B1.20.1-2.3模组A依赖A的接口第三层是看日志、读报错。这一层不涉及写代码但决定了你遇到问题时能不能自己解决。核心习惯只有一个游戏一崩先开logs/latest.log从下往上找Caused by那行往往直接点名是哪个模组、缺什么、版本冲突在哪。看懂报错比记住一百个教程步骤都管用因为每个整合包、每台电脑的情况都不一样能读日志的人才能自己走出来。如果你以后想往开发方向走那才需要接触 Java 和模组开发框架但那是很远的事现阶段完全不用碰。入门阶段的目标很明确把环境装稳、把模组加对、把日志看懂。这三件事做到你就已经比大多数新手走得远了。从那以后我每次装新模组都强制自己「一次只加一个、加完必启动验证、崩了先看日志」这三步走一遍再也没出现过一崩崩一片、完全不知道从哪查的情况。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/31 15:23:27 · 阅读 1.2k Minecraft Forge 1.20.1 模组安装指南：从零基础到精通
简介这份资源是面向 Minecraft 模组开发者的 Forge 1.20.1 模组开发工具包MDK适合具备一定 Java 与 Gradle 基础、希望上手或迁移到 1.20.1 版本的开发者使用可解决从零搭建模组工程、配置构建环境与了解版本变更的问题。压缩包共 17 个文件约 111KB以 gradle 构建脚本、properties 配置、java 示例源码、txt 说明文档为主另含 jar 与 mcmeta 等资源文件覆盖工程构建、依赖声明、版本变更记录与许可致谢等环节目录结构贴近官方 MDK 规范。已有 1513 人学习下载。借助其中的构建脚本与配置样例读者可快速跑通编译、打包与测试流程并通过变更日志了解 47.4.2 版本相较旧版的改动为模组适配与二次开发提供清晰起点。1. 从零认识 Minecraft Forge它到底是什么为什么新手都在装刚接触 Minecraft 模组的新人十有八九会卡在同一个地方想装个模组结果下载页面上写着「需要 Forge」点进去一看全是版本号、安装器、mods 文件夹瞬间就懵了。其实你可以把 Forge 理解成给游戏装的一个「插座转换器」——游戏本体原本只认自己的原版内容而 Forge 在游戏启动时先插进去一层把模组需要的接口、事件、注册机制都提前准备好模组才有地方「插电」。没有它绝大多数模组根本加载不起来。这份 forge-1.20.1 资源对应的就是 Minecraft 1.20.1 这个版本的 Forge 环境。1.20.1 是模组生态里非常热闹的一个版本大量整合包和模组都围绕它开发所以新手从这一版入手能找到的教程、能参考的模组都最多。它解决的核心问题就一个让你的 1.20.1 游戏能识别并运行第三方模组。适合谁适合刚买游戏、想玩整合包、想给自己加几个便利模组但完全没碰过 Java、没碰过命令行、看到文件夹就头大的零基础玩家。你不需要会写代码先把它装明白、跑起来就是成功的第一步。2. 为什么值得先学 Forge它决定了你后面能玩到什么2.1 模组世界的「地基」逻辑先弄懂再动手很多人以为装模组就是「下载一个文件丢进去」结果丢进去游戏没反应或者直接崩溃。原因在于 Minecraft 原版启动器只加载官方内容它不认识.jar格式的模组文件。Forge 做的事情是在启动流程里加了一个「模组加载器」游戏启动时Forge 先扫描mods文件夹读取每个模组声明的依赖、版本、入口类然后按顺序把它们挂到游戏的生命周期上。你可以把它想成一场演出原版游戏是舞台Forge 是舞台监督模组是各个节目监督负责确认每个节目什么时候上场、需要什么道具、会不会和别的节目撞车。所以新手最先要建立的认知是Forge 版本、游戏版本、模组版本三者必须对得上。1.20.1 的 Forge 只能配 1.20.1 的游戏模组页面也会写明它支持哪个 Forge 版本区间。对不上轻则模组不加载重则游戏启动直接黑屏报错。这个「版本对齐」的意识比记住任何操作步骤都重要因为后面你每加一个模组都要过这一关。2.2 为什么选 1.20.1 这个版本入门版本选择是新手第一个容易纠结的点。Minecraft 版本更新很快但模组生态的跟进往往滞后。1.20.1 之所以成为模组圈的「常青版本」是因为它稳定、API 成熟大量整合包作者和模组开发者都把它当作主力目标。你在这个版本上遇到问题时搜到的解决方案最多社区里讨论的人也最多。反过来如果你一上来就选最新版本很可能发现想玩的模组还没适配或者教程全是旧版本的照着做处处对不上。入门阶段「能跑通」比「用最新」重要得多。选一个资料最全的版本把整套流程走一遍建立信心和手感之后换版本只是重复同样的动作。我第一次学的时候就是贪新结果卡在一个没人讨论的小版本上折腾了一晚上才发现是模组根本没适配血泪经验就是先跟着大部队走。2.3 装好 Forge 之后你实际获得了什么装完 Forge你的游戏目录里会多出一个mods文件夹启动器里会多出一个叫forge-1.20.1的启动配置。这两个东西就是后续所有操作的入口。mods文件夹是模组的「投放口」你把模组.jar文件放进去Forge 启动时就会读取启动配置则是「带 Forge 的游戏」你以后玩模组都从这个配置进而不是原版配置。更实际的价值在于一旦这套环境跑通你就能玩整合包了。整合包本质上就是「一堆模组 一份配置 一个启动器配置」的打包它依赖的正是 Forge 这套加载机制。很多新手想玩的大型整合包安装器第一步就是帮你装 Forge。你自己先手动装一遍等于把整合包安装器背后做的事看明白了以后出问题也知道去哪找原因而不是对着一个「安装失败」的弹窗干瞪眼。3. 第一步怎么迈从下载到进入游戏的完整走一遍3.1 动手前的准备清单正式操作前先把三样东西确认好能省掉后面一大半的翻车。第一确认你的游戏是Java 版并且是1.20.1这个具体版本基岩版不适用这套流程。第二确认你电脑上装了 Java 运行环境1.20.1 需要 Java 17版本不对启动器会直接提示。第三找到你的游戏根目录也就是.minecraft文件夹所在位置后面所有文件都往这里放。找.minecraft的方法打开官方启动器进入「安装」或「配置」页面通常能看到游戏目录的路径或者直接在系统里搜索.minecraft。这个文件夹里你会看到versions、saves、logs等子文件夹logs很重要后面排查问题全靠它。准备工作不涉及任何代码就是把「版本、Java、目录」这三件事确认清楚心里有底再往下走。3.2 安装 Forge 的每一步跟着做就行假设你已经拿到了 forge-1.20.1 对应的安装器文件通常是一个.jar结尾的安装程序操作顺序如下。第一步双击安装器如果双击没反应说明系统没有把.jar关联到 Java这时用命令行方式启动更稳# 进入安装器所在目录后执行把文件名替换成你实际下载的安装器名字 java -jar forge-1.20.1-installer.jar这条命令的意思是「用 Java 运行这个安装程序」。java是调用 Java 运行环境-jar表示后面跟的是一个可执行 jar 包。执行后如果弹出安装窗口说明环境没问题如果报「找不到 java 命令」就是 Java 没装好或没配到系统路径先解决这个再继续。第二步安装窗口里选择Install client安装客户端安装路径一般会自动识别到你的.minecraft目录。如果没识别到手动点浏览选到.minecraft文件夹。第三步点确定等进度条走完出现「successfully installed」之类的提示就算完成。整个过程不需要你改任何配置安装器会自动把 Forge 的文件放进versions目录并在启动器里注册好配置。提示安装器只装客户端就够了服务端安装是给开服用的新手玩单机或进别人服务器都不需要。3.3 启动游戏并验证 Forge 是否生效安装完成后打开官方启动器在版本选择里应该能看到一个带 Forge 字样的配置选中它点启动。游戏加载时主界面左下角或模组列表里会出现 Forge 的标识这就说明加载器生效了。更直接的验证方式是看游戏目录mods文件夹应该已经自动生成里面可能有一个默认的模组文件。如果启动后主界面没有任何 Forge 痕迹先别急着重装去logs文件夹打开最新的日志文件搜索forge关键字看它有没有被加载。日志是排查问题的黑匣子养成看日志的习惯比到处问人快得多。验证这一步的意义在于确认「游戏 Forge」这条链路是通的之后往mods里放模组才有意义。链路没通就放模组等于往没通电的插座上插电器。3.4 放进第一个模组跑通完整闭环环境验证通过后做一次完整的「加模组」练习把闭环走完。第一步找一个明确标注支持 1.20.1 和对应 Forge 版本的模组下载它的.jar文件。第二步把这个.jar文件复制到.minecraft/mods文件夹里注意是放文件本身不要解压。第三步重新启动带 Forge 的配置进入游戏后打开模组列表确认新模组出现在列表里。.minecraft/ ├── mods/ - 模组 .jar 放这里 │ └── 你的模组.jar ├── versions/ - Forge 安装后生成 ├── logs/ - 出问题先看这里 └── saves/ - 存档上面这个目录结构不用背但要知道mods和logs的位置。放好模组后如果游戏崩溃第一时间去logs里找Caused by后面的内容那通常就是真正的原因。跑通这一次你就完成了从「装 Forge」到「用 Forge」的完整闭环后面加更多模组只是重复这个动作区别只在于要留意模组之间的依赖和冲突。4. 新手避坑这几个坑我几乎每次都见人踩4.1 版本对不上游戏直接崩现象启动游戏后黑屏、闪退或者日志里出现Missing or unsupported之类的报错。原因模组要求的游戏版本或 Forge 版本和你装的不一致最常见的是把 1.20.1 的模组放进别的版本或者模组要求更高版本的 Forge。解决回到模组下载页逐字核对它标注的 Minecraft 版本和 Forge 版本区间对不上就换对应版本不要抱着「试试看」的心态硬塞。4.2 模组放错位置或解压了现象模组文件明明放进去了游戏里却完全看不到。原因要么放进了.minecraft根目录而不是mods文件夹要么把.jar解压成了文件夹再放进去。解决确认路径是.minecraft/mods/xxx.jar文件保持.jar原样不要解压。解压后的文件夹 Forge 是不认的这是新手最高频的翻车点之一。4.3 Java 版本不对安装器都打不开现象双击安装器没反应或者命令行报UnsupportedClassVersionError。原因系统里的 Java 版本太旧1.20.1 需要 Java 17旧版本跑不起来。解决装一个 Java 17 运行环境命令行里用java -version确认版本号。如果电脑上有多个 Java注意启动器用的是哪一个必要时在启动器设置里指定 Java 路径。4.4 模组之间打架加一个崩一个现象单独装某个模组没事几个一起装就崩溃。原因两个模组修改了同一块游戏内容或者依赖的前置模组缺失、版本不匹配。解决一次只加一个模组加完启动验证出问题就能定位到刚加的那个看日志里Caused by指向哪个模组再去查它的前置依赖有没有装齐。别一次性丢十几个模组进去那样出了问题根本不知道是谁的锅。4.5 内存不够加载到一半卡死现象游戏启动到加载界面卡住或者进游戏后频繁卡顿、崩溃。原因模组多了以后内存占用上升启动器默认分配的内存不够。解决在启动器的配置里调大内存分配比如把-Xmx2G改成-Xmx4G具体数值看电脑内存量力而行。改完再启动观察是否还卡在同一个位置。5. 下一步学什么从会装到会用的进阶路线环境跑通、第一个模组加载成功之后你其实已经跨过了最难的门槛。接下来怎么走取决于你想玩到什么程度。我把路线分成三层你可以按自己的兴趣挑不用全走。第一层是玩整合包。这是最省心的进阶方式整合包作者已经把模组搭配、配置、内存参数都调好了你只需要用整合包启动器导入就能体验几十上百个模组协同工作的效果。入门建议先挑一个轻量整合包模组数量在几十个左右跑顺了再上大型包。这一层能让你快速见识模组生态的丰富度也能帮你发现自己喜欢哪类模组。第二层是自己配模组组合。当你对某几类模组有偏好后就可以脱离整合包自己在mods文件夹里搭一套。这时候要开始留意三件事前置依赖很多模组需要先装另一个模组才能运行、版本区间、以及模组之间的功能重叠。建议维护一个简单的清单记录每个模组的名字、版本、依赖出问题时对照排查。下面是一个清单示例用表格记就行模组名版本前置依赖备注模组A1.20.1-1.0无基础功能模组B1.20.1-2.3模组A依赖A的接口第三层是看日志、读报错。这一层不涉及写代码但决定了你遇到问题时能不能自己解决。核心习惯只有一个游戏一崩先开logs/latest.log从下往上找Caused by那行往往直接点名是哪个模组、缺什么、版本冲突在哪。看懂报错比记住一百个教程步骤都管用因为每个整合包、每台电脑的情况都不一样能读日志的人才能自己走出来。如果你以后想往开发方向走那才需要接触 Java 和模组开发框架但那是很远的事现阶段完全不用碰。入门阶段的目标很明确把环境装稳、把模组加对、把日志看懂。这三件事做到你就已经比大多数新手走得远了。从那以后我每次装新模组都强制自己「一次只加一个、加完必启动验证、崩了先看日志」这三步走一遍再也没出现过一崩崩一片、完全不知道从哪查的情况。希望帮到你。本文还有配套的精品资源点击获取