SGuns

# 🔫 SGuns - Advanced Gun System Plugin !(https://imagedelivery.net/W9K_l6ndK9x4x8m3rurakg/2c3ce240-621f-4370-b671-485f23ab9400/original) Transform your Minecraft server into an action-packed battlefield with **SGuns**, the ultimate weapon system plugin featuring realistic gun mechanics, stunning visual effects, and extensive customization options! --- !(https://imagedelivery.net/W9K_l6ndK9x4x8m3rurakg/bc01eaa9-4e09-44d6-f5b4-071eb2445b00/original) ## ✨ Key Features ### 🎯 **25+ Unique Weapons** - **Pistols** 🔫 - Glock-17, Desert Eagle, P228, USP-S - **SMGs** 💨 - MP5, UZI, P90, MP7 - **Assault Rifles** ⚔️ - AK-47, M4A1, SCAR-L, FAL, Galil - **Sniper Rifles** 🔭 - AWP, Bolt Action, Dragunov, M24 - **Shotguns** 💥 - Pump Shotgun, Tactical Shotgun, Double Barrel - **LMGs** 🔥 - Minigun, M249 - **Special Weapons** 🚀 - Rocket Launcher, Grenade Launcher, Flamethrower ### 💥 **Realistic Gun Mechanics** - ✅ **Recoil System** - Vertical and horizontal recoil for each weapon - ✅ **Reload System** - Press F to reload with custom reload times - ✅ **Ammo Management** - Different ammo types for different weapons - ✅ **Fire Modes** - Single shot and automatic fire (Shift + Left Click for SMG/Rifles) - ✅ **Magazine System** - Limited magazine capacity with reserve ammo ### 🎨 **Stunning Visual Effects** - 🔥 **Muzzle Flash** - Dynamic particle effects when firing - ✨ **Bullet Trails** - Flame, smoke, and crit particles for visible bullet paths - 💥 **Impact Effects** - Explosion particles on hit - 🌟 **Custom Particles** - Unique effects for each weapon type ### 🔭 **Sniper Scope System** - 🎯 Right-click to toggle scope (spyglass zoom) - 🐌 Slowness effect while scoped for stability - 🔒 Anti-dupe protection for scope items - ⚡ Shoot while scoped with left-click ### 🎯 **Advanced Combat Features** - 💀 **Headshot System** - 2x damage multiplier for headshots - 📊 **Live Ammo Display** - Action bar shows current ammo count - 🎮 **Realistic Bullet Speed** - Fast, real-time bullet velocity - 💣 **Explosive Weapons** - Rockets and grenades with configurable blast radius - 🔥 **Flamethrower** - Sets targets on fire ### 🖥️ **Interactive GUI System** - 🛒 **Gun Shop GUI** - Easy weapon and ammo management - 🖱️ **Left Click** - Get weapon - 🖱️ **Right Click** - Get 64 ammo - 🖱️ **Shift + Right Click** - Get full ammo stack - 🔒 **Fully Protected** - No item duplication or glitches ### ⚙️ **Fully Customizable** Configure everything in `config.yml`: - 🎚️ Gun damage - ⏱️ Fire rate - 📈 Recoil strength - 📦 Magazine size - ⏳ Reload time - 🎆 Particle effects - 🔊 Sound effects - 💥 Headshot multiplier - 💣 Explosion power ### 🌈 **Beautiful UI** - 🎨 Hex gradient colors - 📝 Small caps styling - 💬 Colored chat messages - 🎵 Sound feedback --- ## 🎮 Commands | Command | Description | Permission | |---------|-------------|------------| | `/sguns help` | Show all commands | - | | `/sguns list` | List all available guns | - | | `/sguns giveweapon <player> <gun>` | Give a gun to player | `sguns.giveweapon` | | `/sguns giveammo <player> <gun> ` | Give ammo to player | `sguns.giveammo` | | `/sguns gui ` | Open gun shop GUI | `sguns.gui` | | `/sguns reload` | Reload plugin config | `sguns.reload` | --- ## 🔑 Permissions - `sguns.use` - Allows using guns (default: true) - `sguns.giveweapon` - Allows giving weapons (default: op) - `sguns.giveammo` - Allows giving ammo (default: op) - `sguns.gui` - Allows opening GUI (default: op) - `sguns.reload` - Allows reloading config (default: op) --- ## 🎯 How to Use ### 🔫 Shooting - **Left Click** - Fire gun (single shot) - **Shift + Left Click** - Automatic fire (SMGs & Assault Rifles only) ### 🔄 Reloading - **Press F** (swap hands) - Reload gun - Requires ammo in inventory ### 🔭 Sniper Scope - **Right Click** with sniper - Toggle scope - **Left Click** while scoped - Shoot - Automatically equips spyglass in offhand ### 🛒 GUI Interactions - **Left Click** - Get weapon - **Right Click** - Get 64 ammo - **Shift + Right Click** - Get full ammo stack --- ## 📦 Installation 1. Download the latest `SGuns.jar` 2. Place it in your server's `plugins/` folder 3. Restart the server 4. Edit `plugins/SGuns/config.yml` to customize 5. Use `/sguns reload` to apply changes --- ## 🔧 Requirements - **Minecraft Version:** 1.20+ - **Server Software:** PaperMC (or Spigot/Paper forks) - **Java Version:** 17+ --- ## 🎥 Features Showcase ### Weapon Types 🔫 Pistols - Fast, accurate, low damage 💨 SMGs - High fire rate, close range ⚔️ Rifles - Balanced damage and range 🔭 Snipers - High damage, long range, scope 💥 Shotguns - Spread damage, close range 🔥 LMGs - High capacity, sustained fire 🚀 Special - Explosives and unique effects ### Combat Mechanics ✅ Realistic bullet physics ✅ Weapon-specific recoil patterns ✅ Headshot detection system ✅ Ammo management system ✅ Reload animations (sound-based) ✅ Fire mode switching ✅ Scope zoom mechanics