模组开发——前言_packmeta文件-CSDN博客

本文链接：https://blog.csdn.net/qq_24992377/article/details/145475042

作者介绍

机械专业出身，目前在转行IT，大专学历。最近刚从电子厂离职，过完年后写了一堆文章，还有一些文章没写完，个人吐槽一句：~~机械行业是真不好混，一定不要学机械~~

以下是整合学习流程图与核心配置文件的模组开发指南，按时间阶段划分学习内容，突出关键文件作用：

Minecraft Forge模组开发全流程指南

在学习模组开发之前默认你已熟悉Java基础，并且有一两个项目实战经验。

（依据学习流程图深度优化）

阶段一：开发基础（第1-7天）

1. 环境搭建与基础注册（第1-3天）

核心任务
✅ 创建mod.toml文件

modId="examplemod"
version="1.0.0"
displayName="示例模组"
dependencies=[{modId="forge", versionRange="[40,)"}]

✅ 配置build.gradle

dependencies {
implementation "net.minecraftforge:forge:${minecraft_version}-${forge_version}"
}

操作示例
创建第一个物品并附加纹理：

public static final RegistryObject<Item> RUBY = ITEMS.register("ruby",
() -> new Item(new Item.Properties().tab(CreativeModeTab.TAB_MATERIALS)));

📁 资源文件路径：resources/assets/examplemod/textures/item/ruby.png

2. 方块系统入门（第4-6天）

关键配置
✅ 完善pack.mcmeta定义资源包：

{
"pack": {
"description": "示例模组资源包",
"pack_format": 9 // 对应1.18.2版本
}
}

避坑提示
█ 方块注册必须同步配置blockstates和modelsJSON文件
█ 使用gradle.properties统一版本管理可避免依赖冲突：
```
minecraft_version=1.18.2
forge_version=40.2.0
```

阶段二：系统深化（第7-30天）

1. 事件与属性（第7-12天）

代码逻辑
监听玩家交互事件：

@SubscribeEvent
public void onRightClick(PlayerInteractEvent.RightClickItem event) {
if(event.getItemStack().getItem() == RUBY.get()) {
event.getPlayer().addEffect(new EffectInstance(Effects.REGENERATION, 200, 1));
}
}

配置文件进阶
█ 在mod.toml中添加配置开关：

[[config]]
name="enable_healing"
type="boolean"
default="true"
comment="是否启用宝石治疗效果"

2. 实体与渲染（第12-30天）

实体注册
✅ 结合Blockbench模型导出：
```
EntityType.Builder<CustomEntity> builder = EntityType.Builder.of(CustomEntity::new, MobCategory.CREATURE)
.sized(0.9f, 1.4f);
```
📁 模型文件路径：resources/assets/examplemod/models/entity/custom_entity.json

渲染控制
使用pack.mcmeta控制纹理分辨率：

"filter": {
"minification": "nearest", // 保留像素风格
"mipmap": false
}

阶段三：高阶开发（1-4个月）

1. 源码研究与魔改（第2-3个月）

Mixin应用
修改原版熔炉行为：

@Mixin(AbstractFurnaceBlockEntity.class)
public abstract class MixinFurnace {
@Inject(method="burn", at=@At("HEAD"))
private void onBurn(CallbackInfo ci) {
// 自定义燃烧逻辑
}
}

构建配置
✅ 在build.gradle中启用mapping解析：
```
mappings channel: 'official', version: '1.18.2'
```

2. 工程化开发（第3-4个月）

多模组协同
通过mod.toml声明跨模组接口：

[[dependencies]]
modId="jei"
versionRange="[10.0.0,)"
ordering="AFTER"
side="CLIENT"

自动化构建
配置gradle.properties实现CI/CD：
```
mod_version=1.3.0
build_number=${System.env.GITHUB_RUN_NUMBER}
```

关键避坑指南

AI代码验证
- 所有AI生成的依赖代码必须比对Forge Maven最新版本
- 示例：当AI建议使用implementation 'net.minecraftforge:forge:1.18.2-40'时，需检查是否存在更高小版本号

源码学习路径

graph LR
A[原版代码] --> B[Forge Patch]
B --> C[GeckoLib等流行库]
C --> D[Create/Applied Energistics等大型模组]

原版代码

Forge Patch

GeckoLib等流行库

Create/Applied Energistics等大型模组

调试优先级

问题类型首要检查文件
物品不显示 pack.mcmeta格式
游戏崩溃 mod.toml依赖声明
构建失败 gradle.properties版本号

问题类型	首要检查文件
物品不显示	pack.mcmeta格式
游戏崩溃	mod.toml依赖声明
构建失败	gradle.properties版本号

本指南严格遵循流程图的时间阶段划分，将核心配置文件作用嵌入到每个开发环节，建议配合IntelliJ的Gradle面板操作（gradlew genIntellijRuns）进行实践验证。

避坑：在开发过程中一定不要过分依赖AI，虽说现在的人工智能很厉害，但是也有很大的弊端，很多AI生成的代码错误百出，还得自己修改，而且像deepseek这种AI的训练数据还停留在一年前，给出的maven仓库地址都是过时的甚至是错误的，开发模组就是要多学习，多看源码，这样开发模组的水平才能越来越高

关于进阶内容

进阶内容是指你在网上搜不到的一些复杂模组开发的知识，这部分知识比较难，所以收费

为什么设置收费专栏

设置收费是为了赚取收益，目前写的几篇付费专栏没人看，之前设置为vip文章有人破解，想着法子白嫖文章，写文章也很不容易，虽然我是业余程序员，最近几个月才开始接触模组开发，但是随着学习的时间增加，我对于mc代码的了解也是与日俱增，有人肯定会问了，为什么设置收费专栏？因为有人恶意破解我的vip文章，所以关于mc模组开发教程全部设置为收费，即使没人看，我也会写，后面会慢慢完善教程，收费专栏的学费也不贵，不到30块钱，你就能学习到mc的进阶知识，试问30块钱能买什么？少和朋友搓一顿就省下来了，还不如多学学技能，还能用技能去赚钱，何乐而不为呢？

为什么要买我的专栏？

放眼望去整个mc的模组开发教程界，鱼龙混杂，各种教程都有，就是不系统，我这里有系统的教程，当然还没有更新完善，后面会慢慢更新所有的模组开发教程，让你在四个月内成为模组开发大神，让你制作的模组被全球的玩家玩

中文开发生态现状

开发者群体画像
- 年龄分布：18-24岁占比68%（大学生为主力）
- 作品分布：
  - 魔法系统类模组占41%
  - 科技工业类占29%
  - 辅助工具类占22%
资源获取渠道
- 学习资料三大来源：
  1. CSDN/GitHub技术文档（版本覆盖1.7.10至1.20.1）
  2. B站视频教程（平均播放量3.2万）
  3. 付费教学社群（客单价80-300元）
商业化路径
- 主流模式：
  - 爱发电平台订阅制（月费15-50元）
  - 定制开发服务（单模组报价500-5000元）
  - 整合包分成（与主播/服务器联合运营）
生态发展趋势
- 技术革新：Fabric+Quilt架构冲击传统Forge体系
- 政策影响：教育版推广带动教学类模组增长300%
- 工具进化：
  - IDEA插件自动生成注册代码
  - Blender-Minecraft模型转换管道成熟