Weapon Modules

All configuration sections you can add to your weapons

New to the wiki? This page contains important information about config! Read this first!

Weapon Title

All weapons have a unique "weapon title" in config. It is the name at the top of the file, like:

In the image above, the weapon title is AK_47. To get the weapon in your server, use /wm get AK_47.

The names of files are completely ignored. We suggest matching them with your weapon title (e.g., AK_47.yml), but this is optional and does not affect the plugin.

Your weapon title (And ALL OTHER config options) should never use any character other then a->z, A->Z, 0->9, and underscores _. Do NOT use periods or dashes.

Modules

All weapons use modules. A "Module" is a fancy way of saying a section in your config. For example, the Shoot module is required for all weapons. It goes under your weapon name in the config with 2 spaces. Let's look at an example of the AK_47:

AK_47:
  Shoot:
    # Other options go here, like Trigger and Projectile_Speed

Most modules can also have sections inside. For example:

AK_47:
  Shoot:
    Trigger: 
      # Other options go here, like Main_Hand and Off_Hand

Here is the complete list of modules (You can also see this on the sidebar on the left of this page!):

1. Info

2. Shoot

   1. Spread

   2. Recoil

3. Scope

4. Reload

   1. Ammo

5. Skin

6. Projectile

7. Explosion

8. Damage

9. Firearm_Action

10. Melee

11. Firemode -> Requires WeaponMechanicsPlus

12. Cosmetics -> Requires WeaponMechanicsCosmetics

13. Trails -> Requires WeaponMechanicsCosmetics

14. Show Time -> Requires WeaponMechanicsCosmetics

Required Modules

The Info and Shoot modules are the only required modules. Most config options are optional and can be omitted from your config file.