Pewpew

!(https://cdn.modrinth.com/data/iSOIGWo3/images/3bb67025595bed67015e5f332f2b7ca945292ff1.png)

A fully data driven gun plugin for Paper. 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.

## 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

- /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.

!(https://bstats.org/signatures/bukkit/pewpew.svg)