Installing MrCrayfish's Gun Mod on Minecraft Servers

Overview

Vanilla Minecraft keeps combat fairly simple. Swords, axes, bows, and crossbows do the job, but they are not exactly a modern loadout. MrCrayfish's Gun Mod changes that by adding craftable pistols, rifles, shotguns, heavy weapons, throwable items, ammunition, attachments, and more.

The mod runs on Forge for multiple Minecraft versions and works well for PvP servers, survival worlds with a modern combat theme, or anyone who wants creepers to learn about ballistics. This guide explains how to download the mod, install it on your client and server, use its main features, and fix the most common issues.

Downloading MrCrayfish's Gun Mod

1. Open the MrCrayfish's Gun Mod page on CurseForge and select Files near the top.

1. Find the file that matches the Minecraft version and Forge version you plan to use.

1. Select the three-dot menu beside the file, then choose Download File.

1. Save the file somewhere easy to find, such as a dedicated mods folder on your desktop.

Forge 1.18 and newer also needs the Framework dependency. Forge 1.16 and older needs Obfuscate instead. Download the correct dependency the same way, because the gun mod will not load properly without it.

Installing the Mod on Your Client

Every player joining the server needs Forge installed in the Minecraft Launcher, using the same Minecraft version as the mod and server. After Forge is ready, add the mod files to your local installation.

1. Open the Minecraft Launcher and go to Installations.

1. Find your Forge profile and click the folder icon.

1. Open the mods folder. If it does not exist, create a folder named exactly mods.

1. Drag MrCrayfish's Gun Mod and its required dependency into that folder.

1. Return to the launcher, select the Forge profile, and press Play.

If Minecraft reaches the main menu without a crash, the client side is usually ready.

Installing the Mod on a Server

The server must also run Forge on the matching Minecraft version. In the HolyHosting control panel, choose the correct Forge server type and restart once so the server can generate its folders. Then upload the mod files.

1. Open your server panel and go to the file access or FTP area.

1. Log in with your panel credentials if prompted.

1. Open the server's mods directory, then choose Upload.

1. Upload MrCrayfish's Gun Mod and the correct dependency file.

1. Wait for the upload to finish, then restart the server.

The mod must be installed on both the server and each player's client. If one side has different files or versions, connection errors are likely.

Getting Started In-Game

After joining the server, gather iron, gunpowder, concrete, redstone, dyes, and other crafting materials. Most of the mod's progression starts with a workbench, which is used to assemble guns, ammunition, attachments, and utility items.

Installing JEI is strongly recommended, especially on larger modded servers. It makes recipes much easier to check, and it saves everyone from guessing how many iron ingots are needed for a weapon that looks expensive because it is.

Building a Gun Workbench

The Gun Workbench is the core crafting station for this mod. It requires 5 Iron Ingots and 3 Light Gray Concrete, making it affordable once players have done a little mining.

Place the workbench in your base to access its custom interface. It also has a detailed 3D model, so it looks fitting in an armory or workshop.

Right-click the workbench to open its menu. Instead of using normal crafting grid recipes, select the item you want and provide the listed materials. For example, a Heavy Rifle requires a large amount of iron and can be created with the Assemble button. You can also add dyes in the color slot to change a weapon's appearance.

Use the arrows and category tabs near the top of the interface to browse guns, ammunition, utility items, and attachments.

Weapon Types

MrCrayfish's Gun Mod includes 9 weapons by default: Pistol, Shotgun, Rifle, Grenade Launcher, Bazooka, Minigun, Assault Rifle, Machine Pistol, and Heavy Rifle.

Each weapon has its own model, recoil behavior, damage output, firing style, and attachment options. Many only need iron ingots, while heavier weapons can require extra materials such as redstone or dye. Try several weapons before deciding what fits your server's combat style.

Ammo and Utility Items

Weapons need the correct ammunition, so keep Bullets, Advanced Bullets, Shells, and Missiles stocked. These are also made at the Gun Workbench and often require materials such as Iron Nuggets, Gunpowder, Copper Ingots, or Gold Nuggets.

The mod also adds throwable utility items, including Grenades and Flashbangs. Hold right-click to prepare the throw, then release to use them. They are useful for PvP, mob clearing, or making a village meeting very brief.

Adding Attachments

Attachments let players tune weapons instead of relying only on the default stats. Hold a gun and press Z to open the attachment menu.

Available attachment types include scopes, silencers, grips, and stocks. Some improve recoil control, projectile spread, or aiming behavior, while others may add tradeoffs such as slower ADS speed. Test combinations before handing them out on a public server, since small stat changes can matter a lot in PvP.

Using Guns in Combat

Firing weapons triggers custom animations, recoil, and movement effects. Assault Rifles kick noticeably during sustained fire, while heavier weapons can be harder to control without the right setup.

Weapon durability represents how much ammunition remains in the current magazine. Watch it during fights so you do not run dry at the worst possible moment. If a weapon feels too unstable, add recoil-focused attachments or try a different gun type.

Enchanting Weapons

Guns can be placed in an Enchantment Table, giving them special effects similar to other Minecraft equipment. Possible enchantments include Quick Hands, Lightweight, and Puncturing. Quick Hands, for example, improves reload speed.

You still need experience levels and Lapis Lazuli to enchant a gun. This is a strong way to upgrade favorite weapons without changing the server's entire mod setup.

Mod Addons

Players who want more variety can install community-made addons for MrCrayfish's Gun Mod. These are not part of the base mod, but many add new weapons, models, or combat options.

Additional Guns is a common starting point if the default arsenal feels too small. When adding extra mods, check that every addon supports your Minecraft version, Forge version, and current gun mod version.

Configuration Files

Server owners can adjust gun behavior and other settings through the mod configuration files. Use your server panel's file manager or FTP access to edit them.

1. Open the file access area and log in.

1. Go to the config directory.

1. Find cgm-common.toml and select Edit.

1. Change the settings you need, then save the file.

1. Restart the server so the edits take effect.

There is also a world-specific config at /[world name]/serverconfig/cgm-server.toml. Changes there only affect that world. If you switch maps later, remember that those settings may not carry over.

Common Problems

If players cannot join, first confirm they are using the correct server address and port. Then check their launcher profile. They need Forge, the same Minecraft version, MrCrayfish's Gun Mod, and the correct dependency installed in their local mods folder.

If the server starts but the mod does not work, confirm Forge is selected as the server type and that all mod files are uploaded to the server's mods folder. Restart after making changes. If old files are causing conflicts, creating a fresh server profile can help isolate the problem.

If the server crashes on startup, check the dependency first. Use Framework for Forge 1.18 and newer, or Obfuscate for Forge 1.16 and older. Also review recent config edits for missing punctuation, invalid values, or broken TOML formatting. One small typo can stop the whole server from loading.

Useful References

• MrCrayfish's Gun Mod on CurseForge
• Installing Forge in the Minecraft Launcher
• Adding mods to a Minecraft server
• Becoming a Minecraft server operator