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