Minecraft 1.16.5模组开发(三十二) 自定义投掷物品实体

如果你了解过之前我们的实体开发教程，那么本次的教程会相对比较好理解。

Minecraft 1.12.2模组开发(七) 实体(魔改Zombie)

我们本次将参考雪球在MC中制作一个属于我们自己的可投掷实体。

雪球(Snowball)-[MC] 我的世界原版 (Minecraft)

1.首先，我们要知道，我们的可投掷物品是一个实体，所以我们需要对这个实体进行建模

可以使用BlockBench进行建模工作：
BlockBench下载地址

相关教程

国外中英字幕
酒石酸菌(国人大神%%%)

使用BlockBench进行实体建模工作：

之后导出物品模型

将我们的模型.json文件放入resources\assets\模组名\models\item文件夹下：

2.在entity包下创建投掷物实体类(以EntityM1897B为例)：

在EntityM1897B.java中编写代码：

package com.joy187.re8joymod.common.entity;

import com.joy187.re8joymod.common.init.EntityInit;
import com.joy187.re8joymod.common.init.ModItems;
import io.netty.buffer.Unpooled;
import net.minecraft.entity.Entity;
import net.minecraft.entity.EntityType;
import net.minecraft.entity.LivingEntity;
import net.minecraft.entity.monster.BlazeEntity;
import net.minecraft.entity.monster.RavagerEntity;
import net.minecraft.entity.monster.WitherSkeletonEntity;
import net.minecraft.entity.projectile.ProjectileItemEntity;
import net.minecraft.item.Item;
import net.minecraft.item.ItemStack;
import net.minecraft.network.IPacket;
import net.minecraft.network.PacketBuffer;
import net.minecraft.particles.IParticleData;
import net.minecraft.particles.ItemParticleData;
import net.minecraft.particles.ParticleTypes;
import net.minecraft.util.DamageSource;
import net.minecraft.util.math.EntityRayTraceResult;
import net.minecraft.util.math.RayTraceResult;
import net.minecraft.world.World;
import net.minecraftforge.api.distmarker.Dist;
import net.minecraftforge.api.distmarker.OnlyIn;
import net.minecraftforge.fml.network.NetworkHooks;


public class EntityM1897B extends ProjectileItemEntity {
    public int explosionPower = 1,id=91087;
    public Entity shootingEntity;
    private double damage;

    public EntityM1897B(EntityType<? extends EntityM1897B> p_i50159_1_, World p_i50159_2_) {
        super(p_i50159_1_, p_i50159_2_);
        this.damage=2.5;
    }

    public EntityM1897B(World world, LivingEntity entity) {
        super(EntityInit.M1897B.get(), entity, world);
        this.damage=5;
    }

    public EntityM1897B(World p_i1775_1_, double p_i1775_2_, double p_i1775_4_, double p_i1775_6_) {
        super(EntityInit.M1897B.get(), p_i1775_2_, p_i1775_4_, p_i1775_6_, p_i1775_1_);
    }


    //打击到生物上产生的效果
    protected void onHitEntity(EntityRayTraceResult p_213868_1_) {
        super.onHitEntity(p_213868_1_);
        Entity entity = p_213868_1_.getEntity();

        int i = 5;
        if(entity instanceof BlazeEntity || entity instanceof WitherSkeletonEntity){
            i = 7;
        }
        if(entity instanceof EntityEthan || entity instanceof EntityHeisen || entity instanceof EntityFrank6){
            i= 9;
        }
        if(entity instanceof EntitySamca || entity instanceof EntityFrank4){
            i= 3;
        }
        entity.hurt(DamageSource.thrown(this, this.getOwner()), (float)(i+random.nextFloat()*0.5*this.damage));
    }

    //投掷物撞击到物体所产生的效果
    protected void onHit(RayTraceResult p_70227_1_) {
        super.onHit(p_70227_1_);
        if (!this.level.isClientSide) {
            this.level.broadcastEntityEvent(this, (byte)3);
            //你可以增加爆炸效果
//            this.level.explode((Entity)null, this.getX(), this.getY(), this.getZ(), (float)this.explosionPower, false, Explosion.Mode.DESTROY);
            this.remove();
        }
    }

