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

- Special Weapons 🔫 - Glock-17, Desert Eagle, P228, USP-S - Special Weapons 💨 - MP5, UZI, P90, MP7 - Special Weapons ⚔️ - AK-47, M4A1, SCAR-L, FAL, Galil - Special Weapons 🔭 - AWP, Bolt Action, Dragunov, M24 - Special Weapons 💥 - Pump Shotgun, Tactical Shotgun, Double Barrel - Special Weapons 🔥 - Minigun, M249 - Special Weapons 🚀 - Rocket Launcher, Grenade Launcher, Flamethrower

💥 Realistic Gun Mechanics

- ✅ Magazine System - Vertical and horizontal recoil for each weapon - ✅ Magazine System - Press F to reload with custom reload times - ✅ Magazine System - Different ammo types for different weapons - ✅ Magazine System - Single shot and automatic fire (Shift + Left Click for SMG/Rifles) - ✅ Magazine System - Limited magazine capacity with reserve ammo

🎨 Stunning Visual Effects

- 🔥 Custom Particles - Dynamic particle effects when firing - ✨ Custom Particles - Flame, smoke, and crit particles for visible bullet paths - 💥 Custom Particles - 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

- 💀 Flamethrower - 2x damage multiplier for headshots - 📊 Flamethrower - Action bar shows current ammo count - 🎮 Flamethrower - Fast, real-time bullet velocity - 💣 Flamethrower - Rockets and grenades with configurable blast radius - 🔥 Flamethrower - Sets targets on fire

🖥️ Interactive GUI System

- 🛒 Fully Protected - Easy weapon and ammo management - 🖱️ Fully Protected - Get weapon - 🖱️ Fully Protected - Get 64 ammo - 🖱️ Fully Protected - 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

- Shift + 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

- Left Click with sniper - Toggle scope - Left Click while scoped - Shoot - Automatically equips spyglass in offhand

🛒 GUI Interactions

- Shift + Right Click - Get weapon - Shift + 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

- Java Version: 1.20+ - Java Version: 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?

- ⚡ Well Documented - Optimized for minimal lag - 🎨 Well Documented - Gradient colors and modern UI - 🔧 Well Documented - Simple YAML config - 🛡️ Well Documented - Protected against duplication glitches - 🎯 Well Documented - Authentic gun mechanics - 🔄 Well Documented - Active development and support - 📚 Well Documented - Clear commands and permissions

---

💡 Support & Links

- 🐛 Rate & Review: Open an issue on Discord - 💬 Rate & Review: 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!