(OUTDATED) Feder's Geckolib Plugin Tutorial - Custom Animated Mobs

Started by Argus Obsidian on

Topic category: User side tutorials

Last seen on 16:47, 29. Oct 2023
Joined Jun 2020
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
(OUTDATED) Feder's Geckolib Plugin Tutorial - Custom Animated Mobs
Wed, 06/14/2023 - 19:19 (edited)

NEWS

There are a lot of people asking about what versions of MCreator and Minecraft this is for. To check that, please look at the Troubleshooting and Notes section at the bottom of this tutorial!

All loading problems were fixed, you can now use the Export tab under "File" to export your model!

 

Edit 1: Bad news, I just talked to the developer for Geckolib and they no longer support MCreator or .java models. It only supports bedrock models, and similar. Until further notice, this entire tutorial is outdated and will not work.

Edit 2: There is some news I have to share. I talked with Gecko recently, and I was told he will be making an official MCreator plugin sometime. There is no planned date, but we will have official support for MCreator from the author. Sadly, there is no temporary solution, unless someone managed to create an archive of the 2.0.0 Geckolib plugin. If you did, please contact me a soon as possible!

Edit 3: An archive has been found! You can now download the old Blockbench plugin, load it, and use this old tutorial to continue using it's features! Download link below in the Blockbench installation section.

Edit 4: Successful tests were completed! It was tested by myself and a few others on multiple different operating systems, and we were all able to spawn mobs with animations :D There is also no requirement to change code by hand, making it incredibly user friendly.

 

Tutorial

This tutorial will teach you how to use the amazing and much awaited Geckolib plugin! For those of you who don't know, Feder's Geckolib plugin is an MCreator add-on that allows users to create custom animations for modded mobs. This guide will walk you through the steps for installation and some info on how to use it, but will not teach you how to create animations. In the examples I will use a custom zombie model and animations I made.

Check - Before we begin, please look at the "Notes" section below for important information.

Installation

Blockbench

The first thing you will need to install is Blockbench. Blockbench is a 3D modeling program aimed towards blockier, Minecraft-style creations, and it is completely free. Without Blockbench, you will not be able to use this plugin, and I'll explain why in a bit. To install Blockbench, simply download the latest release from here and follow the installation wizard. To get the max performance out of the old plugin, download the 3.6.6 release from here, and install it normally. (You can have multiple versions of Blockbench installed, no un-installation required!)

But you aren't ready to create animations yet! First, you need to install the GeckoLib plugin to Blockbench. To do this, open up Blockbench to the startup page. From there, navigate to Filter -> Plugins. This will open up a menu labeling all your installed and available plugins. Click on the "available" tab and scroll down until you see the GeckoLib Animation Utils option. Hit install, and you're ready to animate! (This method is outdated, download the plugin from the link below)

To load the old Geckolib plugin, download it from here. Make sure you don't rename it! Next, go to the plugin menu in Blockbench, hit "Load plugin from file." Select the file from where you downloaded it to and and click "open". Accept the confirmation message and the plugin should be installed!

If you want to learn about animating Java models with this plugin, I suggest this YouTube video by TurtyWurty. It explains everything you need to know in depth. This video is made for animating Bedrock only models, but the UI looks same for animated Java models after you install the plugin.

Load Plugin, Create New File

 

MCreator

This section will teach you how to install the plugin to MCreator. First, go to this page for the latest download, or this one for a direct download to the current one. Once downloaded, make sure it's in zip file format, and save it to wherever you want! Alright, now you can open up MCreator. Open the workspace you want to add the plugin to first. Then, navigate to File -> Preferences -> Manage Plugins. Here, you should click the "Load plugin..." button. Navigate to where you saved the downloaded zip, and select it. Hit "Save" and let it load.

Now that you have installed the plugin, you will need to activate it. Navigate to Workspace -> Workspace Settings - > External APIs. Here, you will see a checkbox labeled "GeckoLib API". check it and hit "save changes." That's it, you've installed the plugin!

Note: if there were any elements in your workspace prior to adding the plugin, you will be prompted to refactor the workspace. Simply hit "Yes, refactor workspace" and let MCreator handle the rest!

Download and Load Plugin

Usage

Exporting From Blockbench

