ModularShoot
by Yanbwe
ModularShoot is a NeoForge library for building guns from attribute-driven parts, with sockets, plugins and data-pack registrations that extend the shooting system.
What it does
Guns in ModularShoot are assembled from modular parts, and their stats are bound to vanilla attributes, so attribute modifiers from the player and from equipment change how a gun behaves. Applying a vanilla attribute modifier to a player's gun makes it stronger and can grant traits. Gun-boosting trinkets and gear are handled the same way, which keeps building them straightforward.
Most registrations are made through data packs and can be reloaded at any time, so numeric values and new features are adjusted without restarting the game. The mod provides a shooting system with a gun action key, a weighted pool of bullet variants that picks a random variant on each shot, a reload system, and unified interfaces for common extension patterns. It is a library mod, so it adds no standalone content and relies on other mods to build on it.
ModularShoot needs no other mod to run. It is published for NeoForge only, for 1.21.1, and the environment is client and server, so the server and every player need it. The code is released under the GNU General Public License v3.0 only and is open source. Catalog mods built on it include ModularShootAmmo, ModularRarity and ModularShoot: Panel.
Key features
Socket and plugin system
Sockets are typed and can be registered without limit. A plugin can fit several socket types, with tag-matching sockets, and mutual-exclusion groups with priorities settle conflicts between plugins.
Crowning existing items
A vanilla item or an item from another mod can be crowned as a gun or plugin, which adds the functionality while its original identity, crafting recipes and trinket slots stay as they were.
Dynamic gun textures
Gun and bullet textures support dynamic tinting and layering, and stacked plugins, including trinkets, add their own visual effects.
Hooks and events
A large set of hooks and events lets other mods react to shooting, plugin changes and gun stats.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Required by 3 mods
Use cases
Who it’s for: Pack makers and mod authors who want to add guns, plugins or socket-based gear to a NeoForge 1.21.1 game. Players who only want to play with finished content need a separate mod that requires ModularShoot.
Questions
Does ModularShoot need any other mod to run?
Do players and servers both need ModularShoot?
Can guns be changed without restarting the game?
Which mods depend on ModularShoot?
In the catalog
ModularShoot is one of 3,514 Library mods on ModsFinder, and one of 1,449 Library mods for NeoForge. 32,366 mods support Minecraft 1.21.1.
More from Yanbwe
Similar mods
What the author says
A framework mod that add an attribute-driven, modularly-assembled gun system. Its goal: a shooting system where numbers are easy to tweak and features are easy to extend.
Official listing
- Modrinth page
- modrinth.com/mod/modularshoot
- Owner
- Yanbwe
- Published
- 2026-08-07
- Updated on Modrinth
- 2026-08-28
- Facts verified
- 2026-10-15