Vanilla Gun Modify (VGM)

This isn't about throwing into a fabricator to get a new gun; this is genuine quick-change tactical attachment modification

This mod was created using Weapon XML Generator

Latest Updates

The first optional expansion pack: Mag & Bullets: VGM Addon #1 is out now!

With full rework of ammo system, over 50 bullet types, hundreds of new items, and intuitive, user-friendly interactions!

Introduction

The Vanilla Gun Modify Sys (VGM) for Barotrauma aims to replicate the tactical attachment modification system found in mainstream FPS games like PUBG, Call of Duty, Metro, and S.T.A.L.K.E.R., providing a familiar, convenient, and elegant way to fine-tune your ship's weapons: from a submachine gun with a suppressor and laser sight to a revolver "rifle" with an extended barrel, sniper scope, and pistol grip.

This mod adds a workbench, 10 weapons with multiple slots, and 15 different firearm accessories. All attachments work by being directly inserted into the weapon. The attachment effect values are based on the original game's values, with some slight imbalances but are generally suitable for the vanilla game environment.

Usage Guide

You need to craft a "Weapon Modification Workbench" at the vanilla workbench, place it in the submarine, and power it on. Use this workbench to craft various attachments.

Currently, there are five slots for modification:

Top Mount (Scope)

Affects the reticle size and the weapon's maximum visible distance. In addition, laser sights, flashlights, glowsticks, etc., can also be installed on top

Barrel

Affects screen shake during full auto, damage, and barrel position

A longer barrel can provide a more significant bonus to damage and stability, but an overly long barrel can be a hindrance in close quarters combat

Underbarrel

Affects the gun's posture and is the primary mounting point for light sources. Keeping the muzzle pointed forward helps maintain alertness during mobile firefights

Both the lower and upper attachment slots may serve as mounting points for light sources. This mod reworks glowsticks and signal flares to permit their attachment to firearms. Additionally, it introduces a laser that can switch colours at will—unlike common multicolour lasers, VGM's laser employs light source editing logic, theoretically enabling it to become any colour you desire.

Stock

Affects the weapon's movement speed and spread. A heavier stock allows the shooter to aim better but also affects mobility

(Mags)

This is not considered a tactical attachment, but who can say no to a drum magazine with 3 times the capacity?

Mod Support

GunEnhanced, Additional patch is required. (Strongly Recommended)

Compatibility Warning This mod modifies (almost all) of the original weapons and has a complete framework built around them. In theory, it may conflict with any mod that modifies the original weapons.

If you plan to play with other original expansion mods, simply place VGM at the top of these mods, and it will not affect the gaming experience. If you plan to play with mods that deviate from the original game's numerical parameters, consider downloading a dedicated integration patch. VGM modifies the numerical values of these weapons, and they require a dedicated numerical compatibility patch to work well with them.

If you wish to perform secondary development based on this module, there is no need to request authorization privately. All content within this module (including code, music, and materials) is released under the MIT license. You are free to use, modify, and distribute it as you see fit! I have included extensive comments in the XML file for your reference.

Source Code is here