CombatGunSSS

[2.0.0] - 2026-04-12

Added

Weapon Attachment System

• Four attachment types with stackable stat modifiers:
  • SILENCER — reduces sound radius (config: sound_radius_multiplier) with optional damage penalty.
  • EXTENDED_MAG — adds flat magazine capacity (config: magazine_bonus).
  • GRIP — reduces pitch recoil and bullet spread (config: recoil_pitch_multiplier, spread_multiplier).
  • SCOPE — enables precision scope spread at runtime, even on guns where scopeable: false.
• Each gun holds at most one attachment per slot. Attaching a second of the same type replaces the first.
• Attachments persist on the gun item via PersistentDataContainer keys (combatgun:attach_silencer, etc.).
• Commands: /gun attach <id>, /gun detach <TYPE>, /gun attachments (inspect held gun).
• Config: Defined under combatgun.attachments.<id> in config.yml. Five built-in definitions included (silencer, extended_mag_ar, extended_mag_smg, tactical_grip, acog_scope).
• AttachmentManager exposes stat modifier helpers used at shoot time: soundMultiplier(), damageMultiplier(), magBonus(), spreadMultiplier(), recoilPitchMultiplier(), hasScopeAttachment().

Throwable Items (Grenades)

• Three throwable types, all thrown as Snowball projectiles and detonated on ProjectileHitEvent or after fuse:
  • FRAG — Creates a visual explosion and deals falloff damage to nearby entities.
  • SMOKE — Spawns a timed smoke particle cloud (campfire smoke particles for 10 seconds by default).
  • FLASHBANG — Applies Blindness and Slowness (simulated deafness) to nearby players, scaled by distance.
• Command: /gun givethrowable <id> [player].
• Config: Defined under combatgun.throwables.<id> with full control over fuse, radius, damage, duration, and effect ticks. Three built-in throwables included.
• ThrowableListener handles right-click throw and projectile landing. Registered as a separate listener from GunListener.
• Projectiles are tracked in ThrowableManager.liveProjectiles and auto-detonate after fuse_ticks if they don't land.

Kill Statistics & Leaderboard

• New StatsManager backed by SQLite (plugins/CombatGunSSS/stats.db). No external database required.
• Tracks per-player: kills, deaths, headshots, and per-gun kill counts.
• Write buffer flushes to DB every 5 minutes and on plugin disable — minimises disk writes while keeping data safe.
• Commands: /gun stats [player] (view stats), /gun leaderboard (top 10 by kills).
• New PlaceholderAPI placeholders: %combatgun_kills%, %combatgun_deaths%, %combatgun_headshots%, %combatgun_kd%.
• EntityDeathListener now calls StatsManager.recordKill() and recordDeath() on every gun kill.
• SQLite JDBC shaded into the jar via maven-shade-plugin with relocation to dev.duong2012g.combatgun.libs.sqlite — no external jar needed.

Changed

• CombatGunSSSPlugin — registers AttachmentManager, ThrowableManager, StatsManager; registers ThrowableListener; onDisable() calls statsManager.shutdown(); startup log prints attachment/throwable counts and stats DB status.
• GunCommand — added attach, detach, attachments, givethrowable, stats, leaderboard to SUB_COMMANDS, switch, tab completion, and help.
• PlaceholderHook — added kills, deaths, headshots, kd placeholders (total 12 placeholders now).
• EntityDeathListener — records kill/death to StatsManager on every confirmed gun kill.
• plugin.yml — version bumped to 2.0.0.
• pom.xml — version bumped to 2.0.0; added sqlite-jdbc 3.45.1.0 as compile dependency; added maven-shade-plugin to shade and relocate SQLite.
• config.yml — added combatgun.attachments and combatgun.throwables sections with default definitions.

---