Custom Guns

📖 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_stats