Just Enough Guns New

A modern fork and unofficial port of the Forge 1.20.1 mod Just Enough Guns, bringing vanilla-styled firearms, hostile gunners, faction raids, vehicles, and late-game aerial threats to newer Minecraft versions.

Just Enough Guns New is based on the original Just Enough Guns project for Forge 1.20.1. This fork continues its Minecraft-friendly firearms, survival crafting, hostile gunners, raids, vehicles, and special equipment on modern Fabric and NeoForge versions. The current 1.8.2 builds add a four-chapter combat-career guide, SW-aligned vehicle controls and part damage, revised ADS/spread, magazine-mode notices and recipe rules, and combat/configuration fixes across all six maintained branches.

Documentation / Wiki

The detailed player and server guide is available in five languages. English is the reference language.

• Wiki index
• English · 简体中文 · 日本語
• Deutsch · Español

Screenshots

Highlights

• Broad firearm lineup: pistols, revolvers, rifles, SMGs, shotguns, machine guns, launchers, bows, flamethrower-style weapons, and special late-game guns.
• Survival progression: workbenches, ammo, magazines, attachments, skins, and repair items.
• Modern gun handling: left-click shooting, right-click aiming, magazine reloads, recoil, movement spread, dynamic crosshair expansion, hit markers, muzzle effects, and bullet trails.
• Animated gun inspection on the Y key for held animated guns.
• Extended magazine system: base, extended, and drum magazines for supported rifle, SMG, and shotgun reloads.
• Forge-style melee support: V-key gun melee, flashlight toggles, sword bayonet damage, and first-person melee or bayonet animations for animated guns.
• Walkürenritt vehicle warfare: assembled land vehicles, boats, aircraft, helicopters, fixed weapon platforms, vehicle inventories, repair tools, charging support, missiles, decoys, and dedicated vehicle HUDs.
• Special equipment: FPV drones with monitor control and kamikaze payload HUD, C4 (remote/detonator), claymore mines, C4 vest, C4 defuser, Javelin and Igla 9K38 lock-on launchers, smoke screens that deny missile locks, and vehicle missile lock frames with seek audio.
• Hostile gunner mobs: zombie-family, skeleton-family, piglin-family, pillager/vindicator, phantom, ghoul, and parched gunner variants, plus a configurable C4 vest bomber gunner variant.
• Faction encounters: patrols, faction omen flow, home-triggered raids, raid flares, boss bars, configurable raid waves, and faction-specific blueprint rewards.
• Terror Phantom content: rare sky threat, Bound Terror Phantom guardian variant, phantom gunner summons, configurable death explosions, and End Ship Armada structure encounters.
• Defensive gear: bulletproof helmets and vests, plus armored Joy Harness upgrades.
• Server configuration: tune gunners, raids, UI visibility, dynamic crosshair, hit feedback, Terror Phantom behavior, spread, explosions, vehicles, and other combat systems.

Latest Release Notes

Version 1.8.2 adds a four-chapter combat-career guide with legacy progress migration, SW-aligned vehicle controls and part damage, ADS/spread adjustments, and server magazine-mode notices with matching recipes. It also fixes delayed trigger release, anti-armor impacts, truck fall damage, and config-menu feedback.

Highlights

• Combat career — Four chapters with 72 visible nodes / 53 core objectives on 1.21.1 and 73 nodes / 54 objectives on 26.2 and 26.3, with legacy progress preserved silently.
• Vehicle warfare — SW-aligned controls, cameras, crew HUDs, enemy AI, component hitboxes, damage, repair, and collision behavior.
• Gun handling — revised ADS recoil and spread, tighter shotgun grouping, configurable hip-fire spread, and reliable trigger release under delayed synchronization.
• Magazine rules — a confirmed server-mode notice and recipes that follow the active magazine or direct-ammo mode.

Fixed

