TOP- Vehicle Penetration Rules

TOP: Vehicle Penetration Rules lets a server decide which weapons can hurt which vehicles, and how much. It works with vanilla and modded vehicles and ammunition.

FEATURES
- A rule for every weapon group against every vehicle group: ALLOW (normal damage), BLOCK (no damage), or a damage multiplier such as x0.5. CUSTOM lets you type any multiplier.
- Crew protection: when a vehicle blocks a weapon, the people inside behind its body aren't hurt either. Crew in open hatches, windows or truck beds can still be hit.
- Stopped rounds: a round a vehicle blocked does no damage to anything it hits afterwards.
- Optional armour for each vehicle group, so rounds that can't beat it stop or ricochet at the hull for everyone.
- Your own groups: make, rename and delete weapon and vehicle groups in game, restore deleted built-in ones, and move a mod's rounds and vehicles into the right group (each group lists the others' to pick from; Shift- or Ctrl-click for several, or add a prefab by name).
- F9 settings menu for Game Masters and admins, with three tabs:
  Settings: the switches, the vehicle-by-weapon grid and armour. Hover over anything for an explanation.
  Groups: what's in each group, and the group editor.
  Last shot: the full log of the latest shot that hit a vehicle or its crew. Click a round or vehicle to open its group.
- The #vpr chat command and RCON do the same.
- Every change is saved on the server and applied again after restarts.

GROUPS
Weapons: Small caliber (pistol and SMG rounds), Rifles, Rifles AP, Heavy MG, Autocannon, Anti-tank, Explosives, Other bullets.
Vehicles: Cars, Trucks, APCs, Tracked, Helicopters.
Up to 10 weapon and 8 vehicle groups.
- Modded vehicles and rounds join the group of the vanilla prefab they're built on.
- Every explosion and its fragments count as Explosives, because a blast doesn't say which warhead caused it. The jet and spall of HEAT rounds count as Anti-tank. While Explosives is deleted, explosions do normal damage.
- Other bullets is the catch-all for bullets no other group claims, including most modded rifle and machine gun rounds.
- Anything in no group takes normal damage.
- A renamed group keeps its first name for #vpr and the saved settings, so its rules, armour and contents stay with it.

DEFAULT RULES
- APCs: block Small caliber, Rifles and Rifles AP. Armour 14 mm.
- Tracked: block Small caliber, Rifles, Rifles AP and Heavy MG. Autocannon does 25% damage. Armour 40 mm.
- Cars, Trucks and Helicopters: Small caliber does 50% damage, the rest normal damage; their own armour.
- Crew protection and stopping blocked rounds are on. The debug log is off.

SETTINGS MENU (F9)
Game Masters and admins press F9. The key can be changed in Settings > Controls under "TOP: Vehicle Penetration Rules". Left-click a cell for less damage or thicker armour, right-click to go back. One click past BLOCK is CUSTOM, where you type any multiplier. Changes apply to everyone at once.

COMMANDS (Game Masters and admins in chat, or RCON)
#vpr status - show the current rules
#vpr on | off - switch all rules on or off
#vpr rule <vehicle> <weapon> <allow | block | 0.5> - e.g. #vpr rule apcs heavymg block
#vpr armor <vehicle> <mm | off> - mm: 1 3 5 7 9 10 14 20 25 30 40 80 100
#vpr crew | stop <on | off> - crew protection, stopping blocked rounds
#vpr group <round | vehicle> <prefab> <group | none | default> - e.g. #vpr group round Ammo_6.8_Hybrid riflesap. Several prefabs: separate them with ;
#vpr newgroup <weapon | vehicle> <name>, #vpr renamegroup <weapon | vehicle> <group> <new name>
#vpr deletegroup <weapon | vehicle> <group>, #vpr restoregroup <weapon | vehicle> <group>
#vpr debug <on | off> - one line per hit in the server log, and the latest shot in the Last shot tab (not saved)
#vpr reload - read the mod's defaults and the server's saved settings again
#vpr reset - back to the mod's defaults; clears the saved settings
Groups can be given by name or by their number from #vpr status.

ARMOUR GUIDE (vanilla rounds, up close)
Rounds get through more up close, where they're fastest.
- 7 mm: stops pistols and nearly all non-AP rifle and machine gun rounds.
- 14 mm: also stops rifle AP (except 7.62 M993 at close range) and .50 cal ball.
- 20 mm: stops every vanilla rifle round.
- 40 mm: stops every vanilla heavy machine gun round, including .50 cal AP.

SERVER SETUP
- Add the mod to the server; players download it as usual.
- Changes made in game are saved in VehiclePenetrationRules.txt in the server's profile folder, one per line, written like the #vpr command. Edit it by hand and use #vpr reload, or delete it to go back to the defaults.
- Keep the debug log off on live servers.

COMPATIBILITY
- Doesn't change any vanilla prefab; hits are judged as they happen.
- Other mods' vehicles and rounds are matched by path, so those mods are never required.
- Works alongside TOP: Weapon Damage Rules.