Custom Guns
ModA fully customizable datapack & mod for Minecraft 1.20.5+ that features custom guns that fully integrate with the surrounding world. Anyone can make their own gun with a straightforward command setup.
Type
Mod
Modrinth Downloads
79,200
Modrinth ID
qF3eqZ1A
Last Updated
Apr 27, 2026
Description

📖 Description
A fully customizable datapack for Minecraft 1.20.5+ that features custom guns that fully integrate with the surrounding world. You can create your own guns with custom stats and also use this with friends without having to install mods.
No resource pack required for it to work.
⭐ Features
• Functional and accurate guns with realistic names, movement, and recoil. • Functional throwables like grenades. • Works with and without resource packs. • 100% Multiplayer supported. • It is easy to change settings via the chat menu. • Create your own guns or use the ones that are already in the datapack.
🎗️ Compatibility

⚙️ Installation
After installing it, you may need to restart your world with /reload. To open the chat menu, use /reload again.
⚡️IMPORTANT REMINDER
You need permissions to use commands to install and configure the settings! This means that commands must be turned on in single-player and OP in multiplayer however, you do not need permission to use commands to use the guns, only to create them or to change the settings.
🛠️ Creation
For V2.1.0+
Hold the item that you want to convert into a gun in your mainhand and run this command:
/function guns:create {name:"AR-15",color:"blue",bullets:30,bullet_type:"medium",damage:9,headshot:20,cooldown:2,bloom:false,semi_auto:false,range:70,reload_time:40}Replace the stats with your desired stats.
Unsupported items for custom gun creation are: All types of firework, rods, armor pieces, buckets, bows, potions, (throwables), empty maps, spawn eggs, eggs, snowballs, tridents, axes (still strip logs when right clicked on them), ender pearls, debug stick, and ender eyes.
For V2
Hold the item that you want to convert into a gun in your mainhand and run this command:
/function guns:create {name:"AR-15",color:"blue",bullets:30,magazine:90,damage:9,headshot:20,cooldown:2,bloom:false,semi_auto:false,range:70,reload_time:40}Replace the stats with your desired stats.
For V1
To make your own guns, simply use this command in a command block since it is too long for the chat box.
/data modify storage guns create set value { Damage:20, Headshot:20, Bullets:3, Magazine:3, Bloom:0, Cooldown:30, Recoil:2.5, Range:300, Semi-Auto:true, ReloadTime:40, Name:"AWP", }After modifying the storage for your weapon run
/item modify entity @s weapon.mainhand main:change_statsCompatibility
Mod Loaders
Game Versions
Similar Mods
Black_dogs's Modding Library (BML)
A core library for my mods going forward
Rockhounding Mod: Rocks
Wide collection of rocks to obtain decorative blocks and building parts.
Flamingo, oh, oh, oh...
If you're multicoloured, that's cool too
IFPatcher
Patch some known bugs from Industrial Foregoing for 1.12.2 as it is officially EOL.
Vein Miner | Veinst
quickly mine entire veins of ores by breaking one block, which automatically breaks all connected blocks of the same typ...
TaCZ x Guns Lights Addon [NEW]
An easy addition to the game is dynamic gunshot flashes and bullet lighting effects.