• Corrected anti-armor rocket damage and missile contact with unmounted targets.
• Corrected truck fall immunity and restored the player-skin Finger Gun inventory icon.
• Fixed config tooltip line breaks and guarded config-menu opening failures.
• Added remote vehicle smoothing on NeoForge; corrected vehicle scroll and crew HUD visibility on Fabric 1.21.1.

The dedicated-server monitor tooltip and gunner-growth configuration fixes from 1.8.1 remain included. The FPV drones, C4, mines, guided launchers, smoke denial, and kill-credit work from 1.8.0 remain available.

Full release notes: 1.8.2 changelog.

Supported Versions

Loader	Minecraft	Java	Mod Version	Required Dependencies
Fabric	1.21.1	Java 21	1.8.2	Fabric API, GeckoLib 4.8.3
NeoForge	1.21.1-1.21.4	Java 21	1.8.2	NeoForge 21.1.x, GeckoLib 4.8.3
Fabric	26.2	Java 25	1.8.2	Fabric API, GeckoLib 5.5+
NeoForge	26.2	Java 25	1.8.2	NeoForge 26.2.x, GeckoLib 5.5.1
Fabric	26.3	Java 25	1.8.2	Fabric API, GeckoLib 5.5.7
NeoForge	26.3	Java 25	1.8.2	NeoForge 26.3.x, GeckoLib 5.5.7

The older Fabric 26.1 and NeoForge 26.1 branches are legacy lines after the 26.2 unofficial port. Use 26.2 for the maintained Java 25 release line unless you specifically need a 26.1 legacy build.

Install the Just Enough Guns New file that matches your loader and Minecraft version. Do not mix Fabric and NeoForge builds.

How To Play

For version 1.3.0 and newer, gun controls use the modern input layout:

Action	Default Input
Shoot	Left Click
Aim down sights	Right Click
Reload	R
Inspect animated gun	Y
Gun melee / flashlight toggle, where supported	V
Sneak behavior, where supported	Shift

Older builds before 1.3.0 used right-click shooting, F reload, and Shift aiming. If you are updating from an old version, check your keybinds after launch.

Vehicles in the Walkürenritt update are built through vehicle assembly progression, then deployed and driven directly in-world. Most vehicles use normal Minecraft movement inputs once mounted:

Vehicle Action	Default Input
Enter vehicle / interact with vehicle	Right Click
Steer and throttle land vehicles, boats, helicopters, and aircraft	W / A / S / D
Brake, reverse, or slow down	S
Look / aim turret, cannon, or mounted weapon	Mouse movement
Fire the active vehicle weapon	Left Click
Aim, lock, zoom, or use the secondary vehicle function where supported	Right Click
Reload the active vehicle weapon where supported	R
Dismount	Shift

Vehicle behavior depends on the vehicle type and seat. Driver seats control movement, while weapon seats or co-pilot seats may control turrets, missiles, target locks, or defensive tools. Keep ammunition, repair tools, and charged support items in the vehicle inventory when the vehicle expects them, and watch the vehicle HUD for weapon state, reload timing, lock warnings, and damage feedback.

Gameplay Notes

Most guns need the correct ammo or magazine type. Magazine-fed weapons use loaded magazines, while manual and single-item weapons use their matching ammunition directly. Attachments, stocks, grips, sights, skins, badges, and special ammo types are part of the normal progression.

Some world and combat systems are intentionally dangerous when enabled. Gunner mobs, patrols, raids, explosive mobs, vehicles, vehicle weapons, and Terror Phantom events can heavily change survival balance. Server owners should review the generated config files before running the mod in a public world.

Ballistic Armor Interception

Bulletproof helmets and vests use a ballistic interception model for gun damage instead of vanilla Projectile Protection. Each shot resolves an effective armor-piercing value from the ammo type and the gun multiplier:

effectiveAP = ammoArmorPiercing * gunArmorPiercingMultiplier

On a protected hit, headshots use the bulletproof helmet first. Other protected body hits use the bulletproof vest. If no matching bulletproof armor piece is equipped, gun damage is unchanged.

