我的世界豆豆幻影模组制作指南

凌晨两点半，咖啡杯见底，电脑屏幕的光刺得眼睛发酸。但想到明天要交的模组作业，还是得把这篇教程肝完。说实话，豆豆幻影模组（Bean Phantom）这玩意儿真不是新手能轻松搞定的，但跟着我的步骤走，至少能少踩80%的坑。

一、准备工作：别急着写代码

去年第一次尝试做这个模组时，我直接打开IDE就开始敲代码，结果三个小时后发现连基础框架都搭错了。现在学乖了，得先把这些准备好：

Java开发环境：JDK 17以上（别用JDK 21，Forge还没适配）
开发工具：IntelliJ IDEA社区版就够用，别被收费版忽悠
必装软件：Git（版本控制）、Gradle（项目管理）
参考资料：《Minecraft Modding with Forge》电子版（图书馆能借到）

记得在C盘留至少10GB空间，Gradle第一次构建时会下载一堆依赖包，我那破笔记本上次卡了整整40分钟。

二、搭建基础框架

打开命令行时手抖输错了三次cd命令，这破键盘该换了。下面是正经步骤：

到Forge官网下载MDK（Mod Development Kit）
解压后用IDEA打开build.gradle文件
等Gradle同步完成（可以去泡碗面）

遇到报错别慌，90%的问题都能用这两个命令解决：

命令	作用
gradlew clean	清理构建缓存
gradlew build	重新构建项目

2.1 文件结构注意事项

凌晨三点十七分，窗外有只野猫在叫。强迫症患者注意这些文件夹别放错位置：

src/main/resources - 贴图、音效、语言文件
src/main/java - 核心代码区
src/main/modloader - 这个文件夹要手动删掉

三、实现豆豆幻影核心功能

咖啡因开始上头了。豆豆幻影的本质是会在玩家周围生成会跳的豆子状生物，这些是关键技术点：

3.1 实体类创建

在entity包下新建BeanPhantom.java，核心代码长这样：

public class BeanPhantom extends Mob {
    private int jumpCooldown = 0;
    
    @Override
    public void tick() {
        if (!this.level.isClientSide && jumpCooldown-- <= 0) {
            this.jump();
            jumpCooldown = 20 + random.nextInt(30);
        }
    }
}

注意要继承Mob而不是Entity，否则AI系统用不了。上周在这个坑里浪费了两小时。

3.2 特殊跳跃逻辑

豆豆的特色是弹跳轨迹要带抛物线，参考了高中物理的斜抛运动公式：

参数	值
初始速度	0.5f + random.nextFloat()
角度范围	30°-60°

具体实现时要用到Vec3向量计算，建议直接抄Forge源码里的ProjectileHelper类。

四、添加趣味特性

四点半了，眼睛开始发涩。但既然要做就做点好玩的：

颜色变异：根据世界时间随机改变豆豆颜色
音效彩蛋：1%概率播放"pop"音效
死亡特效：爆出彩虹粒子效果

粒子效果代码特别容易写崩，记得先备份。上次我不小心写成了无限循环，游戏直接卡死。

五、测试与调试

天快亮了，最后这段写得有点飘。测试时务必注意：

先在小范围生成（别超过20只）
准备崩溃日志分析工具（推荐Notepad++）
关闭所有光影mod（容易引发渲染冲突）

常见错误代码对照表：

错误代码	可能原因
NullPointerException	忘了注册实体
IllegalArgumentException	贴图路径写错了

保存最后一遍代码，Gradle build通过的那一刻，晨光正好照在键盘上。虽然还有几个小bug没修，但至少豆豆们能欢快地在地图上蹦跶了。

我的世界豆豆幻影模组怎么做