    //投掷物产生的粒子效果
    @OnlyIn(Dist.CLIENT)
    private IParticleData getParticle() {
        ItemStack itemstack = this.getItemRaw();
        return (IParticleData)(itemstack.isEmpty() ? ParticleTypes.FLAME : new ItemParticleData(ParticleTypes.ITEM, itemstack));
    }

    @OnlyIn(Dist.CLIENT)
    public void handleEntityEvent(byte p_70103_1_) {
        if (p_70103_1_ == 3) {
            IParticleData iparticledata = this.getParticle();

            for(int i = 0; i < 8; ++i) {
                this.level.addParticle(iparticledata, this.getX(), this.getY(), this.getZ(), 0.0D, 0.0D, 0.0D);
            }
        }

    }


    @Override
    protected Item getDefaultItem() {
        return ModItems.M1897B.get();
    }

    //这个函数很重要，因为我们的投掷物实体不被原版所识别，所以需要将数据包专门传给EventBusSubscriber进行处理
    @Override
    public IPacket<?> getAddEntityPacket() {
        PacketBuffer pack = new PacketBuffer(Unpooled.buffer());
        pack.writeDouble(getX());
        pack.writeDouble(getY());
        pack.writeDouble(getZ());
        pack.writeInt(getId());
        pack.writeUUID(getUUID());


        return NetworkHooks.getEntitySpawningPacket(this);
    }


    public IPacket<?> getEntitySpawningPacket() {
        return NetworkHooks.getEntitySpawningPacket(this);
    }

}

3.创建完实体之后，需要对实体进行渲染，在render包下新建实体渲染类(以RenderM1897B为例)：

在RenderM1897B.java中编写：

package com.joy187.re8joymod.common.entity.render;

import com.joy187.re8joymod.Utils;
import com.joy187.re8joymod.common.entity.EntityM1897B;
import com.mojang.blaze3d.matrix.MatrixStack;
import com.mojang.blaze3d.vertex.IVertexBuilder;
import net.minecraft.client.renderer.IRenderTypeBuffer;
import net.minecraft.client.renderer.RenderType;
import net.minecraft.client.renderer.entity.EntityRenderer;
import net.minecraft.client.renderer.entity.EntityRendererManager;
import net.minecraft.client.renderer.texture.OverlayTexture;
import net.minecraft.util.ResourceLocation;
import net.minecraft.util.math.BlockPos;
import net.minecraft.util.math.vector.Matrix3f;
import net.minecraft.util.math.vector.Matrix4f;
import net.minecraft.util.math.vector.Vector3f;
import net.minecraftforge.fml.client.registry.IRenderFactory;


public class RenderM1897B extends EntityRenderer<EntityM1897B> {

    //这个是我们的投掷物的贴图，一般放在我们贴图文件夹下的生物文件夹内
    public static final ResourceLocation TEXTURE = new ResourceLocation(Utils.MOD_ID ,"textures/entity/m1897.png");
    private static final RenderType field_229044_e_ = RenderType.entityCutoutNoCull(TEXTURE);

    public RenderM1897B(EntityRendererManager manager) {
        super(manager);
    }

    protected int getSkyLightLevel(EntityM1897B p_239381_1_, BlockPos p_239381_2_) {
        return 15;
    }


    public void render(EntityM1897B entityIn, float entityYaw, float partialTicks, MatrixStack matrixStackIn, IRenderTypeBuffer bufferIn, int packedLightIn) {
        matrixStackIn.pushPose();
        matrixStackIn.scale(2.0F, 2.0F, 2.0F);
        matrixStackIn.mulPose(this.entityRenderDispatcher.cameraOrientation());
        matrixStackIn.mulPose(Vector3f.YP.rotationDegrees(180.F));
        MatrixStack.Entry matrixstack$entry = matrixStackIn.last();
        Matrix4f matrix4f = matrixstack$entry.pose();
        Matrix3f matrix3f = matrixstack$entry.normal();
        IVertexBuilder ivertexbuilder = bufferIn.getBuffer(field_229044_e_);
        func_229045_a_(ivertexbuilder, matrix4f, matrix3f, packedLightIn, 0.0F, 0, 0, 1);
        func_229045_a_(ivertexbuilder, matrix4f, matrix3f, packedLightIn, 1.0F, 0, 1, 1);
        func_229045_a_(ivertexbuilder, matrix4f, matrix3f, packedLightIn, 1.0F, 1, 1, 0);
        func_229045_a_(ivertexbuilder, matrix4f, matrix3f, packedLightIn, 0.0F, 1, 0, 0);

        matrixStackIn.popPose();
        super.render(entityIn, entityYaw, partialTicks, matrixStackIn, bufferIn, packedLightIn);
    }

