Geckolib 开源项目教程

40 0 0

Geckolib 开源项目教程

geckolibGeckoLib is an animation engine for Minecraft mods, with support for complex 3D keyframe-based animations, numerous easings, concurrent animation support, sound and particle keyframes, event keyframes, math-based animations, and more. Available for all major modloaders.项目地址:https://gitcode.com/gh_mirrors/ge/geckolib

项目介绍

Geckolib 是一个用于 Minecraft 模组开发的动画库，它允许开发者为 Minecraft 中的实体和物品创建复杂的动画。该项目由 Bernie-G 开发，旨在简化 Minecraft 模组中的动画制作过程，提供了一套强大的工具和 API，使得开发者能够轻松地为他们的模组添加动态效果。

项目快速启动

环境准备

在开始使用 Geckolib 之前，确保你已经安装了以下工具和环境：

Java Development Kit (JDK) 8 或更高版本
Minecraft Forge 开发环境
一个集成开发环境（IDE），如 IntelliJ IDEA 或 Eclipse

添加依赖

在你的 Minecraft 模组项目中，添加 Geckolib 作为依赖项。在你的 build.gradle 文件中添加以下内容：


repositories {
    mavenCentral()
    maven { url 'https://dl.cloudsmith.io/public/geckolib3/geckolib/maven/' }
}
 
dependencies {
    implementation 'software.bernie.geckolib:geckolib-forge-1.16.5:3.0.0'
}

创建动画模型

创建一个新的模型类，继承自 GeoModel。
在模型类中，定义你的动画模型文件路径。


import software.bernie.geckolib3.model.AnimatedGeoModel;
 
public class MyEntityModel extends AnimatedGeoModel<MyEntity> {
    @Override
    public ResourceLocation getModelLocation(MyEntity object) {
        return new ResourceLocation("modid", "geo/my_entity.geo.json");
    }
 
    @Override
    public ResourceLocation getTextureLocation(MyEntity object) {
        return new ResourceLocation("modid", "textures/entity/my_entity.png");
    }
 
    @Override
    public ResourceLocation getAnimationFileLocation(MyEntity object) {
        return new ResourceLocation("modid", "animations/my_entity.animation.json");
    }
}

注册实体

在你的主类中注册实体和模型：


import net.minecraftforge.event.entity.EntityAttributeCreationEvent;
import net.minecraftforge.eventbus.api.SubscribeEvent;
import net.minecraftforge.fml.common.Mod;
 
@Mod("modid")
public class MyMod {
    public MyMod() {
        // 注册实体
        EntityRegistry.registerEntity(MyEntity.class, "my_entity", 0, this, 80, 3, true);
    }
 
    @SubscribeEvent
    public static void onEntityAttributeCreation(EntityAttributeCreationEvent event) {
        event.put(EntityRegistry.MY_ENTITY, MyEntity.createAttributes().build());
    }
}