- Документация
- https://modrinth.com/plugin/gunplugin
GunPlugin — серверный плагин для Minecraft Java Edition с несколькими типами оружия, боеприпасами, режимами стрельбы и настраиваемой баллистикой. Проект относится к игровой механике и экипировке, распространяется по MIT и не требует установки своего JAR на клиент. В метаданных подтверждены Bukkit, Folia, Paper, Purpur и Spigot, а также Minecraft 1.21–1.21.11.
Плагин добавляет пистолеты, винтовки, дробовики и снайперские винтовки. Подтверждены магазины, отображение патронов, перезарядка, одиночный, серийный и дробовой огонь. Автоогонь работает при удержании правой кнопки, ручная перезарядка — клавишей F.
Заявлены скорость и падение пули, проникновение, рост разброса в движении, отдача, частицы, звуки и 30% дополнительного урона за попадание в голову. При оружии в руке отключаются обычная левая атака и правое взаимодействие. Точные формулы и пределы не приведены.
GunPlugin подходит PvP-серверам, аренам и приключенческим режимам без обязательного клиентского мода. Администрация должна быть готова настраивать предметы и тестировать бой.
До внедрения определяют:
• выдачу оружия и патронов;
• разрешённые миры и безопасные зоны;
• сохранение предметов после смерти;
• допустимые режимы огня;
• учёт убийств и урона;
• конфликт клавиши F;
• работу дверей, контейнеров и NPC при оружии в руке.
В выживании система меняет ценность брони, щитов, луков и укрытий, поэтому требует пересмотра баланса.
Выбранные метаданные перечисляют Minecraft 1.21–1.21.11 и платформы Bukkit, Folia, Paper, Purpur и Spigot. Серверная сторона обязательна, клиентская отмечена как неподдерживаемая. Обязательные project dependencies не указаны.
В руководстве отдельно названы Minecraft 1.21.4, Spigot или Paper, Java 8+ и рекомендация 2 ГБ памяти. Эти сведения уже метаданных и не привязаны к каждой сборке, поэтому конкретный JAR нужно проверять на выбранном ядре.
Отдельного теста требуют Folia, Purpur, античит, регионы, кастомные сущности, системы брони, статистика урона и кроссплатформенный вход.
Подтверждённый способ — поместить JAR в папку plugins совместимого сервера. После запуска официальный текст предусматривает редактирование файла конфигурации в каталоге GunPlugin, но точные ключи в предоставленном фрагменте не раскрыты.
Порядок внедрения:
• сохранить мир, конфигурации и список плагинов;
• записать версии ядра и среды запуска;
• сверить имя, размер и хеш JAR;
• установить файл в plugins;
• запустить тестовую копию;
• изучить журнал и созданную конфигурацию;
• получить одно тестовое оружие штатным административным способом;
• проверить стрельбу, боеприпасы и перезарядку;
• затем переносить плагин на рабочий сервер.
Исходную конфигурацию сохраняют, а параметры меняют по одной группе с повторной проверкой.
Приёмка охватывает:
• одиночный, серийный и дробовой огонь;
• опустошение магазина и перезарядку F;
• стрельбу стоя и в движении;
• дальнюю траекторию;
• попадание в голову;
• препятствия и проникновение;
• остановку автоогня;
• сохранение предмета после перезапуска.
Также проверяют урон игрокам и мобам, броню, регионы, частицы, звуки и взаимодействия. Заявленные 30% за попадание в голову измеряют на нескольких целях. Результат приемлем, если ограничения не обходятся, данные сохраняются, а ошибок нет.
Официальное описание подтверждает создание пользовательского оружия через конфигурацию. Это даёт гибкость, но сочетание высокого урона, скорострельности, ёмкого магазина и малого разброса может резко изменить баланс.
Настройку начинают с одного пистолета, затем проверяют винтовку и дробовик, урон на дистанциях, разброс в движении, перезарядку и боезапас. После этого добавляют новые образцы. Названия ключей не приведены, поэтому параметры берут из фактической конфигурации выбранной версии.
GunPlugin меняет не только урон, но и управление. Отключение обычной атаки и правого взаимодействия может конфликтовать с меню, NPC, контейнерами и предметами. Автоматический огонь увеличивает число событий, звуков и частиц, а баллистика и проникновение требуют проверки нагрузки.
Не подтверждены полный каталог, рецепты и экономика патронов, встроенные матчи, конкретный античит, обязательный пакет ресурсов, дружественный огонь, ограничения по мирам, обратная совместимость предметов и пределы проникновения. Без стенда нельзя оценить баланс, клавиши и нагрузку.
В источнике указаны GunPlugin-6.0.0.jar версии 6.0.0 размером 692 952 байта и GunPlugin-3.0.1.jar версии 3.0.1 размером 306 181 байт. Разница версий и размеров значительна, поэтому обновление следует считать потенциально крупным.
Последовательность:
• закрыть вход и остановить сервер;
• сохранить JAR, конфигурацию, мир и предметные данные;
• записать параметры контрольного оружия;
• заменить только GunPlugin на тестовой копии;
• проверить чтение прежних предметов;
• повторить стрельбу, перезарядку и попадания;
• проверить пользовательское оружие;
• затем обновить рабочий сервер.
Для 6.0.0 опубликованы SHA-1 1693427d1e8f3633f651d24a7927fda98b1d5429 и SHA-512 a87fd673e5464c05788054c5ba5498a1ea16ef5b9c0cd3fd98ab475dde468c67ff144ad37f8878423d0dab3d1825ab99d3440bb0ae7e889b101bc547a27e68f5. Для 3.0.1 указаны SHA-1 4d6e551b7254586b5c341f1b40de46e849497f1c и SHA-512 259d094e50293eaff2f40d04b2f0834d9a63422086d6304e41ec7551f4069d92399f7cbd73da4666f56a22213cdf97ea142c9deb745f446609aec47046f5b106.
Откат возвращает прежний JAR вместе с совместимой конфигурацией и данными из одной резервной точки. После остановки сервера новую сборку убирают, восстанавливают старые файлы, проверяют контрольное оружие, боеприпасы, перезарядку и журнал.
Предметы, созданные новой версией, требуют отдельной проверки: обратная совместимость в источнике не гарантирована. Открывать вход следует только после успешной приёмки старой сборки.
Если оружие не стреляет, проверяют загрузку JAR, наличие патронов, магазин и действие игрока. Затем исключают безопасный регион, запрет взаимодействия и античит. При проблемах с автоогнём фиксируют точную последовательность нажатия и отпускания правой кнопки.
Для отчёта фиксируют версии Minecraft, ядра и GunPlugin, хеш JAR, конфигурацию оружия, цель, дистанцию, режим, магазин, действия игрока, связанные плагины и журнал.
Файлы получены по официальному HTTPS, сверены по опубликованным хешам и статически проверены по структуре и путям. Динамический запуск не выполнялся, поэтому фактические свойства подтверждает только тест.
Публичный участник проекта — 114514h. GunPlugin распространяется по MIT; канонический SPDX-идентификатор — MIT. При локализации и распространении следует сохранять название, авторство и лицензию. Рекомендации по балансу, резервным копиям и стенду являются редакционными.
Отдельный клиентский JAR не заявлен. Плагин требуется на сервере, а клиентская сторона отмечена как неподдерживаемая.
В официальном описании названы пистолеты, винтовки, дробовики и снайперские винтовки.
Источник указывает клавишу F. На конкретном сервере нужно проверить конфликт с другими действиями и переназначениями.
Метаданные перечисляют 1.21–1.21.11, а фрагмент руководства отдельно называет 1.21.4 и Spigot/Paper. Из-за различия сведений точную комбинацию следует проверять с выбранным JAR.
Назначение и возможности
Плагин добавляет пистолеты, винтовки, дробовики и снайперские винтовки. Подтверждены магазины, отображение патронов, перезарядка, одиночный, серийный и дробовой огонь. Автоогонь работает при удержании правой кнопки, ручная перезарядка — клавишей F.
Заявлены скорость и падение пули, проникновение, рост разброса в движении, отдача, частицы, звуки и 30% дополнительного урона за попадание в голову. При оружии в руке отключаются обычная левая атака и правое взаимодействие. Точные формулы и пределы не приведены.
Скриншоты и внешний вид
Аудитория и сценарии выбора
GunPlugin подходит PvP-серверам, аренам и приключенческим режимам без обязательного клиентского мода. Администрация должна быть готова настраивать предметы и тестировать бой.
До внедрения определяют:
• выдачу оружия и патронов;
• разрешённые миры и безопасные зоны;
• сохранение предметов после смерти;
• допустимые режимы огня;
• учёт убийств и урона;
• конфликт клавиши F;
• работу дверей, контейнеров и NPC при оружии в руке.
В выживании система меняет ценность брони, щитов, луков и укрытий, поэтому требует пересмотра баланса.
Совместимость и требования
Выбранные метаданные перечисляют Minecraft 1.21–1.21.11 и платформы Bukkit, Folia, Paper, Purpur и Spigot. Серверная сторона обязательна, клиентская отмечена как неподдерживаемая. Обязательные project dependencies не указаны.
В руководстве отдельно названы Minecraft 1.21.4, Spigot или Paper, Java 8+ и рекомендация 2 ГБ памяти. Эти сведения уже метаданных и не привязаны к каждой сборке, поэтому конкретный JAR нужно проверять на выбранном ядре.
Отдельного теста требуют Folia, Purpur, античит, регионы, кастомные сущности, системы брони, статистика урона и кроссплатформенный вход.
Установка и первый запуск
Подтверждённый способ — поместить JAR в папку plugins совместимого сервера. После запуска официальный текст предусматривает редактирование файла конфигурации в каталоге GunPlugin, но точные ключи в предоставленном фрагменте не раскрыты.
Порядок внедрения:
• сохранить мир, конфигурации и список плагинов;
• записать версии ядра и среды запуска;
• сверить имя, размер и хеш JAR;
• установить файл в plugins;
• запустить тестовую копию;
• изучить журнал и созданную конфигурацию;
• получить одно тестовое оружие штатным административным способом;
• проверить стрельбу, боеприпасы и перезарядку;
• затем переносить плагин на рабочий сервер.
Исходную конфигурацию сохраняют, а параметры меняют по одной группе с повторной проверкой.
Проверка результата
Приёмка охватывает:
• одиночный, серийный и дробовой огонь;
• опустошение магазина и перезарядку F;
• стрельбу стоя и в движении;
• дальнюю траекторию;
• попадание в голову;
• препятствия и проникновение;
• остановку автоогня;
• сохранение предмета после перезапуска.
Также проверяют урон игрокам и мобам, броню, регионы, частицы, звуки и взаимодействия. Заявленные 30% за попадание в голову измеряют на нескольких целях. Результат приемлем, если ограничения не обходятся, данные сохраняются, а ошибок нет.
Конфигурация и баланс
Официальное описание подтверждает создание пользовательского оружия через конфигурацию. Это даёт гибкость, но сочетание высокого урона, скорострельности, ёмкого магазина и малого разброса может резко изменить баланс.
Настройку начинают с одного пистолета, затем проверяют винтовку и дробовик, урон на дистанциях, разброс в движении, перезарядку и боезапас. После этого добавляют новые образцы. Названия ключей не приведены, поэтому параметры берут из фактической конфигурации выбранной версии.
Ограничения и риски
GunPlugin меняет не только урон, но и управление. Отключение обычной атаки и правого взаимодействия может конфликтовать с меню, NPC, контейнерами и предметами. Автоматический огонь увеличивает число событий, звуков и частиц, а баллистика и проникновение требуют проверки нагрузки.
Не подтверждены полный каталог, рецепты и экономика патронов, встроенные матчи, конкретный античит, обязательный пакет ресурсов, дружественный огонь, ограничения по мирам, обратная совместимость предметов и пределы проникновения. Без стенда нельзя оценить баланс, клавиши и нагрузку.
Безопасное обновление
В источнике указаны GunPlugin-6.0.0.jar версии 6.0.0 размером 692 952 байта и GunPlugin-3.0.1.jar версии 3.0.1 размером 306 181 байт. Разница версий и размеров значительна, поэтому обновление следует считать потенциально крупным.
Последовательность:
• закрыть вход и остановить сервер;
• сохранить JAR, конфигурацию, мир и предметные данные;
• записать параметры контрольного оружия;
• заменить только GunPlugin на тестовой копии;
• проверить чтение прежних предметов;
• повторить стрельбу, перезарядку и попадания;
• проверить пользовательское оружие;
• затем обновить рабочий сервер.
Для 6.0.0 опубликованы SHA-1 1693427d1e8f3633f651d24a7927fda98b1d5429 и SHA-512 a87fd673e5464c05788054c5ba5498a1ea16ef5b9c0cd3fd98ab475dde468c67ff144ad37f8878423d0dab3d1825ab99d3440bb0ae7e889b101bc547a27e68f5. Для 3.0.1 указаны SHA-1 4d6e551b7254586b5c341f1b40de46e849497f1c и SHA-512 259d094e50293eaff2f40d04b2f0834d9a63422086d6304e41ec7551f4069d92399f7cbd73da4666f56a22213cdf97ea142c9deb745f446609aec47046f5b106.
Откат
Откат возвращает прежний JAR вместе с совместимой конфигурацией и данными из одной резервной точки. После остановки сервера новую сборку убирают, восстанавливают старые файлы, проверяют контрольное оружие, боеприпасы, перезарядку и журнал.
Предметы, созданные новой версией, требуют отдельной проверки: обратная совместимость в источнике не гарантирована. Открывать вход следует только после успешной приёмки старой сборки.
Диагностика
Если оружие не стреляет, проверяют загрузку JAR, наличие патронов, магазин и действие игрока. Затем исключают безопасный регион, запрет взаимодействия и античит. При проблемах с автоогнём фиксируют точную последовательность нажатия и отпускания правой кнопки.
Для отчёта фиксируют версии Minecraft, ядра и GunPlugin, хеш JAR, конфигурацию оружия, цель, дистанцию, режим, магазин, действия игрока, связанные плагины и журнал.
Файлы получены по официальному HTTPS, сверены по опубликованным хешам и статически проверены по структуре и путям. Динамический запуск не выполнялся, поэтому фактические свойства подтверждает только тест.
Лицензия и авторство
Публичный участник проекта — 114514h. GunPlugin распространяется по MIT; канонический SPDX-идентификатор — MIT. При локализации и распространении следует сохранять название, авторство и лицензию. Рекомендации по балансу, резервным копиям и стенду являются редакционными.
FAQ
Нужно ли устанавливать GunPlugin на клиент?
Отдельный клиентский JAR не заявлен. Плагин требуется на сервере, а клиентская сторона отмечена как неподдерживаемая.
Какие виды оружия подтверждены?
В официальном описании названы пистолеты, винтовки, дробовики и снайперские винтовки.
Как выполняется ручная перезарядка?
Источник указывает клавишу F. На конкретном сервере нужно проверить конфликт с другими действиями и переназначениями.
Какая версия Minecraft нужна?
Метаданные перечисляют 1.21–1.21.11, а фрагмент руководства отдельно называет 1.21.4 и Spigot/Paper. Из-за различия сведений точную комбинацию следует проверять с выбранным JAR.
