Experimental Universal Machine Gun (READ DESCRIPTION!) 1.1

HOW TO USE THE MOD:
​

Here is a tutorial of how to make the gun work, how to install it on vehicles, and how to use it. Please read the whole thing before complaining that you can't get it to work lol

First, if you have just installed the mod, you will need to add some key bindings to be able to use the gun. Go to the Options menu, and open the Vehicle tab in Controls menu:

When you open this tab, scroll to the bottom, and you will see key bindings for the gun. You need to assign some keys to them (by pressing the + key and then the button you want to use for the gun action), for example you can set these ones:

Fire will be the button to fire the gun. Lift Up and Lower Down are controls that change the angle of the gun, and alternatively instead of them you can use Lift, which is an axis (stick, analog button) of a controller.

When you have the controls already set up, it's time to select the vehicle you want to put the gun on. The mod supports all vanilla vehicles that have roof bar options + the Gavril D-Series, and also some mod vehicles.
Full list of supported vehicles (there could be more supported mods, these are just the ones I tested):

• Ibishu 200BX
• ETK 800 Series
• Gavril Barstow
• Bruckell Bastion
• Gavril Bluebuck
• Ibishu Covet
• Cherrier FCV
• Gavril Grand Marshal
• ETK I-Series
• ETK K-Series
  
• Bruckell LeGran
  
• Ibishu Miramar
• Bruckell Moonhawk
• Ibishu Pessima (1996-2000)
• Ibishu Pessima (1988-1991)
• Autobello Piccolina
  
• Ibishu Pigeon
• Hirochi SBR4
  
• Burnside Special
• Hirochi Sunburst
• Soliad Wendover
• Gavril D-Series
• Gavril H-Series
• (MOD) Soliad Sunville
• (MOD) Dacia Sandero
• (MOD) AW Astro
  
• (MOD) Land Rover Defender
• (MOD) ETK 1300 (Requires gun mod update 1.1 or higher!)

Vehicles that are NOT supported due to lack of roof bars:

• Civetta Bolide
• Ibishu Wigeon
• Wentward DT40L
• Ibishu Hopper
• Gavril Roamer
• Gavril T-Series

Keep in mind that modded bodies for supported vanilla vehicles might not have a slot for roof bars or it might work incorrectly. A mod that has been tested to work with the gun is Javielucho Mad Mod, most cars already have roof accessories in it but you can add the gun to the Burnside and 200BX. The Burnside Hot Node should already spawn with the gun if you have both mods active!

When you select one of the supported vehicles, first you need to put the roof bars on it with parts selector. On most vehicles, the roof bars slot is somewhere under the body slots:

But there are some exceptions where the slot is harder to find:

• On the Cherrier FCV, you have to find the Roof Rack slot first, which as either a roof rack or flush roof rails, and it will be under it:
  
• On the Bruckell LeGran wagon body, you need to first add the Roof Rack under Roof Accessory slot, then you can add the roof bars to the roof rack:
  
• On the Ibishu Pigeon, you need to first add the Bed Box as Bed Accessory, and under it you have 2 types of roof bars to select. Alternate ones are better for this mod because they won't cause any clipping:
  
• The Gavril D-Series doesn't have roof bars, but it has bed bars that are a similar thing. In this case the setup is really complicated. First, you need a frame that has a SHORT BED available (doesn't say "Long Bed" in frame name). Then under the bed slot, you have to add the Bed Rack. It will normally spawn with a ladder and pipes attached. You need to remove the pipes, and replace the ladder with the machine gun as shown here:
  
  I am aware that this setup is really confusing, so I have included a configuration for the D-Series in the mod that has the gun ready to use. It is like a homage to the old mod called D15 Technical, hence this name:
  
• On the Gavril H-Series, the roof bars slot can be found under the Roof slot, and won't work on the fiberglass roof extension:
  

If you can't find the roof bars slot, you probably already have a roof accessory and you have to replace it with roof bars. Examples of parts that have to be replaced:

• Taxi sign on Gavril Bluebuck, Gavril Grand Marshal, Bruckell LeGran sedan body, Burnside Special
  
• Beacon light on Gavril Bluebuck, Autobello Piccolina, Hirochi Sunburst
  
