
Modrinth · Minecraft mod
Custom Guns
A 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.
Quick answer
Which Custom Guns release matches 26.2?
Custom Guns v2.3.0+mod targets 1.21.10, 1.21.11, 1.21.9 with Fabric, Forge, NeoForge. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.
Where it goes
Is Custom Guns required on the client, server, or both?
Installation on the client is optional. Installation on the dedicated server is optional.
The source marks this as usable on both the client and server.
What else does Custom Guns v2.3.0+mod need?
v2.3.0+mod on 26.2. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Custom Guns without breaking your instance.
Built for Custom Guns v2.3.0+mod on 26.2. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use v2.3.0+mod. It targets 1.21.10, 1.21.11, 1.21.9 with Fabric, Forge, NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
Installation on the client is optional. Installation on the dedicated server is optional.
- 04
Pick the file you checked
Use the “Get this file” button beside v2.3.0+mod. It opens that exact file at the source.
About this project
What does Custom Guns add?

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_stats
Project description from Modrinth.
Pick your setup
Custom Guns by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.2
5 loader builds26.1.2
5 loader builds26.1.1
5 loader builds26.1
5 loader builds24w14a
1 loader build1.21.11
5 loader builds1.21.10
5 loader builds1.21.9
5 loader builds1.21.8
5 loader builds1.21.7
5 loader builds1.21.6
5 loader buildsShowing the newest 12 of 27 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Custom Guns versions and loaders
v2.3.0+mod
customguns-v2.3.0.jar
7 Jul 2026
v2.3.0
Custom Guns v2.3.0 - 26.2.zip
7 Jul 2026
Looking for an older file? The official Modrinth project page is in Resources.