# \ud83d\udd2b SGuns – Advanced Gun System Plugin<\/p>\n
<\/p>\n
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!<\/p>\n
—<\/p>\n
<\/p>\n
## \u2728 Key Features<\/p>\n
### \ud83c\udfaf **25+ Unique Weapons**
\n– **Pistols** \ud83d\udd2b – Glock-17, Desert Eagle, P228, USP-S
\n– **SMGs** \ud83d\udca8 – MP5, UZI, P90, MP7
\n– **Assault Rifles** \u2694\ufe0f – AK-47, M4A1, SCAR-L, FAL, Galil
\n– **Sniper Rifles** \ud83d\udd2d – AWP, Bolt Action, Dragunov, M24
\n– **Shotguns** \ud83d\udca5 – Pump Shotgun, Tactical Shotgun, Double Barrel
\n– **LMGs** \ud83d\udd25 – Minigun, M249
\n– **Special Weapons** \ud83d\ude80 – Rocket Launcher, Grenade Launcher, Flamethrower<\/p>\n
### \ud83d\udca5 **Realistic Gun Mechanics**
\n– \u2705 **Recoil System** – Vertical and horizontal recoil for each weapon
\n– \u2705 **Reload System** – Press F to reload with custom reload times
\n– \u2705 **Ammo Management** – Different ammo types for different weapons
\n– \u2705 **Fire Modes** – Single shot and automatic fire (Shift + Left Click for SMG\/Rifles)
\n– \u2705 **Magazine System** – Limited magazine capacity with reserve ammo<\/p>\n
### \ud83c\udfa8 **Stunning Visual Effects**
\n– \ud83d\udd25 **Muzzle Flash** – Dynamic particle effects when firing
\n– \u2728 **Bullet Trails** – Flame, smoke, and crit particles for visible bullet paths
\n– \ud83d\udca5 **Impact Effects** – Explosion particles on hit
\n– \ud83c\udf1f **Custom Particles** – Unique effects for each weapon type<\/p>\n
### \ud83d\udd2d **Sniper Scope System**
\n– \ud83c\udfaf Right-click to toggle scope (spyglass zoom)
\n– \ud83d\udc0c Slowness effect while scoped for stability
\n– \ud83d\udd12 Anti-dupe protection for scope items
\n– \u26a1 Shoot while scoped with left-click<\/p>\n
### \ud83c\udfaf **Advanced Combat Features**
\n– \ud83d\udc80 **Headshot System** – 2x damage multiplier for headshots
\n– \ud83d\udcca **Live Ammo Display** – Action bar shows current ammo count
\n– \ud83c\udfae **Realistic Bullet Speed** – Fast, real-time bullet velocity
\n– \ud83d\udca3 **Explosive Weapons** – Rockets and grenades with configurable blast radius
\n– \ud83d\udd25 **Flamethrower** – Sets targets on fire<\/p>\n
### \ud83d\udda5\ufe0f **Interactive GUI System**
\n– \ud83d\uded2 **Gun Shop GUI** – Easy weapon and ammo management
\n– \ud83d\uddb1\ufe0f **Left Click** – Get weapon
\n– \ud83d\uddb1\ufe0f **Right Click** – Get 64 ammo
\n– \ud83d\uddb1\ufe0f **Shift + Right Click** – Get full ammo stack
\n– \ud83d\udd12 **Fully Protected** – No item duplication or glitches<\/p>\n
### \u2699\ufe0f **Fully Customizable**
\nConfigure everything in `config.yml`:
\n– \ud83c\udf9a\ufe0f Gun damage
\n– \u23f1\ufe0f Fire rate
\n– \ud83d\udcc8 Recoil strength
\n– \ud83d\udce6 Magazine size
\n– \u23f3 Reload time
\n– \ud83c\udf86 Particle effects
\n– \ud83d\udd0a Sound effects
\n– \ud83d\udca5 Headshot multiplier
\n– \ud83d\udca3 Explosion power<\/p>\n
### \ud83c\udf08 **Beautiful UI**
\n– \ud83c\udfa8 Hex gradient colors
\n– \ud83d\udcdd Small caps styling
\n– \ud83d\udcac Colored chat messages
\n– \ud83c\udfb5 Sound feedback<\/p>\n
—<\/p>\n
## \ud83c\udfae Commands<\/p>\n
| Command | Description | Permission | —<\/p>\n ## \ud83d\udd11 Permissions<\/p>\n – `sguns.use` – Allows using guns (default: true) —<\/p>\n ## \ud83c\udfaf How to Use<\/p>\n ### \ud83d\udd2b Shooting ### \ud83d\udd04 Reloading ### \ud83d\udd2d Sniper Scope ### \ud83d\uded2 GUI Interactions —<\/p>\n ## \ud83d\udce6 Installation<\/p>\n 1. Download the latest `SGuns.jar` —<\/p>\n ## \ud83d\udd27 Requirements<\/p>\n – **Minecraft Version:** 1.20+ —<\/p>\n ## \ud83c\udfa5 Features Showcase<\/p>\n ### Weapon Types<\/p>\n \ud83d\udd2b Pistols – Fast, accurate, low damage ### Combat Mechanics<\/p>\n \u2705 Realistic bullet physics —<\/p>\n ## \ud83c\udf1f Why Choose SGuns?<\/p>\n – \u26a1 **High Performance** – Optimized for minimal lag —<\/p>\n ## \ud83d\udca1 Support & Links<\/p>\n – \ud83d\udc1b **Bug Reports:** Open an issue on Discord —<\/p>\n ## \ud83d\udcdc License<\/p>\n Made with \u2764\ufe0f by **SpacyGaming** for the Minecraft community.<\/p>\n —<\/p>\n **Enjoy the guns! \ud83d\udd2b\u2728**<\/p>\n Transform your server into an action-packed battlefield today!<\/p>\n","protected":false},"excerpt":{"rendered":" A fully configurable Minecraft gun plugin with ammo, recoil, reload, particles, GUI, sniper scope, and action\u2011bar ammo display.<\/p>\n","protected":false},"featured_media":137911,"template":"","meta":{"_minecraft_slug":"sguns","_minecraft_project_id":"M1cv6UZl","_minecraft_author":"spacygaming","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":369,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"sguns.zip","_minecraft_size_bytes":39981,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T11:11:46.772858Z","_minecraft_date_created":"2026-03-02T20:57:58.615321Z","_minecraft_date_modified":"2026-02-24T05:49:23.213502Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/sguns","_minecraft_icon_attachment_id":137911,"_minecraft_imported_at":"2026-06-08T03:44:55+00:00","_minecraft_import_hash":"3f71b7f22498ae2c50bde816a3f258c2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,88,866,127,129,92],"mod_loader":[130,132,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-137910","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-equipment","mod_category-minigame","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/sguns help` | Show all commands | – |
\n| `\/sguns list` | List all available guns | – |
\n| `\/sguns giveweapon
\n| `\/sguns giveammo
\n| `\/sguns gui [player]` | Open gun shop GUI | `sguns.gui` |
\n| `\/sguns reload` | Reload plugin config | `sguns.reload` |<\/p>\n
\n– `sguns.giveweapon` – Allows giving weapons (default: op)
\n– `sguns.giveammo` – Allows giving ammo (default: op)
\n– `sguns.gui` – Allows opening GUI (default: op)
\n– `sguns.reload` – Allows reloading config (default: op)<\/p>\n
\n– **Left Click** – Fire gun (single shot)
\n– **Shift + Left Click** – Automatic fire (SMGs & Assault Rifles only)<\/p>\n
\n– **Press F** (swap hands) – Reload gun
\n– Requires ammo in inventory<\/p>\n
\n– **Right Click** with sniper – Toggle scope
\n– **Left Click** while scoped – Shoot
\n– Automatically equips spyglass in offhand<\/p>\n
\n– **Left Click** – Get weapon
\n– **Right Click** – Get 64 ammo
\n– **Shift + Right Click** – Get full ammo stack<\/p>\n
\n2. Place it in your server’s `plugins\/` folder
\n3. Restart the server
\n4. Edit `plugins\/SGuns\/config.yml` to customize
\n5. Use `\/sguns reload` to apply changes<\/p>\n
\n– **Server Software:** PaperMC (or Spigot\/Paper forks)
\n– **Java Version:** 17+<\/p>\n
\n\ud83d\udca8 SMGs – High fire rate, close range
\n\u2694\ufe0f Rifles – Balanced damage and range
\n\ud83d\udd2d Snipers – High damage, long range, scope
\n\ud83d\udca5 Shotguns – Spread damage, close range
\n\ud83d\udd25 LMGs – High capacity, sustained fire
\n\ud83d\ude80 Special – Explosives and unique effects<\/p>\n
\n\u2705 Weapon-specific recoil patterns
\n\u2705 Headshot detection system
\n\u2705 Ammo management system
\n\u2705 Reload animations (sound-based)
\n\u2705 Fire mode switching
\n\u2705 Scope zoom mechanics<\/p>\n
\n– \ud83c\udfa8 **Beautiful Design** – Gradient colors and modern UI
\n– \ud83d\udd27 **Easy Configuration** – Simple YAML config
\n– \ud83d\udee1\ufe0f **Anti-Exploit** – Protected against duplication glitches
\n– \ud83c\udfaf **Realistic Gameplay** – Authentic gun mechanics
\n– \ud83d\udd04 **Regular Updates** – Active development and support
\n– \ud83d\udcda **Well Documented** – Clear commands and permissions<\/p>\n
\n– \ud83d\udcac **Suggestions:** Share your ideas for new features
\n– \u2b50 **Rate & Review:** Help others discover SGuns!<\/p>\n