🔫 SGuns - Advanced Gun System Plugin

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!

---

✨ 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> [amount]	Give ammo to player	sguns.giveammo
/sguns gui [player]	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

---

🌟 Why Choose SGuns?

• ⚡ High Performance - Optimized for minimal lag
• 🎨 Beautiful Design - Gradient colors and modern UI
• 🔧 Easy Configuration - Simple YAML config
• 🛡️ Anti-Exploit - Protected against duplication glitches
• 🎯 Realistic Gameplay - Authentic gun mechanics
• 🔄 Regular Updates - Active development and support
• 📚 Well Documented - Clear commands and permissions

---

💡 Support & Links

• 🐛 Bug Reports: Open an issue on Discord
• 💬 Suggestions: Share your ideas for new features
• ⭐ Rate & Review: Help others discover SGuns!

---

📜 License

Made with ❤️ by SpacyGaming for the Minecraft community.

---

Enjoy the guns! 🔫✨

Transform your server into an action-packed battlefield today!