CombatGunSSS

[1.0.0] - 2026-04-02

Added

Weapons

• 39 Ranged Weapons across 5 categories:
  • Assault Rifles: AK47, M4A1, SCAR, AUG, FAMAS, G36, Groza, AN94, M14, ParaFAL, XM8, Kingfisher
  • SMGs: MP5, P90, Vector, Bizon, UMP, Thompson, MAC-10, MP40, VSS, CG15
  • Snipers: AWM, M24, Kar98k, M82B, M107, VSK94
  • Shotguns: M1014, SPAS-12, MAG-7, M1887, M590, Trogon
  • Pistols: Desert Eagle, G18, USP, M1917, M1873, M500
• 6 Melee Weapons: Bat, Knife, Pan, Parang, Katana, Scythe

Combat System

• Hitscan shooting mechanics with ray-tracing
• Per-weapon recoil (pitch/yaw), spread, and recovery
• Damage falloff based on distance traveled
• Headshot detection and multipliers
• Block penetration through soft materials
• Entity penetration for multi-target shots
• Knockback system for both ranged and melee
• Movement spread penalty while sprinting/jumping
• Burst fire support with configurable delays
• Shotgun pellet spread mechanics

Melee System

• Left-click attack mechanics (EntityDamageByEntityEvent)
• Range check (4 blocks default)
• Separate cooldown system from ranged weapons
• Knockback on melee hits
• Sound effects at target location
• Cooldown feedback in action bar

Crafting System

• Mechanical Crafting Table (21-slot GUI)
• Vanilla Crafting Table component recipes
• Recipe Book with visual browser
• Per-item ingredient requirements
• Non-grid-based crafting interface
• Output preview with weapon stats

Ammo System

• 5 Ammo Types: AR, SMG, Sniper, Shotgun, Handgun
• Magazine system with reload mechanics
• Swap-hand [F] key reload
• Durability system for weapons
• Auto-reload when empty

Configuration

• Per-weapon YAML configuration files
• Separated folder structure: guns/ and melees/
• Custom weapon support (add your own YAML files)
• World whitelist/blacklist support
• Mob drop configuration
• Custom Model Data support for resource packs

Developer API

• Public API class: CombatGunAPI
• Query gun data and recipes
• Create gun/ammo/component items programmatically
• Check item types and player state
• World permission checks

Commands

• /gun give <id> [player] - Give weapons
• /gun giveammo <id> [amount] [player] - Give ammo
• /gun givepart <id> [amount] [player] - Give components
• /gun station [player] - Give crafting table
• /gun book [player] - Give recipe book
• /gun list [category] - List all weapons
• /gun recipe <id> - Show crafting chain
• /gun inspect [player] - Inspect held weapon
• /gun reload - Reload configurations

Permissions

• combatgun.admin - Access to all admin commands
• combatgun.use - Allow using guns (default: true)
• combatgun.use.<gun_id> - Per-weapon permissions

Visual Effects

• Bullet trail particles
• Muzzle flash effects
• Hit particles and sound effects
• Headshot particle effects
• Block impact particles
• Sweep attack particles for melee
• Action bar ammo display
• Action bar cooldown feedback

Technical

• Paper/Spigot 1.21+ API support
• Java 21 requirement
• Persistent data container for item storage
• Tab completion for all commands
• Optimized ray-tracing with entity filtering

Notes

• Initial release after extensive testing
• All 45 weapons balanced and configured
• Full documentation and examples provided
• Ready for production servers

---

Future Roadmap

Planned for 1.1.0

• Scope zoom mechanic for sniper rifles
• Weapon attachment system
• More melee weapons
• Explosive weapons (RPG, Grenades)

Planned for 1.2.0

• Player statistics tracking
• Leaderboard system
• Kill/death tracking
• Weapon usage statistics

---