MCreator 2021.3 - Full Minecraft 1.17.x support

Published by Klemen on Tue, 12/14/2021 - 16:24
MCreator 2021.3 - Full Minecraft 1.17.x support

MCreator 2021.3 is here. The first release that fully and officially supports Minecraft 1.17.x. We didn't forget to add some new features too. Read on!

Minecraft 1.17.x support

The biggest change in this release is full and official Minecraft 1.17.x support for Java and Bedrock edition. The generated code for 1.17.1 Forge mods is now also much more cleaner, with a unified registry design and improved procedure code. The code was never that human-like as it is now.

Full Minecraft 1.17.1 support for making mods

Real-time code preview

Another big new feature is real-time code preview. Now with a single click, you can enable a preview that will show you code changes as you edit the mod element and highlight the lines that were affected by the UI change the user did.

Realtime generated Minecraft mod code preview

New procedure blocks

This update added quite some new procedure blocks. Below you can see the new "Time and date" procedures category that allows you to make procedures depend on the current date, eg. below, the player will be greeted with a custom message on Christmas when joining the world.

Day and time procedure blocks

Some new direction procedures were added too. You can now iterate all directions or all horizontal directions to more efficiently scan neighboring blocks, for example.

New direction procedures

A new ternary operator procedure block was added that allows users to shorten some of the procedure compositions.

Ternary operator in MCreator

More biome structures

Quite some new vanilla biome structures were added, making it possible to improve your biome's terrain variety with vanilla-based structures.

More vanilla Minecraft structures in MCreator biome mod element

Better element selectors

We have improved quite some UI components and selectors that now try to be more helpful and visual. One of such places are block lists as shown on the video below.

Improved element selector previews in MCreator

Release notes

  • Java entity models before 1.17 are not compatible with 1.17 and vice versa. Two separate instances with the same name need to be imported, one for an older generator and one in 1.17 generators and MCreator will pick the right version depending on the current generator
  • Custom wall blocks now need to be tagged in the walls vanilla blocks tag group to make them connect with other wall types
  • [Plugins] Generators can now use global templates for each mod element type
  • [Plugins] Generators can now use common definition files for different base types
  • [Plugins] Generators no longer need to define partial support for mod elements as MCreator automatically detects coverage support using excludes/includes parameters.
  • [Plugins] Variables and procedure categories can now use hex color codes
  • [Plugins] Plugins can now register custom Blockly JavaScript files
  • [Plugins] Plugins now fully support custom data lists

Important bug fixes

Many bugs were fixed in this update. All the bug fixes are listed in the list below, but more notable bug fixes are:

  • [Bugfix] Water entities moved very slowly

Other improvements

The article would be too long if we described all the changes and bug fixes in-depth, so you can see the full list in the full changelog of this release here (some important features that were not mentioned previously are highlighted with bold text):

  • Updated bundled Java to version OpenJDK 16
  • Added base support for Minecraft Forge 1.17.1
  • Added Minecraft add-on generator for 1.17.x
  • Added Minecraft data pack generator for 1.17.x
  • [FG 1.17.1] Added support for mod elements: advancement, fuel, command, overlay, food, painting, procedure, tag, function, dimension, loot table, recipe, music disc, key binding, potion effect, potion item, GUI, armor, particle, structure, block, plant, biome, custom element, fluid, item, enchantment, game rule, tool, ranged item, living entity, and creative tab
  • Added ternary operator procedure block
  • Plant suspicious stew parameter now supports custom potions
  • Added date and time-related procedure blocks
  • Improved element list selector fields and windows
  • Improved code generator performance and generated code
  • Improved code formatted and import formatter
  • Added option to see real-time code changes while working with mod elements in UI
  • Added missing vanilla structure options to custom biome mod element
  • Added new procedure blocks: for each direction, for each horizontal direction, direction iterator, and random iterator
  • Added option to disable automatic ticking of custom blocks and fluids
  • Improved procedure block sorting inside procedure editor categories
  • [Bugfix] Cave and canyon carvers did not carve through the last surface layers in custom dimensions
  • [Bugfix] Procedures could crash the game in cases where dependency was unknown
  • [Bugfix] Water entities moved very slowly
  • [Bugfix] Living entity arrow immunity did not work with certain arrow types
  • [Bugfix] Some other minor fixes and improvements

But Minecraft 1.18 is here!

Yes, we know :D But we almost completely rewrote the code generator for Minecraft 1.17 and that took a lot of time. We would actually want to thank all donators and contributors that helped us bring this release to life. We have already started working on 1.18.x support too so stay tuned. While we work on 1.18, you can develop your mods for 1.17.1 and then later switch to 1.18 with just a few clicks!

Tell us what you think about the update in the comments! If you like what we do, consider donating to help us keep this project up.

UPDATE 1: We have released a patch update to fix some bugs found in the 2021.3 release:


  • [Bugfix, 1.17.x] End and nether-like dimensions inverted imitate overworld behavior setting
  • [Bugfix, 1.17.x] Custom end-like dimensions had bedrock roof and floor
  • [Bugfix] Biome dictionary list in biome mod element editor was empty
  • [Bugfix] Some other minor fixes and improvements

To install the patch, re-download 2021.3 and install it again. Make sure to uninstall the current version first.

UPDATE 2: We have released a patch update to fix some more bugs found in the 2021.3 release:


  • [Bugfix] Changing custom item inventory size could crash existing world saves
  • [Bugfix] Big spruce trees in custom biomes could cause the game to crash
  • [Bugfix] Some procedure templates using text variable procedure blocks failed to import properly
  • [Bugfix] Some other minor fixes and improvements

To install the patch, re-download 2021.3 and install it again. Make sure to uninstall the current version first.

UPDATE 3: We have released a patch update to fix some more bugs found in the 2021.3 release:


  • [Bugfix, FG 1.17.1] GUI labels have a shadow that was not there in previous versions
  • [Bugfix] Some older workspace completely fail to open

To install the patch, re-download 2021.3 and install it again. Make sure to uninstall the current version first.

Share this on:


No need to comment on this update... because no word can describe the work, the efforts and the time we spent on it. Make a place to 1.18.1 now!

Much appreciation towards all people working on this MCR version, thank you for delivering us all so great updates and for whole effort put into it ^^

I really appreciate that you guys put in a lot of effort in this. It's so AMAZING! The amount of hard work and complex coding is indescribably HUGE and even unimaginable. Well done, Kumpels! Keep it up!

This is just so wonderful, I have a little question. Are the time triggers related to in game Minecraft time or your device's clock? If it's not related to Minecraft's in game time. Is there any chance that It could be added? Thank you for bringing up this update anyways. You're doing a great job!

Donate to MCreator

By donating to developers you can speed up development, as with more resources, we can dedicate more time to MCreator. It is a free project made by developers working on it in their free time.