SGuns

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

---

🔑 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!