Pewpew

Pewpew — это продвинутый плагин для платформ Paper и Purpur, позволяющий настраивать полноценное огнестрельное оружие без использования ресурспаков или программирования.

Pewpew представляет собой полностью управляемый данными (data-driven) плагин для сервера Paper, который позволяет создавать дробовики, винтовки, снайперские системы, SMG и метательные гранаты исключительно через YAML-конфигурации. Оружие в плагине является обычными предметами с персистентными данными, что позволяет им выпадать, торговаться и стакаться как стандартным вещам.

Плагин переносит глубину механик в стиле CrackShot на современное API Paper, включая реальную баллистику, отдачу, систему модулей, типы боеприпасов, а также индивидуальные звуки и эффекты для каждого типа оружия.

Система стрельбы поддерживает два основных режима: Hitscan (мгновенное попадание) и Projectile (снаряды).

• Типы огня: одиночный, автоматический (с соблюдением реальной скорострельности оружия) и очередями.
• Баллистика: расчет траектории полета (дуга) для hitscan-режимов и гравитация для снарядов.
• Разброс: конусы разброса и камера с отдачей, которая увеличивается в процессе стрельбы.
• Дробовики: поддержка многозарядных пуль (buckshot), где каждая поражающая частица разлетается независимо.
• Урон: наличие множителей для попаданий в голову, критических ударов (шанс + множитель), а также затухание урона на дистанции.
• Взаимодействие со щитами: отключение щитов (аналог эффекта топора) при блокировании удара.

Плагин предлагает гибкую систему управления ресурсами и анимацией перезарядки:

• Источники: боеприпасы могут браться из инвентаря по типам или использоваться в системах с бесплатной перезарядкой магазинов.
• Стили перезарядки: стандартные магазины или поштучная перезарядка гильз.
• Механики действия: поддержка циклов болтового и помпового оружия с соответствующими звуками.
• Индикация: количество активных патронов отображается на полоске прочности предмета.

Оружие можно модифицировать через специальное интерфейсное меню (GUI) с использованием Shift+Click:

• Прицелы (Scopes): обеспечивают зум при прицеливании (ADS) и стабилизируют оружие.
• Дульные устройства (Barrels): модификаторы урона и дальности.
• Рукоятки (Grips): снижение отдачи.
• Магазины: модификаторы вместимости и скорости перезарядки.
• Визуализация: индивидуальные частицы следа и попадания для каждого оружия, настраиваемые звуки выстрела и попадания (включая поддержку кастомных звуков из ресурспаков).

Все данные о предметах хранятся в директории plugins/Pewpew/items/ в файлах guns.yml, ammo.yml, attachments.yml и throwables.yml. При первом запуске создаются файлы по умолчанию.

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 ]

Для применения изменений используйте команду /pewpew reload.

Для проверки характеристик оружия предусмотрена специальная цель:

• Команда /dummy создает цель для теста урона, отображающую урон за каждый выстрел и общий урон.
• При использовании Shift+ПКМ на цели она подстроится под параметры брони и щитов игрока.