Subscribe to download
Weapon Attachment Mod Base

Attachments are items one could pick up, and to be mounted on guns to grant stats change.
To mount an attachment on a gun, pick up the attachment. Click the icon of the attachments on radial inventory while equipping the gun you want to mount the thing on. You will see the attachment's label changed to reflect the gun's name it's mounted on (Eg. "Muzzle Brake [fa_m16a4"], and if you have enabled model override cvar you will see corresponding viewmodel changed as well.

This is the base mod for any map/mutator that features weapon attachments.

Choke: Boosts weapon damage while costing stamina, also makes every shot stagger;
Muzzle brake: Boosts rate of fire while reducing weapon damage;
Grip: Boosts reload speed;
Drum mag: When attached to a gun, the gun directly consumes ammo from inventory while shooting, removing the need to reload till all ammo is depleted. (Requires at least 1 bullet loaded to shoot);
Scope: Adds a scope to see further when ADS, because why not. (Model override needs to be enabled.)

- Scope cannot be mounted on Jae700, M16 with scope and Sako with scope.
- Muzzle brake can't be mounted if choke has been mounted on.

For your best experience, disable all weapon-model mods (Hand mod, weapon texture mod should be fine) & enable sv_attachment_enable_viewmodel_override. This mod only supports vanilla weapon models.

Although custom weapon models would not break the system, they will result in viewmodel & worldmodel being abruptly reverted to vanilla look upon attaching a mod. If you would like to keep the functionality of attachment but prefer to keep using your custom models, disable sv_attachment_enable_viewmodel_override.

For mappers, add item_custom to your level, in the entity fields specify below. For mutator creators, spawn a item_custom with the following entity key fields:

model -> [model path of the attachment] (Model dictates which attachment this item becomes, choose from list below)
vscript -> "nmo_irradiated/weapon_attachment/attachment.nut" (Do not change)
icon -> [material path of the icon image that appears in inventory] (Choose from list below, or from your custom-made materials)
weight -> [How much space this attachment takes in inventory]

List of available models:
- Choke: models/nmo_irradiated/attachments/shotgun_choke.mdl
- Muzzle brake: models/nmo_irradiated/attachments/muzzlebrake.mdl
- Grip: models/nmo_irradiated/attachments/grip.mdl
- Drum mag: models/nmo_irradiated/attachments/drum_mag.mdl
- Scope: models/nmo_irradiated/attachments/scope_4x.mdl

List of available inventory icons:
- Choke: materials/nmo_irradiated/inv_icon_choke.vmt
- Muzzle brake: materials/nmo_irradiated/inv_icon_muzzlebrake.vmt
- Grip: materials/nmo_irradiated/inv_icon_grip.vmt
- Drum mag: materials/nmo_irradiated/inv_icon_drummag.vmt
- Scope: materials/nmo_irradiated/inv_icon_scope.vmt

There need to be one filter_script present in map and assigned to entities that are meant to receive damage mod treatment. For instance, zombies need this filter assigned to them as damagefilter in order for zombies to receive damage boost.

For map creators, place one filter_script in your level and set the vscript field to: "nmo_irradiated/filterscript/attachmentDamageMod.nut". To use the filter_script on zombies, assign its targetname to the damagefilter field of the zombies. The same applies to other entities to opt-in the damage boost, such as breakables, physics objects.

For mutator creators, make sure to include this line "DoIncludeScript("nmo_irradiated/weapon_attachment/attachment_generate_damagefilter.nut", this);" in the mutator initialization script. This will generate a filter_script described above.

Mutator: https://steamcommunity.com/sharedfiles/filedetails/?id=3263056118
Map: There is no example map available publicly yet.

sv_attachment_enable_viewmodel_override - Whether to enable viewmodel & worldmodel override; 1 to enable, -1 to disable.
sv_attachment_coexists_with_weapon - When set to 1, dropping weapon from inventory also drops all attachments mounted to it, treating them as one entity; Otherwise, dropping weapon would automatically detach all attachments.
sv_attachment_damage_multiplier_choke - Damage multiplier for choke mod.
sv_attachment_damage_multiplier_muzzlebrake - Damage multiplier for muzzlebrake mod.
sv_attachment_reload_speed_multiplier_grip - Reload speed multiplier for grip mod.

- Attachment models & textures:
https://steamcommunity.com/sharedfiles/filedetails/?id=2751323984
https://steamcommunity.com/sharedfiles/filedetails/?id=2528829149