GunPlugin - Оружейный плагин для Minecraft

GunPlugin - это мощный плагин для серверов Minecraft на Paper/Spigot, который добавляет в игру полноценную систему огнестрельного оружия. Если вам надоело сражаться мечами и луками, и хочется чего-то более современного и динамичного - этот плагин полностью изменит ваш геймплей. Он решает проблему однообразия PvP на серверах, добавляя тактическую глубину: теперь важны не только броня и меч, но и умение целиться, контролировать отдачу и вовремя перезаряжаться.

Плагин подходит как для обычных выживалок с элементами современного оружия, так и для полноценных военных серверов, где каждый бой - это тактическое сражение.

Основные возможности

Типы оружия

• Пистолеты - легкие, быстрые, для ближнего боя
• Винтовки - сбалансированы по урону и скорострельности
• Дробовики - разлет дробью, мощь на короткой дистанции
• Снайперские винтовки - высокая точность, урон, но медленная перезарядка

Реалистичная баллистика

• Скорость пули, гравитация и снижение урона с расстоянием
• Пробитие: пуля может проходить сквозь мобов и игроков
• Разброс при движении - чтобы стрелять точно, нужно стоять на месте
• Отдача: визуальный эффект и подброс ствола

Система боеприпасов

• Каждый тип оружия использует свой калибр (9mm, 762 и т.д.)
• Магазины с ограниченной вместимостью
• Ручная перезарядка по клавише F
• Отображение текущего количества патронов

Дополнительные фишки

• Режимы стрельбы: одиночный, автоматический, дробовик
• Хедшоты: попадание в голову дает +30% урона
• Кровавые эффекты: частицы при попадании в мобов
• Звуковое сопровождение:多层次 звуки выстрелов с эхом
• Блокировка взаимодействий: при держании оружия в руках нельзя атаковать или взаимодействовать с блоками левой кнопкой

Установка

Плагин работает на серверах Spigot/Paper для Minecraft 1.21.4. Требуется Java 8 или новее, и желательно от 2 ГБ оперативной памяти.

1. Скачайте GunPlugin.jar
2. Поместите его в папку plugins вашего сервера
3. Перезапустите сервер
4. Настройте конфигурацию в plugins/GunPlugin/config.yml
5. Выдайте игрокам право на использование: /permit gunplugin.use

Настройка

Вся конфигурация делится на два файла:

• guns.yml - полное описание каждого оружия: урон, скорострельность, магазин, звуки, отдача, категория
• config.yml - общие настройки плагина, экономика, магазин покупки оружия

После изменения любого из файлов нужно выполнить /gun reload (требуется права администратора) или перезапустить сервер.

Пример базовой настройки config.yml

settings:
  disable_left_click: true
  disable_right_click_interaction: true
  debug_mode: false

Команды

Все команды начинаются с /gun и требуют права gunplugin.admin:

Команда	Описание
/gun give <игрок> <ID оружия/патроны/граната> [количество]	Выдать предмет
/gun ammo	Посмотреть количество патронов в текущем оружии
/gun ammo reload	Перезарядить оружие
/gun reload	Перезагрузить конфигурацию плагина
/gun help	Показать справку
/gun lang [код]	Просмотреть или сменить язык
/gun modify	Открыть меню модификаций для текущего оружия
/gun buy	Открыть магазин покупки оружия (если включено)

Примеры команд

/gun give @p ak74
/gun give @p 9mm 64
/gun give PlayerName grenade 5
/gun ammo
/gun ammo reload
/gun reload
/gun modify
/gun buy

Права доступа

Право	Описание	По умолчанию
gunplugin.use	Разрешение использовать оружие (стрелять, целиться)	true
gunplugin.admin	Доступ ко всем командам /gun	op

Создание своего оружия

GunPlugin позволяет создавать собственные виды оружия через редактирование guns.yml. Просто скопируйте существующую запись (например, ak74), измените ID (корневой ключ) и настройте параметры под себя.

Обязательные поля

• material - материал предмета в руке
• display_name - отображаемое название
• damage - базовый урон
• rate - скорострельность в RPM (выстрелов в минуту)
• magazine - вместимость магазина
• reload_duration - время перезарядки в секундах
• fly_speed - скорость пули
• bullet_drop - гравитация пули
• penetration - пробиваемость
• movement_spread - разброс при движении
• ammo - тип боеприпасов
• is_automatic - автоматический режим
• is_shotgun - дробовик
• is_sniper - снайперская винтовка
• category - категория (pistol, rifle и т.д.)
• reload_mode - режим перезарядки
• bolt_after_shot -是否需要 передергивать затвор после выстрела
• attachments - список доступных модификаций
• sounds - звуки выстрела, перезарядки, затвора
• recoil - параметры отдачи (стиль normal или pattern)

Пример минимальной записи

my_custom_rifle:
  material: IRON_HORSE_ARMOR
  display_name: "Кастомная винтовка"
  magazine: 30
  damage: 5.0
  rate: 600
  fly_speed: 100
  bullet_drop: 0.05
  reload_duration: 2.5
  penetration: 1
  movement_spread: 0.5
  ammo: 762
  is_automatic: true
  is_shotgun: false
  is_sniper: false
  category: rifle
  reload_mode: magazine
  bolt_after_shot: false
  attachments: []
  sounds: { fire: [...], reload: [...], bolt: [] }
  recoil: { style: normal, ... }

Важно знать

• Если несколько видов оружия используют одинаковый материал, их невозможно отличить в инвентаре без использования плагина. Лучше задавать разные материалы.
• Цены на покупку оружия настраиваются в config.yml, а не в guns.yml.
• Плагин поддерживает только Minecraft 1.21.x.
• Для изменения разброса редактируйте параметры movement_spread и recoil в guns.yml.

GunPlugin - отличный выбор для серверов, где хочется добавить современное оружие без установки модов. Он полностью настраиваемый, производительный и дает игрокам совершенно новый опыт сражений.