MCreator release notes


On this page, you can find release notes for some versions of MCreator. You can find downloads of older versions on all downloads. Through time, server protocols, installation procedures, and many other elements of MCreator changed so there can be some differences between versions. You can find these notes on this page.


  • 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


  • Custom blocks using log rotation in existing world saves may change placement direction
  • Changed custom code mod element default template
  • Registry names of some blocks may change, reverting translations, structures, and existing world saves
  • [Plugins] Plugins can now add new local variable types
  • [Plugins] Generator plugins can now specify UI field exclusions or inclusions
  • [Plugins] Plugins can now specify update check URL
  • [Plugins] Plugins can now add new entity model animations
  • [Plugins] Plugins can now add custom themes
  • [Plugins] Plugins can now add new global variable types


  • Dimension ID and dimension comparison procedures may need to be redone in some cases
  • Block, dimension portal, and plant elements now specify the light value in the range from 0-15. Existing workspaces will be upgraded automatically.
  • Sand patches per chunk parameter may need to be redefined in custom biome mod elements
  • [FG 1.16.5] Custom biome underground and ground blocks need forge:dirt Blocks tag for custom trees to generate
  • [Plugins] Procedure block statement inputs can now declare incompatibility with local variables
  • [Plugins] Procedure blocks can now declare incompatibility with statement blocks


  • Existing images in custom GUIs will not draw proper bounding box in the GUI editor previews and should be re-imported from the original image when possible
  • [Plugins] Failure to properly generate the Freemarker template of procedure block will now cause the whole procedure code generation to fail
  • [Plugins] Added Blockly shadow block support for optional inputs
  • [Plugins] Added Blockly statement input with optional dependency contexts support


  • Existing custom biomes might need to have custom colors cleared to use default colors
  • Global variables are now only synced from server-side to client-side and not the other way around to prevent malicious forging of data by sending packets with altered data from client-side to server-side
  • Overlay and particle spawning conditions need to be redefined using the new condition system
  • [Plugins] Data lists (eg. block and items list) can now be extended (eg. with elements from other mods), using plugins
  • [Plugins] Plugins can now add texture maker, animation maker, procedure, and AI task templates
  • [Plugins] Added option to define custom APIs, libraries, and support mods similar to how MCreator Link is implemented (APIs get automatically installed when enabled) and make procedures, triggers and AI tasks that require specific API enabled to work


  • Workspace resources (textures, structures, and sounds) are now stored in Gradle resources folder only (folders <workspace dir>/sounds, <workspace dir>/textures, <workspace dir>/structures can be removed from the workspace; before opening older workspaces, it is recommended to regenerate the code in the old version before opening it in the new one)
  • Dropped Minecraft 1.12.2 generator support
  • Mod element camel-case name is now automatically converted to snake-cased registry name
  • "On collided with the player" and "on right-clicked on living entity" triggers now have source and target entity swapped
  • Custom tools of type multi-tool now have harvest level
  • [Code only] Custom GUIs now use IItemHandler instead of IInventory
  • [Code only] Main mod file naming scheme changed for compatibility reasons


  • [Code only] All mod elements with locked code (including main mod files) will have to be redone due to massive change in the project structure, existing locked files will be removed on the code regeneration process
  • Blocks are now bound to a custom GUI instead of GUIs being bound to blocks
  • Minecraft 1.12.2 is now marked as a deprecated version


  • Minecraft 1.12.2 is not a legacy version, and 1.14.4 is the next LTS version to follow the Minecraft Forge's LTS versions
  • Any advancement can now be triggered by procedures: existing procedure blocks need to have advancements re-selected
  • Attack damage parameter is no longer offset so existing values need to be corrected (see #55543)


  • Switch dimension procedure block now has a dropdown of dimensions: existing procedure blocks of this type need target dimension reselected

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.