"Ever wanted to make a gun in MCreator but ended up lost in a sea of complex procedures? Worry not! My plugin is here to save you from endless tinkering. It adds everything you need to craft firearms in a simple, clean, and almost fun way. Each action can be managed with logic so intuitive, you'll wonder why it didn’t exist already. No, it’s not magic. It’s just a well-made plugin."
WARNING: you need to enable the Java plugin.
This plugin adds a set of procedures designed to simplify the creation of firearms in MCreator, allowing you to control key actions such as firing, reloading, animations, and more.
It is also compatible with the Nerdy's Geckolib plugin, adding specific procedures to manage object animations more easily and efficiently.
Below, you'll find a complete tutorial that explains everything step-by-step.
Tutorial by hacker_E303
The plugin is currently under development, so feedback and suggestions are very welcome. If you encounter any issues, feel free to leave a comment!
Changelog:
1.9.8 - Fully compatible with MCreator!
1.9.7 - Fixed minor bugs;
1.9.6 - Added support for MCreator 2025.3 & MCreator 2025.3, NeoForge 1.21.4;
1.9.5 - Fixed Gun Maker Setup element not working on MCreator 2025+;
1.9.4 - Fixed lot of bugs & improved procedures; Forge, NeoForge, Fabric 1.20.1 & NeoForge 1.21.1; Should also work with NeoForge 1.20.4 & 1.20.6;
1.9.3 - Changed some procedures; Fixed some bugs; Only Forge & Fabric 1.20.1; Preparing the tutorial...
1.9.2 - Fixed minor bugs;
1.9.1 - Reworked the Fabric and Neoforge 1.20.1 versions; Fixed minor bugs; Gun Maker Setup element is now usable with all the loaders;
1.9.0 - WARNING, forge 1.20.1 only for now; Added new Gun Maker Setup element; Changed all gun related procedures; Changed the way logic is handled; More stable, configurable compact logic; Removed global event 'No swing animation'; Fixed minor and major bugs;
1.8.1 - Fixed minor bugs
1.8.0 - Added client-side procedure "Zoom with intensity <float>"; Fixed some bugs
1.7.0 - Added three procedures for aiming and recoil; Fixed minor bugs
1.6.0 - Added new AI goals for Forge 1.20.1
1.5.2 - Fixed minor bugs; Improved the gun procedures toolbox
1.5.1 - Added "Get entity <entity> is looking with <double> of check distance" procedure block
1.5.0 - Fixed broken global event; Added two new procedures "Has <entity> direct visual contact with <other_entity>" and "Can <entiy> reach <x> <y> <z>"; Fixed broken procedure; Improved some procedures; Added support for MCreator 2025.3; Fixed minor bugs
1.4.4 - Fixed NeoForge 1.21.4 broken procedures
1.4.3 - Now compatible with all MCreator versions; Fixed minor bugs
1.4.2 - Alpha version for forge 1.20.1; Fixed minor bugs; Added "Get max ammo of <item>" procedure block
1.4.1 - Fixed minor bugs
1.4.0 - Fixed minor bugs; Added two events; Added four procedures;
1.3.2 - Fixed minor bugs
1.3.1 - Added "Reload <item> of <entity> that has <number> max-ammo with <magazine> and set recovery-time (in ticks) to <number> durability to <logic> and reload multiplier to <multiplier>" procedure block; Added notification system
1.3.0 - Added "With geo-item <item> set query <string> to <int> for controller <controller>" procedure block
1.2.2 - Forge, Fabric and NeoForge; Added new languages; Added "Is keyboard key <char> pressed" procedure block
1.2.1 - Only Forge; Added "Make <entity/target> attack entities tagged as <string> with priority <int>" procedure block; Added "Get owner of <entity/target> projectile" procedure block
1.2.0 - Working on...
1.1.0 - Fixed bugs and broken procedures; Added "If <condition> allow <itemStack> to shoot" procedure block
1.0.1 - Added compatibility with Fabric and NeoForge
1.0.0 - Plugin was created
Comments
I am already aware of the vertical gun movement during firing, and a fix is currently in progress. However, I am not completely clear on the other issue you mentioned. Please join my Discord server, where you can open a ticket and explain the problem in detail (and attach relevant images)
I get this error when I try to use the zoom procedure. How can I fix this:
(path)error: incompatible types: float cannot be converted to Integer
Minecraft.getInstance().options.fov().set(2f);
^
Note: Some messages have been simplified; recompile with -Xdiags:verbose to get full output
1 error
FAILURE: Build failed with an exception.
* What went wrong:
Execution failed for task ':compileJava'.
> Compilation failed; see the compiler output below.
Note: SpongePowered MIXIN Annotation Processor Version=0.8.5
1 error
* Try:
> Run with --scan to generate a Build Scan (powered by Develocity).

hey, I'm having some issues with the plugin.
Weapons in hand are jittery and constantly move up an down
Issues with animations.
I'm trying to use animations without using geckolib and geo models. What i have right now is
Return logic: is provided itemstack shooting
and same for reloading.
It works sometimes, and its very odd, though i am still tweaking with it.
And if i need geckolib, and or geo whatever, may i ask how i implement geo animations with my models? like create them?