Back to mods
Custom Guns project artwork

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.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Custom Guns release matches 26.2?

Updated last month
Best match for your filters v2.3.0+mod
Game version 1.21.10, 1.21.11, 1.21.9
Loader Fabric, Forge, NeoForge

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.

Client Optional
Dedicated server Optional
Loader for this release Fabric, Forge, NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

No extra mods listed for this file

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.

  1. 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.

  2. 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.

  3. 03

    Put it on the correct side

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 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?

Header

Modrinth

Discord

Website


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

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.

95 available setups

Showing 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

2 of 40 releases match
Clear filters

Looking for an older file? The official Modrinth project page is in Resources.