
一款完全基于数据的 Paper 服务器枪械插件。使用 YAML 配置构建步枪、霰弹枪、狙击枪、冲锋枪、投掷物及配件,无需编写代码,也无需资源包。每把武器都是一个通过持久化数据标识的正常物品,因此它们可以像其他物品一样掉落、交易和堆叠。
Pewpew 将 CrackShot 风格的深度带入现代 Paper API:真实的弹道、后坐力、配件、弹药以及可配置的专属音效与特效。
功能特性
射击
- 射线检测(Hitscan)与实体投射物两种射击模式
- 半自动与全自动(按住以按武器的真实射速持续射击)
- 点射、散布锥体,以及随着射击增加的上扬镜头后坐力
- 子弹下坠(射线检测采用弹道弧线,投射物受重力影响)
- 多弹丸鹿弹,每个弹丸独立散布
弹药与换弹
- 按类型从库存提供弹药,或支持自由装填的弹匣
- 弹匣式与逐发上膛两种换弹方式
- 栓动/泵动式枪械动作,配有循环音效
- 实时弹药数量显示在物品的耐久度条上
战斗深度
- 爆头倍率加成,并伴有命中提示音
- 暴击机制(概率与倍率,可与爆头效果叠加)
- 随距离衰减的伤害
- 护甲无效化,对格挡玩家施加斧头效果
- 命中时为目标和攻击者施加药水效果
- 自定义的专属武器击杀信息
- 真实的投射物伤害判定,使“保护型击退”、“击退抗性”和“击杀荣誉”等机制正常生效
配件
- 瞄准镜:具备腰射至开镜(Aim Down Sights)缩放功能,稳定武器视角
- 枪管:提供伤害与射程修正
- 握把:降低后坐力
- 弹匣:调整容量与换弹速度
- 通过简洁的 Shift+点击工作台 GUI 进行安装,属性会自动渲染在物品上
表现效果
- 专属武器的轨迹粒子与命中粒子
- 可配置的射击与命中音效,包含音量与音调调节,支持自定义资源包音效
- 投掷物:爆炸、烟雾、闪光、毒药、燃烧弹
工具
/dummy伤害测试靶:显示单次命中伤害与总伤害。Shift+右键点击该靶子可为其装备盔甲与盾牌。
配置
物品文件位于 plugins/Pewpew/items/ 目录下(包括 guns.yml, ammo.yml, attachments.yml, throwables.yml)。首次运行时自动生成默认配置。编辑后运行 /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 ]
完整的字段参考请参见 GitHub 上的文档。

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.
下载 Pewpew
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Pewpew
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Pewpew
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Pewpew
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Pewpew
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Pewpew
下载 Pewpew
下载 Pewpew
下载 Pewpew
下载 Pewpew
自 26.1.1 以来的变更。
⚠️ 更新前请阅读
- 自动装填默认关闭。现在空枪击发仅进行干击发。在 config.yml 中设置 auto-reload: true 以恢复旧版行为。即使开启此选项,按住全自动枪械的扳机也不会开始装填;玩家必须再次按下扳机。
- 切换快捷栏槽位会取消正在进行的装填。
- 每种投掷物现在拥有独立的冷却时间。此前所有投掷物共享一个 0.5 秒的冷却时间。
- 未配置 deathMessage 的枪械将使用 messages.yml 中的新枪械死亡消息,而非原版死亡消息。
弹匣(需通过 advanced.magazines: true 启用)
- 新增文件 items/magazines.yml 中的 MAGAZINE 物品类型。每个弹匣独立存储弹药。
- 装填时会替换入容量最大的兼容弹匣。旧弹匣连同剩余弹药一起返回你的物品栏。
- 每把枪械都有一个弹膛,可额外容纳一发子弹,因此 30 发容量的弹匣可提供 31 次射击。
- 弹匣可以容纳混合弹药。弹药遵循后进先出顺序发射,每次射击均使用对应弹药的属性。
- 在物品栏中将弹药点击到弹匣上即可填充弹匣。
- 潜行 + F 键可弹出弹匣且不执行装填。
- 枪械可通过 magazines 列表限制可使用的弹匣类型。
- 新增弹匣字段:capacity、reloadModifier、modelSuffix 和 gunModelData。两个模型字段用于为不同弹匣切换枪械模型。
- 若无可用弹匣,枪械会将散装弹药装入弹膛。
- 新增消息:reloaded 和 no-magazine。
模型与动画
- animations:逐帧模型交换,涵盖开火、装填、装填单发、开镜和收镜动画。装填动画会根据枪械的实际装填时间拉伸适配。
- rig:由多个移动部件(带关键帧的物品显示实体)构建的动画,支持第一人称视角或附加于玩家身上。
- holdPose:CROSSBOW 模式下,双手持握物品,如同拉满的弩。
- 瞄准时改变模型:aimModelSuffix 和 aimModelData。
- animationCooldown 控制是否在动画播放期间允许开火。
- color:为任意物品赋予染料颜色(格式为 "#RRGGBB" 或 "R, G, B"),例如染色皮革胸甲。
战斗
- scopedRecoil:瞄准时拥有独立的后坐力值。
- 子弹命中效果:子弹会在命中的方块上留下痕迹(impacts.enabled、impacts.max-per-gun)。
- 可破碎玻璃:子弹可击碎玻璃并继续飞行。玻璃将在 glass.restore-after-seconds 秒后或在服务器关闭时恢复。
- 新增 TEAR_GAS 投掷物效果,支持可配置的 gasEffects。佩戴防毒面具的玩家受到保护(tear-gas.gas-masks)。
- 投掷物新增冷却时间字段(单位:刻,默认值为 10)。
- 弹药新增字段:
- fireTicks 使目标着火。
- payload 使弹药发射投掷物,从而使同一发射器可发射不同类型的榴弹。
- 枪械新增字段:defaultAttachments 可通过 forced: true 固定某个配件位置。
- 投掷物新增死亡消息:throwable-death。
音效
- 新增 sounds.yml 覆盖插件播放的所有音效:枪械、装填、弹匣、命中、爆炸、投掷物和菜单。
- 每种音效可以是原版音效、资源包音效、多个音效叠加,或设为无以静音。
Skript 支持
- 新增表达式:
- pewpew magazine of %players%
- pewpew magazine rounds of %players%
- pewpew chamber of %players%
- 新增效果:
- eject the pewpew magazine from %player%
- play pewpew animation "<event>" for %player% [over %n% ticks]
- play pewpew sound "<key>" to %player% / at %location%
修复
- 后坐力恢复不再在微小准星偏移发生前取消该偏移。
- 装填中断逻辑更严格(切换槽位现会取消装填)。
内部
- 项目拆分为 core(跨平台核心)和 paper 模块。
- Gradle 包装器已更新。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
使床在所有维度中爆炸的模组
插件
为 Armor Poser 模组添加兼容性
插件
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
插件
一个高度兼容、功能完善且稳定的 TPA 模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