🔫 SGuns v1.0 - Initial Release

🎉 Initial Release

Welcome to SGuns - The ultimate gun system plugin for Minecraft!

---

✨ New Features

🎯 Weapons System

• ✅ Added 25+ unique weapons across 7 categories
• ✅ 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

💥 Combat Mechanics

• ✅ Realistic recoil system (vertical & horizontal)
• ✅ Weapon-specific fire rates
• ✅ Single shot mode for all weapons
• ✅ Automatic fire mode (Shift + Left Click for SMGs & Rifles)
• ✅ Magazine system with limited capacity
• ✅ Reload system (Press F to reload)
• ✅ Ammo management with different ammo types

🎯 Advanced Features

• ✅ Headshot system with 2x damage multiplier
• ✅ Live ammo display on action bar
• ✅ Real-time bullet velocity (10x faster than default)
• ✅ Sniper scope system with spyglass zoom
• ✅ Shoot while scoped functionality
• ✅ Anti-dupe protection for scope items

🎨 Visual Effects

• ✅ Muzzle flash particles
• ✅ Bullet trail effects (Flame, Smoke, Crit)
• ✅ Impact explosion particles
• ✅ Weapon-specific particle effects
• ✅ Beautiful hex gradient colors
• ✅ Small caps UI styling

🖥️ GUI System

• ✅ Interactive gun shop GUI
• ✅ Left click to get weapon
• ✅ Right click to get 64 ammo
• ✅ Shift + Right click for full ammo stack
• ✅ Complete anti-dupe protection
• ✅ Frozen GUI (items cannot be moved)

⚙️ Configuration

• ✅ Fully customizable config.yml
• ✅ Configure damage, fire rate, recoil
• ✅ Customize magazine size, reload time
• ✅ Adjust particle and sound effects
• ✅ Set headshot multiplier
• ✅ Configure explosion power

🎮 Commands & Permissions

• ✅ /sguns help - Show all commands
• ✅ /sguns list - List all guns
• ✅ /sguns giveweapon - Give weapons
• ✅ /sguns giveammo - Give ammo
• ✅ /sguns gui - Open gun shop
• ✅ /sguns reload - Reload config
• ✅ Full permission system

🔧 Technical Features

• ✅ Optimized for high performance
• ✅ No lag with multiple players shooting
• ✅ Clean code architecture
• ✅ Proper event handling
• ✅ InventoryHolder implementation for GUI
• ✅ Anti-exploit protection

---

🎯 Weapon Statistics

Pistols

• Glock-17: 4.5 damage, 17 rounds, 8 fire rate
• Desert Eagle: 8.0 damage, 7 rounds, 4 fire rate
• P228: 5.0 damage, 13 rounds, 7 fire rate
• USP-S: 4.0 damage, 12 rounds, 6 fire rate

SMGs

• MP5: 3.5 damage, 30 rounds, 15 fire rate
• UZI: 3.0 damage, 25 rounds, 18 fire rate
• P90: 3.2 damage, 50 rounds, 20 fire rate
• MP7: 3.3 damage, 30 rounds, 17 fire rate

Assault Rifles

• AK-47: 6.5 damage, 30 rounds, 10 fire rate
• M4A1: 5.5 damage, 30 rounds, 12 fire rate
• SCAR-L: 6.0 damage, 30 rounds, 11 fire rate
• FAL: 7.0 damage, 20 rounds, 8 fire rate
• Galil: 5.8 damage, 35 rounds, 11 fire rate

Sniper Rifles

• AWP: 20.0 damage, 5 rounds, 1 fire rate
• Bolt Action: 18.0 damage, 5 rounds, 1 fire rate
• Dragunov: 15.0 damage, 10 rounds, 2 fire rate
• M24: 17.0 damage, 5 rounds, 1 fire rate

---

🔧 Requirements

• Minecraft 1.20+
• PaperMC (or Spigot/Paper forks)
• Java 17+

---

📝 Known Issues

None! This is a stable initial release.

---

🙏 Credits

• Author: SpacyGaming
• Version: 1.0.0
• Release Date: 2026

---

Thank you for using SGuns! 🔫✨

Report bugs and suggest features on Discord!