REQUIRES THE ABILITY TO READ
REQUIRES BASIC COMPUTER LITERACY
REQUIRES SUPERBLT
SOME FEATURES REQUIRE WEAPONLIB OR AFSF
PUT FINISHED MOD INTO 'MODS'
Notepad++ or other similar program recommended for ease of use
Big thanks to Cpone#8463, SgtJoe#8482, Kuziz#0897, Zdann#8628, and Killerwolf#2636 for helping me with the code!
So basically I started making a template for myself but as I did so I figured it'd be cool to make a public version.
This template contains all the necessary code needed to make a rebalance mod, that you only need to fill up with the proper weapon ids and numbers, cut out what you don't need, and boom, done. 75% of the work is done for you. Instructions are provided with the mod, in READ ME FIRST.txt and also within the .lua files.
Features:
Weapon stats:
- Magazine size, max ammo, fire rate, damage, accuracy (spread), stability (recoil), threat (suppression), concealment, reload
- Ammo pickup
- Piercing (enemy, wall, shield and armor)
- Alert size
- Effective range
- Damage falloff for shotguns
- Pellet count for shotguns
- Weapon category
- Primary or secondary
- Default fire mode
- Whether fire mode is toggleable or not
- Weapon animation sets
- Damage multipliers
- Kick values
Weapon mod stats:
- Damage, accuracy, stability, concealment, threat
- Alert size
- Reload speed
- Zoom
- Mag size, total ammo (WEAPONLIB REQUIRED)
- Rate of fire (WEAPONLIB REQUIRED)
- Pickup rate (WEAPONLIB REQUIRED)
- Piercing abilitiy (WEAPONLIB REQUIRED)
- Adding weapon mod incompatibilities
- Weapon mod stat overrides
- Adding parts to weapons
Melee weapon stats:
- Base damage, charged damage
- Knockdown chance
- Range
- Concealment
- Unequip delay, attack delay, damage delay
- Animation
- On-hit effect (stun, poison, fire)
If you wish to publish your own rebalance mods based on this template, all I ask is that you credit me in the description on your modpage.
The vast majority of the problems people encounter with this template are a result of mistakes made when filling it out.
Best way to reach me if you absolutely need help with it is on the Modworkshop Discord server.
ONLY contact me or ask for help in the apropriate channels on the discord servers. DO NOT send unsolicited DMs to other modders. I don't want to get the blame for sending anyone their way to "solve my problems".
Make sure you have SuperBLT and Weaponlib for the features that require it.
Regarding anti-cheat:
All weapon stats, with the exception of explosives and projectile weapons like bows and crossbows, are handled completely clientside. That means that when you connect to someone else's game, your game sends your stats over, whatever they might be instead of relying on the host's info. This means that if you use a rebalance mod, you can freely play in anyone else's game with no problem, or host games yourself without anyone else being affected.
Explosives and other projectiles are an exception to this, because projectile damage data is stored in a different .lua file than the other stats. Because the projectile needs to be spawned as a physical object in the world, it's handled by the host's game too, meaning that unless you are the host or the host has a rebalance mod that affects projectile weapons, your damage changes won't take place. All other stats can be freely changed though.
I also do not take any responsibility for any cheat mods you write with this. All I ask of you is don't be an asshole and don't grief other people's games. If you just want to fuck around, do so in offline mode.