MiniGunMod
**MiniGunMod** enhances the vanilla Minigun with configurable firing, reloading, damage, durability, magazine capacity, VIP bonuses, and optional laser-sight support.
# MiniGunMod
MiniGunMod enhances the vanilla Minigun with configurable firing, reloading, damage, durability, magazine capacity, VIP bonuses, and optional laser-sight support.
Features
* Instant Fire / Spin-Up — optionally allows the Minigun to fire immediately with left click instead of requiring the normal spin-up.
* Hand Reloading — reload the Minigun using the normal reload key, with a configurable reload delay.
* Configurable Magazine Capacity — change the Minigun's magazine size from the vanilla 300 rounds.
* Configurable Damage — adjust the Minigun's damage multiplier.
* Configurable Durability Loss — control how quickly the Minigun loses condition while spinning.
* Ground Check — optionally prevent instant firing/spinning while airborne.
* VIP Settings — players with the VIP permission can receive separate reload speed, damage, durability, and magazine-capacity settings.
* Optional Laser Sight — automatically attaches a laser sight to authorized Miniguns when enabled.
* Attachment Protection — prevents the configured laser sight and supported attachments from being removed or swapped while attached.
* Vanilla Restoration — when the plugin or Minigun modification is removed, the weapon's vanilla damage, durability loss, and magazine capacity are restored.
Permissions
| Permission | Description |
| ------------------ | ------------------------------------------------------ |
| MiniGunMod.use | Allows a player to use the modified Minigun. |
| MiniGunMod.vip | Enables the VIP Minigun configuration for the player. |
| MiniGunMod.laser | Allows the player to receive the optional laser sight. |
Default Configuration
General Settings
| Setting | Default |
| ----------------------- | ----------: |
| Hand Reloading | true |
| Instant Fire / Spin-Up | false |
| Laser Sight | false |
| Ground Check | true |
| Reload Delay | 5 seconds |
| Condition Loss / Second | 1.0 |
| Damage Scale | 0.75 |
| Magazine Capacity | 300 |
VIP Settings
| Setting | Default |
| ----------------------- | ----------: |
| Reload Delay | 3 seconds |
| Condition Loss / Second | 0.75 |
| Damage Scale | 1.0 |
| Magazine Capacity | 600 |
How It Works
When a player with MiniGunMod.use equips a Minigun, MiniGunMod applies its configured settings to that specific weapon. If the player also has MiniGunMod.vip, the VIP configuration is applied instead.
When hand reloading is enabled, pressing the reload key returns any existing rounds from the magazine to the player's inventory and begins the configured reload process. Reloading includes the Minigun's reload sound effects.
If instant spin-up is enabled, holding primary fire immediately spins and fires the Minigun, subject to the configured ground check and available ammunition.
When the Minigun is no longer being used, the plugin removes its controller and restores the weapon's vanilla settings.