Clip Slap Akimbo

I spent way, way, way, way too much time on this and I hope it doesn't break something horrifically that I didn't account for... but enjoy!

This is adds physics based clip slapping and loading for clip fed handguns and rifles. Handguns get bonus dual wielding features for more fun factor.

Allows you to slap clips out of firearms using your hands, other firearms, or any interactive object. Just insert a clip and give it a slap with your hand and it should knock it out of the gun. Also enables pushing bullets from clips during dual-wield scenarios for tactical reloading.

Includes quickbelt loading support by hovering the clip attachment point over your quickbelt slot to easily load the clip when dual wielding.

(Note: Clips inserted into the guns can't actually hit each other like the GIF, but you can smack it against the opposite gun in similar fashion)

Features

• Clip Slapping: Slap clips out of firearms using hands, other firearms, or any interactive object
• Dual-Wield Bullet Pushing: Push bullets from clips when dual-wielding firearms or mixed interactive objects
• Quickbelt Auto-Loading: Automatically load clips from quickbelt slots when hovering handguns over them
• Configurable Forces: Separate force multipliers for empty and full clips
• Auto Bolt Release: Optionally releases bolts/slides when clips are slapped out

Clip Slapping Mechanics

The plugin detects when you slap a clip with sufficient velocity and ejects it from the firearm with realistic physics:

• Velocity Threshold: Configurable minimum velocity required to trigger a slap
• Dynamic Force: Heavier force for empty clips, lighter force for full clips
• Realistic Physics: Clips inherit firearm velocity plus slap force with random spin
• Multi-Object Support: Works with hands, firearms, and any interactive object

Dual-Wield Features

When holding firearms or interactive objects in both hands:

• Bullet Pushing: Press clips together to push bullets between them
• Firearm-to-Clip: Use firearms to push bullets from clips in the other hand

Quickbelt Auto-Loading

Handguns can automatically load clips from quickbelt slots:

• Dual-Wield Mode: Requires both hands holding firearms by default, configurable for single-hand use like Potatoes' Akimbo magazine and speedloader mod

Configuration

All settings can be adjusted via the in-game configuration menu:

Force Settings

Slap Force Multiplier: Force applied when slapping empty clips (default: 1.75)
Full Clip Slap Force: Force applied when slapping full clips (default: 0.75)
Slap Velocity Threshold: Minimum velocity required to slap a clip (default: 1.75)

Clip Behavior

Require Empty Clip: Only allow slapping when clips are empty (default: false)
Auto Bolt Release: Automatically release bolts when clips are slapped (default: false)

Slapping Permissions

Allow Firearms To Slap: Firearms can slap clips from other guns (default: true)
Allow Interactive Objects To Slap: Any held object can slap clips (default: true)

Dual-Wield Features

Firearms Can Push Down Clip Rounds: Firearms can push bullets from clips (default: true)
Clips Can Press Other Clips: Clips can push bullets into each other (default: true)
Interactive Objects Can Push Down Clip Rounds: Any object can push bullets (default: true)

Quickbelt Auto-Loading

Auto Load Clips From Quickbelt: Enable automatic clip loading for handguns (default: true)
Only Load From Spawnlocked Slots: Restrict to spawnlocked quickbelt items (default: false)
Allow Loading When Wielding One Handgun: Enable single-hand auto-loading (default: false)

Debug Options

Enable Debug Logging: Show detailed plugin activity in console (default: false)