Munitions was designed from the ground up to be easy-to-use for players and mod authors alike. I've included a number of features to make it easy to patch your mods for Munitions.
In the example below, we'll patch the vanilla Combat Rifle to use Munitions' .223 caliber ammunition. You will need FO4Edit to do this.
Step 1: Download the quest resource in the Optional Files section.
- We'll use this later, so make sure you don't skip this step.
Step 2: Load all necessary plugins in FO4Edit.
- Make sure to include Munitions - An Ammo Expansion.esl and Munitions Injection Quest Resource.esp alongside the target plugin that will be patched.
Step 3: Copy the target weapon record as an override into a new plugin.
- Right-click the target weapon record and select the Copy as override into... option.
- Select a unique name for your new plugin. You can name this whatever you'd like, though it's best to keep it simple and consistent. I use the $ModName - Munitions Patch naming convention, where $ModName is the target mod I'm patching for.
Step 4: Add Munitions as a master to the new plugin.
- Right click on the newly-created plugin and select the Add Masters... option.
- Select Munitions - An Ammo Expansion.esl and click OK.
Step 5: Sort masters to ensure the load order is correct.
- Right click on the newly-created plugin and select the Sort Masters (to match current load order) option. By default, any new masters added to a plugin will appear last in the Master Files list. Since Munitions is an .esl plugin, it will automatically load before standard .esp plugins. It's important to make sure this is reflected correctly in your patches.
Step 6: Change the weapon's Ammo and NPC Add Ammo List properties.
- Navigate to the target weapon record that we copied into the newly-created plugin and scroll to the DNAM - Data section at the bottom.
- Double click the Ammo property on the right and change it to the desired Munitions ammo type. All Munitions ammo records have a prefix of Munitions_ for easy identification.
- Scroll down to the LNAM - NPC Add Ammo List property. Double click it and set the appropriate leveled list for the ammo type. All Munitions leveled list records have a prefix of Munitions_ for easy identification.
Step 7: Copy the corresponding ammo injection quest as a new record into your plugin.
- Expand the Quest section of Munitions Injection Quest Resource.esp. You'll notice there is a quest for each Munitions ammo type; find the quest corresponding to the Munitions ammo type your patch will use.
- Right-click on the quest and select the Copy as new record into... option.
- Make sure to replace the YOURMODNAME with your mod's name and then click OK.
Background information on the injection quests and why they're important: This ammo injection quest runs a tiny, run-once script to check the value of a global variable (typically named Munitions_$AmmoTypeInjected).
If this global value is set to 0, it will kick off the corresponding ammunition's injection quest and then set the global value to 1.
If this global value is set to 1, nothing will happen. This ensures that any mod using Munitions ammo types don't double-inject themselves into leveled lists.
Another benefit of using this quest is that it prevents players from needing to manually inject the desired ammo type using the Munitions Configuration holotape.
Step 8: Save and test!
- Save your plugin and then open up the game to ensure that everything is working correctly.
- The best way to test whether or not your patch is working correctly is to use the Munitions Configuration holotape. Load it up and then scroll down to the ammo type you patched your weapon with. You should see ADDED next to the ammo type's entry. If you do not see ADDED next to the target ammo type, you either chose the wrong injection quest in Step 7 or you skipped that step entirely.
- Additionally, you can add the weapon into your inventory and check the ammo type to ensure it is working correctly.
2 comments