• Light bar on Gavril Grand Marshal, Bruckell LeGran sedan body, Hirochi Sunburst, Soliad Wendover
  
• Roof rack on Autobello Piccolina

Once you have installed the roof bars, and found the machine gun in loads, you can install it on your car.

Sometimes after you install it or change something in it, for some reason the camera might get off-centered from the car, just restart the car then and it will be fixed.
Under the gun slot, there will be another option where you choose the ammo, by default 300 bullets with invisible belt:

The more bullets you choose, obviously the longer you will be able to shoot, but that is at the cost of performance - the game might lag with large amounts of bullets like 500 or especially 1000.
Some selectable bullet amounts have an option to add a visible ammo belt to the gun. The belt is only for the visual effect because it looks cool:

The belt will be slowly retracing as you shoot until it disappears in the gun completely, however it might sometimes get stuck on the body of the car and stop retracing. It is especially prone to getting stuck on the Autobello Piccolina and the ETK K-Series for some reason. If you drive while shooting, it might get tangled in the wheels, doors, fenders, etc. It shouldn't damage the car but will stop the belt from retracing. It can also break parts highlighting in the parts selector on some cars, due to having many parts in itself (each bullet is a new part, this way it can bend naturally).
WARNING! From the beta testing of the gun, it turned out that the belt mght be REALLY LAGGY for some people, while being completely fine for others. I have no idea why it's the case, but possibly the belt's physical structure or aero is too demanding for low end CPUs. So if you notice lag issues with the gun mod, then remove the belt!

Selecting the amount of bullets isn't the only thing you can do in terms of customization of the gun! There are also some settings for it in the Tuning tab:


Additional Energy Multiplier is the extra energy each bullet has in addition to the energy generated by its momentum based on mass (0.03kg, and yes, this mass gets removed from the gun on each shoot) and speed. Think of it like explosive or penetrating ability of the bullet. Higher energy lowers the range of shooting unfortunately, but you can readjust it with Launching Spring Precompression. That parameter is basically the strength of each shoot. Higher is better for shooting targets that are far away, because the bullets will be less affected by gravity on that distance due to higher speed. However, for closer targets, lower precompression is better, because too high might make bullets clip through the target car without damaging it, think of it like the bullet made a hole straight through the targed without "exploding" inside it and dealing damage. The last setting is the fire rate, which is the amount of bullets fired per second. The faster you fire, the more destruction, but also you run out of ammo faster, so be careful with this!

Now that we know how you can configure the gun, we can see how it's used. It's really simple, just aim at the target using the keys you set at the beginning for Lift Up and Lower Down (alternatively only Lift for controller), and hold the button you set as Fire to shoot!


In addition to damaging the target, shooting generates some visual effects, like fire and smoke from the gun's barrell and the belt retracing if you have it, and a shooting audio effect. You should also see in the top left corner the amount of bullets you have left. Another thing that happens is that the weight of the bullet is removed from the gun, so shooting more will make it slightly lighter. (Not by much, the empty gun weights around 30kg, while a single bullet is 0.03kg so if you shoot 100 of them the gun will lose close to 10% of its weight.)
Some of you might ask: can the gun get damaged? It can't from just shooting, I decided against implementing gun overheating as it would ruin the fun. But from crashing into it, it can. It won't bend like other car parts, but the shell can be ripped off from the base with enough force, and it won't shoot anymore. But that only happens on EXTREME crashes:

If you have the belt equipped, with enough force you can rip it off, and you won't be able to shoot anymore because you have no ammo (but I made sure this won't happen due to belt getting stuck somewhere in your car):

With A LOT of force, it is possible to rip the entire gun off the roof bars, but you will break the whole car in the process...

...So if you want the gun without the car, there is an easier option! I have included a standalone gun in the mod too!

It has the same options as the car-mounted one, and some ready configs with different amounts of bullets.


I think this is all for the mod's overview. A lot of work went into testing of the mod and finding issues, which is why it was delayed by months. If you run into some issues we missed, you should report them so I can fix them. Have fun using the gun!


You are allowed to use the gun model, textures, materials, LUA and Jbeam in your own mods as long as you credit me. The code should be flexible and understandable so you can use it without too many modifications needed I hope.