[TUTORIAL] How to use Nerdy's GeckoLib Plugin

Started by NerdyPuzzle on Tue, 10/11/2022 - 14:12

Topic category: User side tutorials

Last seen on 12:55, 3. Dec 2022
Joined Jul 2022
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
[TUTORIAL] How to use Nerdy's GeckoLib Plugin
Mon, 11/21/2022 - 00:29 (edited)

Time to learn how to use your GeckoLib models and animations! The plugin, by default, will play 8 built-in animations (which your animations will need to be named as when making them):

  • "walk" -Walking animation (loops)
  • "idle" -Idle animation (loops)
  • "death" -Death animation
  • "swim" -Swimming animation (loops)
  • "attack" -Attack animation (will not work if entity is set as an animal in the AI tab, needs to be triggered manually in that case)
  • "sneak" -Will play while the entity is crouching (can be set though a procedure block, loops)
  • "sprint" -Will play while the entity is sprinting (can be set through a procedure block, loops)
  • Support for the head movement animation which will apply to the group named as "head" in blockbench. Added as an option of the model procedure in version 1.5

These animations will not require a procedure to play (except for sneak and sprint). If you do not want to make them, don't, since you can use the procedure added in version 1.9 of the plugin to play any animation you want.

Your animation file and model file will need to start with the same name. (entity.animation.json, entity.geo.json) The animations for the built-in triggers inside the animation file need one of the names above. Delete the default name you get when creating them, there's no need for the animation.entity.new nonsense I keep seeing people use in the replies. The animations you trigger through the procedure can be named anything you want.

 

EDIT: Since some of you seem to have a bit of trouble with this, here is a screenshot showing how you structure the animations properly in blockbench:

animations

Your model will need to be a GeckoLib animated model, which is available when using the GeckoLib blockbench plugin. Java models or bedrock models made without it will NOT work unless converted. The model name needs to be lowercase and not have any spaces.

 

 

Now, onto the first step, which is obviously enabling the API and regenerating the code.

 

Once the API is enabled, you will need to create two folders in your mod's assets directory, "geo" and "animations". Drop your animation file in the animations folder and your model in the geo folder. Your texture can be imported as any regular texture is imported into MCreator.

 

files

 

 

 

 

 

 

 

 

 

 

 

 

 

Now that you've imported your assets, It's time to make an entity. This is as simple as it normally would be. Create your entity, and before saving it, simply set any texture to it. The model and textures you select will not matter unless you plan on using a java model (and you aren't using 1.16.5, in which java models won't be supported).

 

entity

 

 

Take note of what you named your entity element, this will be required later. Not the name of the entity, the name of the element.

Now, you may have noticed that this gives you an error. This is fine, as we have not registered a model to it yet.

To register a model, you need to create a new procedure, which contains the name of your entity element, followed by Model with a capital M as shown below:

 

model element

 

 

 

 

 

 

 

 

 

Once created, select the Setup model (GeckoLib) event (renamed to Setup class in version 2.2) which is provided by the plugin, and ONLY use the procedure which is provided by the plugin to set the appropriate names of your entity, model and texture.

 

procedure

 

 

 

 

 

Save the procedure. You will get an error, which is still normal as the code of the entity has not updated, and doesn't know the new procedure exists.

 

And finally, to get rid of the error and finish setting up your GeckoLib entity, simply regenerate the code, or open and save your entity again.

 

That's it! You can now follow the same steps to add as many GeckoLib entities as you want into your mod.

 

v1.6 Update - Glow layer support tutorial

Missed them? Well, glow layers are back!

Registering a glow layer is very simple. The first step is creating a new procedure, with the name of your entity followed by Layer. You should now have three elements that look similar to the ones below. The capital letters are very important.

elements

Inside the layer procedure, select the model setup event you used in your model procedure, and use the new procedure block provided by the plugin. The model will need to be the model of the entity you're registering the layer for and the texture name will obviously be the name of the glowing texture you are registering which needs to be imported as an entity texture so the procedure can locate it.

layer

Now, the final step will be to enable the glow layer by going in your entity settings and choosing any texture for the glow layer option. Which one you choose does not matter, since the model will use the texture you specified in the procedure.

textureglow

Now, to get rid of build errors, regenerate the code and you're good to go!

Here is the result of using a glow layer on the example entity shown in the plugin page:

result

 

 

v1.8 Update - Disabling death rotation

Did you make a death animation, and yet you cannot really see it due to the way the entity rotates when it's killed?

Well, here is the solution you've been looking for!

Disabling deah rotation is possibly the simplest to use feature yet. All there is to it is selecting the built-in chicken model in your entity menu:

model

Yes, that's it. The chicken model will of course not apply to your entity, since that is retrieved from your model procedure. To change how long your entity stays dead, you will need to change the length in the entity code, which is just as simple.

Just go to the bottom of the entity code and find the lines:

@Override
	protected void tickDeath() {
		++this.deathTime;
		if (this.deathTime == 20) {
			this.remove(YourEntity.RemovalReason.KILLED);
		}
	}

And change the number after this.deathTime ==. By default, it is set to 20, which is 1 second as that is what 20 ticks translate to.

 

v1.9 Update - Play animation procedure

It's finally here! You can now trigger any animation at any time using the brand new animation procedure. It really is as simple as it sounds!

new procedure

 

v2.2 Update - New and improved animation procedure

Well... my former implementation of the animation procedure was... less than ideal. In this update I decided to replace the animation procedure with a far better version.

To use this, you need to first replace the old procedure (which will be removed after a few updates), as it is only kept in the plugin so workspaces updating versions will not break.

