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.
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: "<gray>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.