For the selected armor piece, the damage multiplier depends on whether the shot undermatches or overmatches the armor rating:

apRatio = effectiveAP / armorRating

if effectiveAP < armorRating:
    damageMultiplier = undermatchMultiplier * (0.55 + apRatio * 0.45)
else:
    damageMultiplier = overmatchMultiplier * min(1.25, 0.85 + (apRatio - 1.0) * 0.18)
    damageMultiplier = min(damageMultiplier, 0.95)

finalDamage = rawDamage * damageMultiplier

Armor durability loss scales with raw damage and AP pressure. Under-matching shots still wear armor down, while over-matching shots punish armor more heavily:

pressure = effectiveAP / armorRating

if effectiveAP < armorRating:
    durabilityDamage = rawDamage * (0.65 + pressure * 0.35)
else:
    durabilityDamage = rawDamage * (1.00 + min(1.50, pressure - 1.0) * 0.85)

The result is then scaled by the armor slot and armor tier durability multipliers and capped before being applied to the armor item.

Donation

PayPal: https://www.paypal.com/paypalme/RuiMao65

Commands And Config

The mod exposes in-game configuration commands for common server tuning. Availability depends on loader/version branch, but recent builds include controls for areas such as:

• UI: ammo HUD, timer HUD, crosshair, dynamic crosshair, and hit markers.
• Mobs: gunner conversion chances, Parched gunner conversion, Phantom Gunner death explosions, and Terror Phantom behavior.
• Raids: faction patrols, raid wave timing, raid counts, and gunner accuracy scaling.
• Vehicles: vehicle assembly, enemy vehicle spawning, vehicle combat behavior, and vehicle support systems.

Config changes should be tested on a copy of the world before using them on a long-running server.

Credits And License

Just Enough Guns New is a fork and modern Fabric/NeoForge unofficial port of the original Just Enough Guns project by MigaMi, which targets Forge 1.20.1: https://www.curseforge.com/minecraft/mc-mods/just-enough-guns

• Original Just Enough Guns code is by MigaMi and is licensed under GPL-3.0.
• Original Just Enough Guns assets (models, textures, sounds, animations, icons, and other art) are by MigaMi and are All Rights Reserved (ARR). This project redistributes and uses those assets with explicit authorization from the original author (MigaMi).
• Recent updates include substantial materials derived from Superb Warfare (SBW / SW) by the SBW development team. SBW-derived assets (models, textures, sounds, animations, icons, and other art) are by the SBW development team and are All Rights Reserved (ARR). This project redistributes and uses those assets with explicit authorization from the original authors (SBW development team).
  • Walkürenritt vehicle set: LAV-150, BMP-2, speedboat, truck, AH-6, MI-28, A-10, TOM-6, HPJ-11, laser tower, and waveforce tower, plus vehicle workbenches, repair tools, models, textures, sounds, icons, recipes, and related data.
  • Special equipment and related assets: FGM-148 Javelin and missile, 9K38 Igla, FPV drone and monitor, C4 and detonator, Claymore, TM-62, smoke-screen / missile-lock UI and audio materials, and related models, textures, sounds, HUD art, and animations.
• SBW-derived materials are All Rights Reserved (ARR) under explicit authorization from the SBW development team, are for non-commercial use, and must be shared under the same ARR terms when redistributed or adapted. Future content may have different source projects and license terms.
• Just Enough Guns New is an independent unofficial port project and is not affiliated with, endorsed by, or an official addon for Just Enough Guns or Superb Warfare.
• Just Enough Guns New unofficial porting and maintenance is handled by maoruiq.
• Contributor: realorangewool, who provided the Fabric 26.1.2 backport.
• Project code based on Just Enough Guns is licensed under GPL-3.0. Original JEG assets remain ARR under authorized use as noted above. SBW-derived assets remain ARR under authorized use as noted above.

Suggestions and bug reports are welcome. Clear reproduction steps, Minecraft version, loader, mod version, dependency versions, and crash logs help much more than vague reports.