Here is an example of the procedure being used. It is ideal to use scoreboard scores to trigger animations (if they don't work in your procedure), as there seems to still be issues which I cannot fix.

procedure

The entity name needs to be the name of the entity element, not the display name. The animation name will of course be the name you used for your animation in blockbench.

Update: It seems using immediate source entity instead of source entity will work. Use scoreboards if it doesn't.

 

v2.4 Update - Java model support & Translucent textures

You can now use Java models alongside GeckoLib models without locking the code. 

Also, GeckoLib entities now support translucent textures. Cool stuff. Not much to explain here.

 

V2.9 Update - Animated Block element

It is now possible to make animated blocks using the geckolib plugin through the use of a new element.

(As of right now, only forge 1.18.2 and 1.19.2 are supported due to the sheer amount of work it took to make this, the rest will be supported later)

 

First off, you need to make sure that java plugins are enabled, otherwise this feature will not exist.

java

Now, you will need to import the model the same way you did with your entity models, in the same directory path. The difference here is that you will need to set the model type in blockbench to block/item when making it.

model

And you will need to export your display settings too once you're done with them. This is very important.

settingexport

Now, just make the block. Settings can be whatever you like, and you write the model name on the first page where the texture is in the text field. Same way you did with the model procedure for entities, but there instead.

modelfield

Now you will need to import your display settings file. It will need to be named the registry name of your element .json. You can see your element registry name by clicking this button shown below.

registryname

Your display settings file needs to go in this folder shown down here.

directoruy

Well, that's it. Obviously GeckoLib must be enabled in workspace settings for any of this to work. Your animated block should now be there. The default animation should be named "idle". That is the animation that will always be playing. Other animations can be triggered using the new block animation procedure.

 

 

 

If you have not yet installed the plugin, you can find it here.

 

If you are updating versions and you get an error for the model or glow procedures, simply open them and the entity, save them, and finally regenerate the code. If that doesn't work for some reason, just remake the procedure. This issue can be caused due to the change in the code between versions 3.0 and 3.1 of GeckoLib.

 

If spawning your entity causes a crash, one of the below reasons is the cause:


-You used uppercase letters or spaces in the model name.
-You didn't create a GeckoLib model.
-You placed your files in the wrong location. Check that the geo and animations folders are in the assets/yourmod'sID folder.
-You didn't write the model name correctly in the procedure.
-You enabled the head animation, but there is no group in your model that is named "head"
-Your animation or model file name is incorrect. Check the valid names at the top of the tutorial.

If none of these are the issue, look through the replies to this post before asking for help. It is very likely that someone else had the same issue and the solution has been posted.

Edited by NerdyPuzzle on Mon, 11/21/2022 - 00:29
Last seen on 12:55, 3. Dec 2022
Joined Jul 2022
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
This plugin is not released…
Tue, 10/11/2022 - 14:12

This plugin is not released yet, you will have to wait for it to get approved!

Last seen on 22:12, 2. Dec 2022
Joined Jul 2020
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
I NEED THIS!! Do you know…
Tue, 10/11/2022 - 14:15

I NEED THIS!! Do you know how long it'll take to approve? and will it be on 1.18.2 Gen or only the new 1.19?

 

Last seen on 12:55, 3. Dec 2022
Joined Jul 2022
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
Should only take a couple of…
Tue, 10/11/2022 - 14:15

Should only take a couple of days. Both 1.18.2 and 1.19.2!

Last seen on 22:12, 2. Dec 2022
Joined Jul 2020
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
thank you so much !! you're…
Tue, 10/11/2022 - 14:19

thank you so much !! you're a life saver :))

Last seen on 12:55, 3. Dec 2022
Joined Jul 2022
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
Woah, seems like someone…
Tue, 10/11/2022 - 15:52

Woah, seems like someone noticed it and approved it sooner!

Last seen on 12:55, 3. Dec 2022
Joined Jul 2022
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
Replaced "spawn" animation…
Tue, 10/11/2022 - 21:03

Replaced "spawn" animation with "sneak" as the other caused problems. Not really anything to worry about since you can make it play when the entity is spawned by making it sneak and unsneak a few ticks later.

Last seen on 22:32, 20. Oct 2022
Joined Oct 2022
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
Hi! It doesn't work for me,…
Wed, 10/12/2022 - 01:58

Hi! It doesn't work for me, the model is there but no animations. I downloaded the 1.1 version but still not work (on a new workspace with the mob only)

Last seen on 12:55, 3. Dec 2022
Joined Jul 2022
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
Did you create the model and…
Wed, 10/12/2022 - 03:50

Did you create the model and the animations with the same name in blockbench? Renaming after exporting won't work.

Last seen on 12:55, 3. Dec 2022
Joined Jul 2022
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
And also name the animations…
Wed, 10/12/2022 - 03:51

And also name the animations with the names specified at the top

Last seen on 22:32, 20. Oct 2022
Joined Oct 2022
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
yep, same name in blockbench…
Wed, 10/12/2022 - 10:09

yep, same name in blockbench and correct name for animations

Last seen on 12:55, 3. Dec 2022
Joined Jul 2022
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
And you made all the…
Wed, 10/12/2022 - 10:41

And you made all the animations in one file right?

Last seen on 22:32, 20. Oct 2022
Joined Oct 2022
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
Yes
Wed, 10/12/2022 - 10:54

Yes

Last seen on 12:55, 3. Dec 2022
Joined Jul 2022
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • Tracker tickets:
  • MCreator plugins:
  • Comments:
Can you send me a download…
Wed, 10/12/2022 - 11:05

Can you send me a download link for your animation file?