Let's say you finished an animation in Blockbench, but you have no clue how to export it! First, in Blockbench, you will need to save the files. GeckoLib stores it's animations in 2 files: a .java file that stores the 3D model, and a .json file that stores all the animations. Before exporting them, we need to complete one important change. Go to File -> Project... and scroll down to an input box labeled "Model Identifier:" This is the name that your game will use to reference your model, so we can't leave it blank! The easiest solution is to name it the same as your mob, such as "blue_bird" or "big_boar_variant_1." There are some small naming rules you must follow:

1. Do all lowercase letters. This will make loading the mob easier later.

2. No whitespace or special characters. Use an underscore instead of spaces, and never use symbols that aren't alphanumeric.

3. Numbers are allowed, but the name cannot start with a number. Examples: Correct: "red_chest", "one_sign"    Wrong: "1_dash", "235_variant_mob", "23bob".

Once done naming, hit confirm and the file should be ready for exporting!

To export the files, you'll need to start with the .java file. Navigate to File -> Export -> Export Animated Java Entity and a prompt window will appear. Name the file whatever you need, and save it to a directory of your choice.

Next, to export the .json file, you'll need to be in the animation tab. From there, navigate to Animation -> Export Animations and save the file to whatever name you want.

(Note: Hitting CMD/CTRL + S will save both files automatically.)

Save Model and Animations

 

Importing to MCreator

This is a bit harder than exporting. First, let's import the .java file. In your workspace, go to Resources -> 3D models and texture mappings. Hit the "Import JAVA model" button and select your .java file. Click the "Keep current animations" button, and the file should import correctly!

Now we need to import the animations. This requires a bit more effort. In MCreator in the workspace, go to Workspace -> Open workspace folder. This should open a file explorer with wherever on your computer your MCreator workspace is stored. From here, navigate to src/main/resources/assets/<name_of_your_mod>/ and create a new folder called "animations" (minus the parentheses). Now, whenever you create a new animation .json file, just put it in that folder. That's all!

Image

Using Your Animations

 Now that you've installed everything and created an animated entity, you want to figure out how to use those animations. Geckolib allows you to set the animation of any mob using procedures. Simply use the "Play Animation" procedure block by entering the desired entity, animation name, and looping condition, and your mobs will now be animated!

Image

Troubleshooting

I'll cover some common issues and mistakes people make when using this tutorial:

1. Correct version for all downloads. Make sure that you download all the right versions for the software listed here. Other versions may not be compatible with each other and might lead to crashes. Here is a list of the correct versions:

2. Not giving your model a model identifier. This is important for keeping track of models, especially when you plan to add more than one. The steps to do this are covered in Usage -> Exporting From Blockbench in the above tutorial.

3. Trying to mod in the wrong version. The Geckolib Animation MCreator Plugin currently only supports 1.15.2 modding, no other versions can use this tool.

4. Using the wrong animation name when trying to play animations. When animating in Blockbench, make sure that you copy paste the exact name that you used for the animation you want into MCreator, and not the animation file name. Many people try to use the name of the animations.json file, but this file contains a list of all animations for the mob. You have to use the names of the animation, and not the name of the file.

 

Notes:

This plugin will only work with MCreator 2020.5. It does not work with the latest, as of the time of edit for this post (12/9/2020 4:49pm EST)

The Geckolib plugin also does not work with the latest Blockbench release as of this edit (same date as above), it requires Blockbench 3.6.6

IMPORTANT! - Although 2020.5 has been released, there is an issue with loading the plugin! This means that it is not available to use until the author updates it! Thank you for your patience. - After testing, the plugin should work with MCreator now. I plan on making a video tutorial in the future and linking it here, so stay tuned!

Contact:

IMPORTANT! Do not contact me unless you are sure that your question cannot be answered by the post or by a previous comment. If you have an important question though, feel free. My discord is [revoked], so message me if you need help or clarification. I will respond as fast as I can!

Regarding the above message, I have decided to stop answering questions since I have become very busy lately. Sorry for any inconveniences.

Changes:

Added and fixed images - 9/23/2020

Fixed the errors in the current plugin and changed the download link - 1/4/2021

Added toubleshooting section after lots of similar problems - 2/13/2021

 

If you guys have any questions or suggestions to add or remove from this tutorial, feel free to post them below!

Edited by Argus Obsidian on Wed, 06/14/2023 - 19:19
Last seen on 01:56, 16. Jan 2024
Joined Mar 2019
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
Well hello there ! The day…
Tue, 11/17/2020 - 22:28

