Instructions (pre 2.6.01)

Note: Consider the instructions here as outdated. Head over here for the latest version.

Installation on PC

FO4 Hotkeys

For PC users we recommend the use of our scripts naturally, so before installing the mod please install FO4 Hotkeys, found here: FO4 Hotkeys on Nexus

There is an exe file offered to install FO4 Hotkeys, but more than one of us has found that to fail, so a manual installation is perhaps best.

  1. Download the file
  2. Extract the file and copy the data folder into your Fallout 4 directory, merging it with the data folder already there, or simply extract it to your FO4 directory, again merging its contents with the existing folders.
  3. Make sure the plug in (esp) is activated in your game menu or mod manager.

Modern Firearms

Now install Modern Firearms, allowing it to overwrite files installed by FO4 Hotkeys.

For Install use a modmanager like the Nexus mod manager, Vortex or other modmanager for Fallout4.

If there are Problems with the Install, we recommend a manual installation. It’s simply the most reliable method of ensuring all the files wind up where they’re supposed to be. Use a mod manager if you like, but if it fails or you get unexpected results in-game do it manually before reporting an issue.

Manual installation follows the same method listed above for FO4 Hotkeys.

Customise Hotkeys

To customise your new hotkey functions open hotkeys.ini now located in your data folder with any text editor (notepad etc). In it you’ll find several MF functions, with keys already listed.

Key1=cgf "ModernFirearmsModSwitchScript.SwitchFireMode"
Key2=cgf "ModernFirearmsModSwitchScript.SwitchUnder"
Key3=cgf "ModernFirearmsModSwitchScript.SwitchAimPoint"
Key4=cgf "ModernFirearmsModSwitchScript.SwitchBipod"
Key5=cgf "ModernFirearmsModSwitchScript.SwitchSuppressor"
Key6=cgf "ModernFirearmsModSwitchScript.SwitchGadget" 

Simply edit the keys to your choices, save and exit. You should do this, because there is the possibility, that some of the keys you need for charactercustomisation aren’t working anymore!

For further information check the FO4 Hotkey documentation: Commands for Popular Actions and List of Possible Keybinds

Installation on XBox

Installation is guided by the game menus, and as no other mods are required the only thing you have to remember is your LOAD ORDER.

PC and XBox

Mods that edit level lists overwrite in order and can even conflict with one another. To ensure this mod is functioning correctly if possible avoid other mods that edit the level lists and at THE VERY LEAST make sure MF is at the BOTTOM of your load order.

Please note that mods are made by individuals, and not tested in conjunction with one another, so conflicts may occur. Better Mod Descriptions is a known conflict on PC, and there are probably more. If you find a conflict, please report it, this will help us help other users.


We nearly always recommend a clean save procedure:

  1. fully uninstall the mod (also check for lose files)
  2. load your game (ignoring warnings about missing content)
  3. save it again

Then and ONLY then install the latest version. Note that you may have to wait for an in-game week for the spawns of the items to reset. It’s a pain, we know, but it will avoid more pain later.

To lessen the pain of a clean save sell all the MF items you can to the vending machine first, generating a nice little nest-egg of pre-war cash to buy a new arsenal with after updating.


For a quick uninstall simply disable the plug-in, either in your game menu or mod manager.

For a full uninstallation (recommended for large updates) delete the plug-in and any folders/BSAs in Materials/Meshes/Scripts/Textures/Sound named SHEEP.


The items in this mod are, as mentioned, integrated into level lists.

To give you a chance to survive they won’t start appearing until level 10-15? After that you will find them on your (hopefully dead) enemies and at vendors.

You can also craft a vending machine at the settlement workshops under the crafting section. The vending machine will sell you parts for customisation (for pre-war cash), the unique ammo types for the guns and allow you to trade in a rifle to make a ‘unique’ rifle for the player.

This is necessary for the scripts to function correctly whilst carrying more than one of any particular type of rifle. If, for example, you have 2 AR15s in your inventory then the scripts will not function for those weapons unless one has been made ‘unique’. If you have only one AK in your inventory at the same time then that will still work as expected with the scripts. This is a game engine limitation and as such there is nothing that we can do about it.

Scripted Functions

At the moment we support toggling the following things using scripts:

  • Suppressor on/off
  • Underbarrel weapon/main weapon selection
  • Semi/full auto fire
  • Aimpoint- scope zoom/magnifier/night vision toggling
  • Bipod on/off (note that bipods being deployed will slow your movement by 90% to simulate being prone)

Note also that you need all the necessary components on your rifle for the scripts to function – an M203 won’t just magically appear unless you built one.


There are aid items (reusable) found at the vending machine to mimic the function of the script hotkeys on PC.

Please note that the instructions for their usage in game are the same as for PC, you will need all the items you want to switch attached to your gun, and either only one of that weapon family in your inventory or an MF Custom variant of that weapon available by way of trade-in at the vending machine.

Put the aid items (switch functions) you want in your favourites and enjoy a whole new feel to combat.

Notes PC

For PC users of course there’s always the debug console.
For a simple ‘give me everything’ there are test containers, and the commands you should use are:

help mfcontainer 4

and with the ID you get:

placeatme <CONTAINER_ID>


We get the same questions again and again from people who have not read the answers we’ve ALREADY GIVEN. That’s kinda frustrating, and leads to us -well, you know- ignoring you.