Pewpew

# Pewpew A fully data driven gun plugin for Paper 1.21.11. Build guns, shotguns, snipers, SMGs, throwables, and attachments entirely in YAML, with no code and no resource pack required. Every weapon is a normal item identified by persistent data, so guns drop, trade, and stack like anything else. Pewpew brings CrackShot-style depth to the modern Paper API: real ballistics, recoil, attachments, ammo, and per weapon sounds and effects, all configurable. # Features ## Shooting - Hitscan and projectile firing modes - Semi-auto and full-auto (hold to fire at the weapon's true fire rate) - Burst fire, spread cones, and camera recoil that climbs as you shoot - Bullet drop (ballistic arc for hitscan, gravity for projectiles) - Multi-pellet buckshot, each pellet independently spread ## Ammo & Reloading - Inventory-fed ammo by type, or free-reloading magazines - Magazine and shell-by-shell reload styles - Bolt/pump firearm action with cycle sounds - Live ammo count shown as the item's durability bar ## Combat Depth - Headshot multipliers with a hitmarker ping - Critical hits (chance plus multiplier, stacks with headshots) - Damage falloff over distance - Shield disable, applying the axe effect to blocking players - On-hit potion effects for victim and shooter - Custom per-weapon death messages - Real projectile damage, so Projectile Protection, knockback, and kill credit all work ## Attachments - Scopes with aim-down-sights zoom that steadies the weapon - Barrels with damage and range modifiers - Grips with recoil reduction - Magazines with capacity and reload-speed modifiers - Fitted in a clean shift-click bench GUI, with stats rendered automatically on the item ## Presentation - Per-weapon trail and impact particles - Configurable fire and hit sounds with volume and pitch, including custom resource-pack sounds - Throwables: explosion, smoke, flash, poison, incendiary ## Tooling - /dummy damage-test target showing per-hit and total damage. Shift-right-click it to fit armor and shields. ## Configuration Items live in plugins/Pewpew/items/ (guns.yml, ammo.yml, attachments.yml, throwables.yml). Defaults are generated on first run. Edit, then run /pewpew reload. ``` ak47: type: GUN name: "AK-47" itemModel: "minecraft:iron_horse_armor" baseDamage: 8.5 fireRate: 4 maxAmmo: 30 ammoType: rifle_round consumesAmmo: true automatic: true firingMode: PROJECTILE projectileSpeed: 3.5 range: 64.0 spread: 2.0 recoil: 1.2 headshotMultiplier: 1.5 allowedAttachmentSlots: [ SCOPE, BARREL, GRIP, MAGAZINE ] ``` A full field reference is included in the docs on GitHub.