Weapon Tweaker 2.0
This mutator serves as a successor to the original Weapon Tweaker mod. Instead of using the in-game configuration screen, this mod instead reads a .json file in your BepInEx folder to change weapon stats. This version also offers more control over weapon stats like recoil and damage.
You will need a custom plugin I made called JellyLib for this! You can get the latest version here[github.com]. Follow the installation instructions.
Please read everything below before asking any questions.
Once you have installed the plugin, I highly recommend running a match with just this mutator active. You do not need to finish the match. You should see a message in the console that says a .json file was generated by the mutator.
Navigate to your BepInEx located in your game files. You should now see a "files" folder. Inside the folder there should be another folder with this mod’s ID (3484102487) as its name. This is where you will find the weaponTweaks.json.
The mutator auto generates an example configuration for you. The auto generation does not format the configuration in a readable manner, but you can copy the text to JsonLint[jsonlint.com] to format it to a more readable manner. JsonLint may also be used to verify if your .json file is correct.
Renaming this file will cause the mutator to generate a new .json when a new match is run. This file is also read every time a new match is started. You do not need to close the game if you want to change something. Simply exit a match and start a new one.
Each entry in your .json file must have the following:
- weaponId – The name of the weapon. This is case insensitive. If the weapon name contains quotation marks, put a "" before each quotation.
- modId – The mod ID of where the weapon came from. This is the workshop ID of the mod and you can see this by checking the source mod’s workshop link.
See below for what you can override:
- maxAmmo
- maxSpareAmmo
- damage
- balanceDamage
- kickback
- randomKick
- snapMagnitude
- snapDuration
- snapFrequency
- cooldown (firerate)
- urmRecoil (only does something with Universal Recoil mutator)
- autoAdjustAllowedReloads – For weapons using advanced reloads. If you set maxAmmo to higher than the default and reloads aren’t fully reloading your weapon set this to true
- resupplyNumber
- followUpSpreadGain
- folowUpMaxSpreadHip
- followUpMaxSpreadAim
- followUpSpreadStayTime
- followupSpreadDissipateTime
- spreadProneMultiplier
- followUpSpreadProneMultiplier
Here is an example of what an entry in the .json looks like:
If you don’t want to override something, simply exclude it from the .json and it will be ignored. Variable names in the ,json file are case sensitive! If something doesn’t match how it was written in the listed fields above, it will not be read by the mutator.
Overrides apply to bots as well.
If you want to see the default stats of all available weapons (vanilla included) you can use the "Dump Weapon Names" button that is available when you are in the main menu. This will generate multiple files each one named after the source mod of the weapon (vanilla weapons and weapons not associated with any mod will be found in a file name "0").
Some weapon packs include the same weapon with the same name in different weapon slots. Normally this is not an issue, but this mod has no way to distinguish between those two weapon entries in-game. To fix this issue, the JellyLib plugin creates a unique ID for variants found in a weapon pack that share the same name. You can see what ID was generated in the LogOutput.txt file found in your BepInEx folder.
- This will obviously conflict with the original weapon tweaker mod. Only use one version.
- Ammo Control soft conflicts with this mod. Ammo Control only applies to the player and will override tweaks made in this mod.
- Any mod that removes weapon recoil may conflict with recoil tweaks made within this mod.
Revisions:
Old revisions of this mod are available below. Click the link to download.
