Weapon Whiplash 1.0.0

Description

Weapon Whiplash adds extreme recoil knockback to Rust weapons, launching players backwards every time they fire a gun. Each weapon uses its own customizable launch force, allowing effects that range from mild pushback to full power map wide launches.

Admins can toggle the feature on specific players, making it one of the best and funniest ways to troll cheaters without banning them. Optional systems include gun-dropping on fire, rocket freezing, kill-on-landing, and TC-safe recoil to prevent accidental griefing.

Whether used for moderation, trolling, or chaotic PvP events, Weapon Whiplash delivers maximum entertainment with full admin control.
 

Key Features

Extreme Recoil Launching
Players are blasted backwards whenever they fire any weapon.

Per-Weapon Custom Recoil
Adjust recoil strength individually for each gun, bow, SMG, rifle, or rocket launcher.

TC-Safe Teleport Logic
Prevents players from being launched into enemy Tool Cupboard zones.

Rocket Freezing
Stops rockets mid-air to avoid accidental structure damage.

No Damage Mode for Bullets & Rockets
Optionally disable damage from bullets and rocket  

Gun Drop Option
Make players drop their weapon when firing for extra trolling power.

Kill-On-Landing
Falls above a certain height instantly kill the player.

Targeted Trolling
Apply the effect to specific players — perfect for catching and humiliating cheaters.

Admin-Controlled
Fully toggleable and configurable through permissions and commands.
 

🛠 Permissions

weaponwhiplash.use
• Allows admins to toggle the effect on specific players.

weaponwhiplash.test
• Allows staff or selected players to experience recoil launching themselves.
 

Commands

Chat Command:
/whiplash <steamid>
• Toggles Weapon Whiplash on/off for the specified player.
• Requires weaponwhiplash.use permission.

🛠 Config
 

{
  "RocketSettings": {
    "FreezeRocket": true
  },
  "DamageSettings": {
    "NoRocketDamage": true,
    "NoBulletDamage": true
  },
  "TeleportSafety": {
    "PreventTeleportIntoTC": true
  },
  "GunDropSettings": {
    "EnableGunDrop": true,
    "DropForce": 15.0
  },
  "GunRecoil": {
    "default": 100.0,
    "rifle.ak": 140.0,
    "rifle.bolt": 120.0,
    "rifle.l96": 120.0,
    "rifle.m39": 110.0,
    "rifle.semiauto": 110.0,
    "smg.thompson": 130.0,
    "smg.mp5": 125.0,
    "smg.custom": 110.0,
    "pistol.python": 150.0,
    "pistol.semiauto": 110.0,
    "pistol.m92": 115.0,
    "pistol.nailgun": 100.0,
    "pistol.revolver": 110.0,
    "shotgun.pump": 180.0,
    "shotgun.spas12": 170.0,
    "shotgun.waterpipe": 140.0,
    "shotgun.double": 200.0,
    "lmg.m249": 200.0,
    "lmg.m134": 260.0,
    "bow.hunting": 100.0,
    "bow.compound": 110.0,
    "crossbow": 100.0,
    "rocket.launcher": 250.0
  },
  "KillOnLanding": true
}