第一章 正式开始前的杂谈
这是一个教你怎么写一个对标 Minecraft1.21并使用NeoForge模组加载器的模组的教程。
⚠️警告
本教程只适用于使用
NeoForge模组加载器的Minecraft1.21版本，如果你在写别的版本的模组，参考本教程可能会导致你的代码出错或出现未经验证的问题。
ℹ️使用须知
在本教程中，我们只讨论如何用Java写模组，不会讨论有关MCreator这类模组制作器的使用。如果你不会Java，请先学习Java。
我是什么时候开始写模组的？
大概是3年前，我初二的时候。
那阵子天天上网课，接触电脑的时间也多了，就萌生了写模组的念头。
就编程基础而言，刚开始写模组的时候我的基础并不牢固——Java是初一自学的，直到开始学写模组时也就学了不到一年的功夫。而这之后技术经验的积累，有很大一部分来自于其他大佬的模组教程。
也正是因为开源社区的优势，我得以完成我的第一份模组。感激社区，也感谢所有支持知识开源的人们！
当初为什么选择写模组？
我可是一个忠实的MC玩家！把自己想到的东西加到游戏里这件事可太酷了！不是吗？
其实，对于当时的我而言，我根本看不懂代码中一行行的lambda表达式~~(毕竟书上没写)~~，只能照葫芦画瓢。其余大量时间则是在翻阅代码说明文档，搞清楚某种写法到底表达了什么。在这种奇怪的环境下，孕育出了一个旧时代的码字狂魔(雾)。我的家具计划FurniturePlan加入了很多方块对吧？现在我可以在这个库内仅用两小时就新增百余种方块，而这一切的基础，就来自最初的那份53材质的椅子注册清单，我初二的时候一字一字码出来的一组万余字的代码表。
除此之外，初二那年生日，我的好朋友送我了一份泰拉瑞亚。游玩之余，我们便有了一个想法：如果把泰拉物品搬到MC里，将会是一个很不错的选择吧。于是在某一天，由jing_qi、withdrawn(shadow)建议，我作为队长的Ti works团队便正式成立了。这大概就是我全部的动力来源了。
值得一提的是，我们的第一个模组也确实就是泰拉模组，只是因为我当时拙劣的技术并不能胜任这样一个高难度模组的编写。最终，泰拉模组于2023年5月份，彻底的停更了(可悲的是我能找回的版本只有一个魔镜和一点矿物，那个写了一堆的版本则因为没有上传而在某次IDEA更新中被覆写删除了)。现在，你仍能在我的项目里找到已经被资源化的库：泰拉瑞亚项目库。而我本人在一年后参与了可能是现在最优秀的MC泰拉模组——汇流来世1的一点辅助工作。
由此可见，并非所有事情都是一帆风顺的。一日功，未必见果；日日功，铁杵成针。
写模组都需要什么？
首先，毫无疑问的，你需要一台性能不错的电脑，最好是Windows~~(才不是因为我没用过别的系统呢)~~，因为本教程使用Windows平台讲解。
其实，Linux才是最适合开发模组的环境。只可惜Linux的软件还是没Windows多，况且大家也只是一味地安装Windows。
这是详细的最低配置单(不一定必须高于这个要求，只不过编程体验会打折扣)：
- i5 7代非低压或高于其性能的处理器——这能给你提供更好的码字和测试体验。
- 一颗快速的SSD存储，位于你的主板上——下面会解释
- 至少16GB内存——这将确保你不会为了一次测试卡半天。
- 确保你的C盘至少有10个G的预留空间(不是剩余空间！！！)——项目构建所需，不建议卡极限(5GB)，但是如果你会且能妥善操作硬链接则另当别论。
- 一个稳定的网络环境，有梯子(咳咳，我说的是脚手架，你听错了)更好——初次构建模组会视网络情况和硬件情况从20min到[Failed]不等！这可是个不小的差距呢！
为什么我要提出如此高(这真的算高吗)的条件呢......因为我初中两年的开发都是在：
打开电脑
等待8分钟
双击IDEA
等待7分钟，IDEA打开项目
写代码4分钟
点击运行调试
等待15分钟，进入游戏，此时鼠标不太受控制
测试+卡死大概10分钟
点击退出游戏
等待20分钟
电脑硬件协调稍微缓和
继续改动代码......
喏，这一切都是因为我的工作本使用的是5年前(对于当时)的一款HDD硬盘，它的老化引起的低效传输直接导致了很多卡顿等烦人的问题。还有我那可怜的8GB内存，一开测试就得上97%，转储估计都得气红温了（
只有经历过如此卡顿苦难之人，才能体会现在的美好。有了新电脑后，我半年开发学习的量，是我初中两年也达不到的水平。
其次，还需要合适的环境。对于本教程，你需要安装：
- Java--JDK21——Java开发必不可少的环境。
- [IntelliJ IDEA Community Version](Download IntelliJ IDEA – The Leading Java and Kotlin IDE)
这个先别急着下载，我会在下一章详细讲解怎么安装的。
⚠️注意
本教程所涉及的所有软件常规版本均无需付费。请勿上当受骗，请勿从非正规网站下载本教程资源。如果因此产生任何问题，后果自负。
我都看过哪些模组教程？
为了方便，我会在这里按时间顺序列出所有我看过的教程。这些教程都是可以在国内直接访问的，所以不用担心。
-
brianShan974的模组教程
这是我刚开始学的时候看到的第一个中文教程。这是针对1.12.2的，并且对于现在已经过时(就是更新后很多方法改名了的意思)。但它对我的帮助很大，至少让我学会了怎么开始构建和写。
-
Forge Documentation
即Forge文档，我早期经常看的另一个教程，是英文。
-
McJty的模组教程
英文，很详细，有视频版和博客版，博客版涵盖了很多版本的教程。
-
KaupenJoe的模组教程
这个也是B站UP搬运的，纯英文，有很多集，只是没有合并为集合。好像也有对标其他版本的教程。(我之前拿它当听力素材的，比较简单，能听懂)
-
Forge Community Wiki
这个英文站点国内访问速度比较慢，不过至少能看。分类繁多，言简意赅，适合参考。
-
Minecraft Developer Guide
这是由mouse0w0(耗子)大佬整理的一份超级丰富的教程和资源的中文清单。不过GitHub访问很不稳定。
-
NeoForge Documentation
这就是本教程的核心参考，NeoForge的官方英文文档。
以上，基本就是我看过的全部教程了。B站上还有个大佬叫Flandre芙兰2，他的教程我还没看过，不过应该也很不错。
哦对了，道家深湖大佬很早前就创建了在QQ上的相关群聊，涵盖了构建问题和编程问题的解答；还有一个国内的模组开发者社区名为TeaCon，也是大佬云集。以上群体，建议自行查找，这里不作过多推广。
另外，我们Ti adventurers' party也有自己的群聊，现在同时有着开发答疑的功能。
章末小记
说实话，我也不清楚我什么时候能把这个坑填完。本来是初中就想出一个像样的教程回馈社区的，但是一直没能付诸行动，可能这就是我的一大弱点吧。高二的学习还是有些繁忙的，偶尔放放松，和大家聊聊天，生活倒也能充实许多。
对了，给你们看看我不再编写Ti works版本的泰拉瑞亚模组的原因之一，很好笑的(可能吧？) :
MakerTechno编辑于2024年10月26日
MakerTechno修正于2025年6月28日，并添加了标识性头
MakerTechno改写于2025年8月4日，更改了本站教程的协议类型
Copyright © 2025 MakerTechno. 保留所有权利。
在明确注明原文出处（包括作者名与原始链接）的前提下，允许非商业性地引用本作品片段。引用内容不得超过原文的 20%，不得歪曲原意或用于误导性语境。整篇转载或复制使用需获得作者授权。本网站所有教程不允许商用，也不会授予商用授权。
Footnotes
-
找了一个介绍视频: [汇流来世] - 群系与结构更新 ↩
-
芙兰的Bilibili空间: https://space.bilibili.com/4550069 ↩