Pewpew

Nothing in this release changes how your existing guns behave. Every new option defaults to what Pewpew did before, and the one behaviour that had to change is switched back on automatically for servers upgrading.

Config safety

• Config migrations. config.yml now carries a config-version. Pewpew migrates it on startup, keeps a .bak of the previous version next to it, and logs exactly what it changed.
• Typos are reported. Unknown fields in an item file used to be ignored in silence. spred: 2.0 or bulletcount: 8 now logs a warning naming the item, the file and the field. The item still loads.

Item files

New advanced: section in config.yml, all options off by default:

• extends: <id> copies another item's fields, then applies its own on top. The parent can live in any file in items/, so your own files can build on the bundled weapons, and chains work.
• abstract: true makes an entry a template only: never registered, never given, and it needs no name or itemModel.
• ammo-stats turns on the ammo stats below.

Shooting

• Spray patterns. Give a gun a fixed pattern of [horizontal, vertical] steps and recoil becomes something players can learn and pull against instead of a dice roll. patternLoop and patternReset control what happens past the end of the pattern and how long a pause resets it.
• Movement accuracy. spreadModifiers scales spread by what the shooter is doing: sprinting, walking, sneaking, standing, plus midair and inWater on top.
• Bloom. bloomPerShot, bloomMax and bloomDecay widen the cone while you hold the trigger and close it again when you stop.
• Ammo stats. Ammo items can carry damageMultiplier, velocityMultiplier and penetration (entities a shot passes through). Ammo multiplies the gun's numbers, it never replaces them, so baseDamage and damageType stay in charge. A gun remembers which ammo was loaded into it.
• damageType per gun. Defaults to minecraft:arrow as before. Set minecraft:generic for damage that ignores armor and Protection, so your configured numbers land exactly.
• burstDelay is configurable instead of a fixed 2 ticks.
• Multiple fire and hit sounds per weapon.
• Decimal fire rates, so a gun can fire faster than once per tick.

Fixed

• Bullet spread was not a cone. It rotated around the world axes, giving a square spread that shrank as you looked up or down. It is now a true cone of spread degrees in every direction. Upgrading servers keep the old maths via compatibility.legacy-spread; turn it off and retune spread when you are ready.
• Two memory leaks: hit tracking and per-player shooting state grew forever. Quitting now also cancels in-flight reload and autofire tasks.
• The OpenMinetopia hook silently allowed weapon use if its reflection broke. It now logs once and blocks until fixed or disabled.
• Legacy § colour codes are stripped from messages instead of reaching chat.

Permissions

• All command permissions are declared, with a pewpew.* parent.
• pewpew.use.<id> per item, defaulting to allowed. Negate it (-pewpew.use.awm) to stop a group shooting, throwing, or attaching to that item.

Developer API and Skript

• Five new events: kill, reload complete, scope, attachment, and hit block. Scope and attachment are cancellable; the kill event lets you rewrite the death message.
• Skript grows to 11 events, 9 expressions and 6 conditions, including pewpew ammo and pewpew bloom (both writable), pewpew attachment id, pewpew death message, and conditions like player is scoped in or the pewpew hit was a headshot.
• Skript is documented for the first time, in assets/docs/skript.md.

Integrations

• OpenMinetopia: blocks weapon use while handcuffed and in configured cities or worlds.

Internal

• JUnit tests (31) covering migrations, spread geometry, extends resolution and recoil patterns, plus a GitHub Actions build.
• -dev builds publish to the snapshots repository instead of releases.