Well hello there ! The day has come : 2020.5 is out , but I was wondering, will the plugin work ""perfectly"" if I download it onto the 2020.5, or should I wait for an updated version that is compatible ?

I'll wait for your advice, until then i'll test what this beautiful version has for us.

Thanks in advance,

- That lil' annoying person (ew, that was cringe) : LEPRODOR ~ :P

Last seen on 01:56, 16. Jan 2024
Joined Mar 2019
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
uh whoops, forgot to mention…
Tue, 11/17/2020 - 22:30

uh whoops, forgot to mention : I know , i saw the "This plugin will only work with 2020.5 and above" but i saw in the plugin's page 
something around "current supported version : 2020.5.39514"

still wasn't sure because of that one.

Last seen on 00:53, 10. Oct 2023
Joined Jun 2019
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
I think that is the snapshot…
Wed, 11/18/2020 - 01:17

I think that is the snapshot. You should be able to use Geckolib right now.

Last seen on 19:56, 31. Oct 2022
Joined Oct 2016
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
I can't install it on…
Fri, 11/20/2020 - 15:29

I can't install it on Blockbench, due to the plugin being outdated

Last seen on 22:49, 17. Mar 2021
Joined Jan 2020
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
Geckolib Java entities are…
Wed, 12/02/2020 - 17:48

Geckolib Java entities are now outdated, and Geckolib encourages the use of using Bedrock entity models instead, will this plugin be updated for that?

Last seen on 06:40, 23. Mar 2024
Joined Feb 2020
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
What version of Blockbench…
Sun, 12/06/2020 - 18:36

What version of Blockbench do I need to work?

Last seen on 16:47, 29. Oct 2023
Joined Jun 2020
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
There have recently been a…
Wed, 12/09/2020 - 21:52

There have recently been a lot of new questions, claims, and ideas in this thread and I decided to cover them all by editing the forum post. The tutorial is now working entirely, and it is possible to animate and spawn mods without crashes now. There were some errors that I overlooked in the original, but with the help of this great community, I was able to work them out and get a working mob spawned. Feel free to comment here about any ideas and thoughts you may have, but please ask questions at my discord: Argus#2498. Thanks everyone!

Last seen on 18:09, 11. Mar 2022
Joined Jun 2020
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
Neither 1.0 nor 1.0.1…
Fri, 12/11/2020 - 10:14

Neither 1.0 nor 1.0.1 version of Geckolib plugin can't be installed to the new 2020.5 version of MCreator properly. It says the plugin is loaded, however there is no checkbox to turn Geckolib on in workspace settings - the model can't be loaded to resources getting the statement "This model needs Geckolib library...", shame.

Last seen on 19:30, 8. Feb 2023
Joined Jan 2016
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
I will try this weekend to…
Tue, 12/15/2020 - 03:37

I will try this weekend to see if it works 

Last seen on 14:43, 2. Aug 2022
Joined Nov 2018
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
You can't use this anymore…
Tue, 12/15/2020 - 08:52

You can't use this anymore as the Blockbench plugin creator has pandered to Bedrock edition.

Last seen on 15:44, 1. Apr 2023
Joined Jan 2018
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
I have a problem, the option…
Thu, 12/17/2020 - 00:44

I have a problem, the option "Export Animated Java Entity" does not appear. It only gives me the option to "Export Geckolib Model". I have the latest version of Blockbench and Mcreator, what do I do?

Last seen on 23:56, 6. Feb 2021
Joined Oct 2020
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
So awesome, you make this…
Sat, 12/19/2020 - 14:58

So awesome, you make this world a better place!

Last seen on 23:56, 6. Feb 2021
Joined Oct 2020
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
Installing the plugin in…
Sat, 12/19/2020 - 17:02

Installing the plugin in Mcreator the option to select GeckLab in the workspace wasn't there until i restarted Mcreator. That's all you have to do to make it appear

Last seen on 14:43, 2. Aug 2022
Joined Nov 2018
Points:

User statistics:

  • Modifications:
  • Forum topics:
  • Wiki pages:
  • MCreator plugins:
  • Comments:
If you have the original…
Sun, 12/20/2020 - 21:39

If you have the original Blockbench plugin file this problem can be fixed.