1. Minecraft 1.21.1 NeoForge开发环境搭建全指南
作为一名从1.7.10时代就开始折腾Minecraft模组的老玩家,这次升级到1.21.1版本确实让我眼前一亮。NeoForge作为Forge的分支项目,在开发体验上做了不少优化。今天我就把最近搭建开发环境时踩过的坑和心得整理出来,希望能帮到刚入门的模组开发者们。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Java环境配置
2.1 JDK版本选择
Minecraft 1.21.1要求的最低Java版本是21,这点和之前的版本有很大不同。我实测过用Java 17运行会直接报错,所以千万别图省事用旧版本。
推荐直接从Oracle官网下载JDK 21:
- 选择"JDK 21"标签页
- 根据你的系统下载对应安装包(Windows选.exe,macOS选.dmg)
- 安装时建议使用默认路径(C:\Program Files\Java\jdk-21)
注意:OpenJDK也可以使用,但部分IDE对Oracle JDK的兼容性更好。如果遇到奇怪的问题,可以换回Oracle版本试试。
2.2 环境变量配置
装完JDK后需要设置两个关键环境变量:
- JAVA_HOME:指向JDK安装目录(例如C:\Program Files\Java\jdk-21)
- 在Path中添加%JAVA_HOME%\bin
验证方法:
bash复制java -version
应该显示类似这样的输出:
code复制java version "21" 2023-09-19
Java(TM) SE Runtime Environment (build 21+35-LTS-2513)
3. NeoForge开发包获取
3.1 官网下载MDK
NeoForge的官网是neoforged.net,相比旧版Forge,它的MDK生成页面做了很大改进:
- 访问官网后点击"Mod Generator page"
- 填写模组基本信息:
- Mod ID:全小写字母,不能有特殊字符(建议用下划线替代空格)
- Display Name:模组显示名称
- 作者信息
- 高级选项中可以勾选Mixin支持(新手可以先不选)
点击下载后会得到一个zip压缩包,解压到你