    @Override
    public ResourceLocation getTextureLocation(EntityM1897B  p_110775_1_) {
        return TEXTURE;
    }

    private static void func_229045_a_(IVertexBuilder p_229045_0_, Matrix4f p_229045_1_, Matrix3f p_229045_2_, int p_229045_3_, float p_229045_4_, int p_229045_5_, int p_229045_6_, int p_229045_7_) {
        p_229045_0_.vertex(p_229045_1_, p_229045_4_ - 0.5F, (float)p_229045_5_ - 0.25F, 0.0F).color(255, 255, 255, 255).overlayCoords(OverlayTexture.NO_OVERLAY).normal(p_229045_2_, 0.0F, 1.0F, 0.0F).endVertex();
    }

    //对物品进行游戏内渲染工作
    public static class RenderFactory implements IRenderFactory<EntityM1897B> {

        @Override
        public EntityRenderer<? super EntityM1897B> createRenderFor(EntityRendererManager manager) {
            manager.setRenderShadow(false);
            return new RenderM1897B(manager);
        }
    }
}

4.在EntityInit.java中添加我们的投掷物的制作信息

//注意我们的投掷类物品不是生物，所以分类为MISC
public static final RegistryObject<EntityType<EntityM1851B>> M1897B =
            ENTITY_TYPES.register("m1897b", () -> EntityType.Builder.<EntityM1851B>of
                    (EntityM1851B::new, EntityClassification.MISC).sized(0.25F, 0.25F).setTrackingRange(4).updateInterval(10).build("m1897"));

5.在ClientModEventSubscriber.java中添加我们的实体注册信息：

        //注意可投掷实体不是真的生物所以要用SpriteRenderer进行渲染
        RenderingRegistry.registerEntityRenderingHandler(EntityInit.M1897B.get(),
                renderManager -> new SpriteRenderer(renderManager, Minecraft.getInstance().getItemRenderer()));

6.我们的投掷物品是一个物品，所以需要创建一个专门的物品类(以ItemM1897B为例)

在Items包下新建ItemM1897B.java，在文件中编写：

package com.joy187.re8joymod.common.items;

import com.joy187.re8joymod.common.entity.EntityM1897B;
import com.joy187.re8joymod.events.RegistryEvents;
import net.minecraft.entity.LivingEntity;
import net.minecraft.item.Item;
import net.minecraft.item.ItemStack;
import net.minecraft.world.World;


public class ItemM1897B extends Item {
    public ItemM1897B() {
        super(new Properties().tab(RegistryEvents.RE8GROUP).stacksTo(16));
    }
    
    //我们的投掷类物品类似于箭，所以可以参考箭的相关代码
    public EntityM1897B createArrow(World p_200887_1_, ItemStack p_200887_2_, LivingEntity p_200887_3_) {
        EntityM1897B arrowentity = new EntityM1897B(p_200887_1_, p_200887_3_);
        return arrowentity;
    }
    
    //判断我们的子弹是否有限(比如创造模式下一根箭就代表着无限支箭)
    public boolean isInfinite(ItemStack stack, ItemStack bow, net.minecraft.entity.player.PlayerEntity player) {
        int enchant = net.minecraft.enchantment.EnchantmentHelper.getItemEnchantmentLevel(net.minecraft.enchantment.Enchantments.INFINITY_ARROWS, bow);
        return enchant <= 0 ? false : this.getClass() == ItemM1897B.class;
    }
}

在ModItems包下添加物品的注册信息：

    public static RegistryObject<Item> M1897B = ITEMS.register("m1897b",()->
    {
        return new ItemM1897B();
    });

7.在resources包中的en_us.json文件中添加物品的语言信息：

  "item.re8joymod.m1897b":"Shotgun Bullet",
  "entity.re8joymod.m1897b": "Shotgun Bullet",

8.至此所有的代码工作已经结束，进入游戏进行演示：

首先将我们的物品丢出来进行展示：

使用枪支将可投掷物品射出去：

MC枪支制作教程

OK，大功告成！