Custom Guns

Name: Custom Guns
Author: Vanderflys

Custom Guns lets a server owner define new guns and throwables through a datapack, with stats set by ordinary commands in the chat menu.

FabricForgeNeoForgeQuiltServer required, client optionalAll rights reserved1.20.2 – 26.3

What it does

Guns are built from datapack files, so a server can add weapons without writing Java. Each gun is made with a straightforward command setup, and anyone with operator permission can create one or change its settings. Players only need permission to use the guns, not to edit them. Throwables such as grenades are supported, and guns work both with and without a resource pack.

The mod is released for Fabric, Forge, NeoForge and Quilt, in a range that covers 1.20.2 – 26.3 with 19 release versions and snapshot builds published. The latest file for every loader is v2.3.0+mod for 26.3, dated 2026-09-17. The server must run it, while players may leave it out. Custom Guns is also available as a data pack for server platforms. All rights reserved; the code is not open source. The mod depends on no other mods.

Key features

Datapack-based guns
New guns are defined in datapack files, so custom weapons need no compiled code.
Chat menu settings
Gun settings can be changed through the chat menu, after a reload command.
Throwable weapons
Functional throwables such as grenades can be created alongside standard guns.
Integration with the world
Guns interact with the surrounding world, so their effects are not limited to the weapon itself.

Compatibility

Latest build for each game version and loader.

Version

26.x5 of 5 versions with builds

26.3v2.3.0+modv2.3.0+modv2.3.0+modv2.3.0+mod

26.2v2.3.0+modv2.3.0+modv2.3.0+modv2.3.0+mod

26.1.2v2.3.0+modv2.3.0+modv2.3.0+modv2.3.0+mod

26.1.1v2.3.0+modv2.3.0+modv2.3.0+modv2.3.0+mod

26.1v2.3.0+modv2.3.0+modv2.3.0+modv2.3.0+mod

1.21.x11 of 11 versions with builds

1.21.11v2.3.0+modv2.3.0+modv2.3.0+modv2.3.0+mod

1.21.10v2.3.0+modv2.3.0+modv2.3.0+modv2.3.0+mod

1.21.9v2.3.0+modv2.3.0+modv2.3.0+modv2.3.0+mod

1.21.8v2.2.8+modv2.2.8+modv2.2.8+modv2.2.8+mod

1.21.7v2.2.8+modv2.2.8+modv2.2.8+modv2.2.8+mod

1.21.6v2.2.8+modv2.2.8+modv2.2.8+modv2.2.8+mod

1.21.5v2.2.5+modv2.2.5+modv2.2.5+modv2.2.5+mod

1.21.3v2.1.4+modv2.1.4+modv2.1.4+modv2.1.4+mod

1.21.2v2.1.4+modv2.1.4+modv2.1.4+modv2.1.4+mod

1.21.1v2.2.2+modv2.2.2+modv2.2.2+modv2.2.2+mod

1.21v2.2.2+modv2.2.2+modv2.2.2+modv2.2.2+mod

1.20.x2 of 2 versions with builds

ReleaseBetaAlphaNot available

This mod also publishes snapshot builds. Snapshots are not shown in the matrix.

Use cases

Server weapon packs

Operators can build a set of weapons for a multiplayer server and tune each one's stats with commands.

Single-player experiments

A single-player world can enable commands and test new guns before adding them anywhere else.

Who it’s for: Server owners and datapack authors who want custom firearms without writing Java. Players on a server running the mod can use the guns without permission to edit them.

How it compares

Full comparison

Modern Guns is server-side with a client optional environment, but it is licensed under Creative Commons Attribution Non Commercial No Derivatives 4.0 and covers 1.20.4 – 26.2. Gun Core also runs server-side and is not open source, under a custom license, for 1.21.4 – 26.2. Custom Guns uses All rights reserved and is built on datapack commands rather than mod code.

Mod	Loaders	Game versions	Environment	Updated
Custom Guns	Fabric, Forge, NeoForge and Quilt	1.20.2 – 26.3	Server required, client optional	2026-09-17
Modern Guns	Fabric, Forge, NeoForge and Quilt	1.20.4 – 26.2	Server required, client optional	2026-07-03
Gun Core	Fabric, Forge, NeoForge and Quilt	1.21.4 – 26.2	Server required, client optional	2026-07-03