🔫 SGuns - Advanced Gun System Plugin

GUI

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!

RELOADING

✨ 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

Download the latest SGuns.jar
Place it in your server's plugins/ folder
Restart the server
Edit plugins/SGuns/config.yml to customize
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!