- Документация
- https://modrinth.com/plugin/duels
Duels — плагин для организации боёв 1v1 на серверах Minecraft. Он объединяет арены, настраиваемые комплекты экипировки, статистику и таблицы лидеров. Проект рассчитан на серверную установку: игрокам не требуется отдельный клиентский мод.
Основной сценарий — управляемый поединок между двумя участниками с заранее подготовленными условиями. Администратор создаёт арены и наборы предметов, распределяет права, а плагин отслеживает состояние матча и связанные с ним результаты.
Duels относится к категориям мини-игр, игровой механики и экипировки. Это серверный компонент, добавляющий основу для дуэлей в существующий проект.
На подтверждённом уровне доступны:
• поединки один на один;
• произвольное количество арен;
• произвольное количество комплектов;
• настраиваемые сообщения;
• разграничение действий через разрешения;
• учёт статистики;
• таблицы лидеров по победам и убийствам.
«Неограниченное» здесь означает отсутствие заявленного фиксированного лимита в плагине, а не гарантию работы любого числа арен на конкретном сервере.
Администратор может начать создание арены, задать её лобби, назначить две точки появления и завершить подготовку, после чего арена попадает в список доступных. Для каждой арены отображаются идентификатор, название и текущее игровое состояние.
В описании перечислены три состояния:
• IDLE — арена свободна или ожидает игроков;
• COUNTDOWN — идёт обратный отсчёт перед началом;
• PLAYING — дуэль уже проходит.
Игрок может присоединиться к первой доступной арене либо выбрать арену по идентификатору, если она существует и свободна. Выход учитывает состояние матча: при ожидании или обратном отсчёте участник просто покидает арену, а выход во время активного боя засчитывается как поражение в статистике.
Файлы этой карточки загружены с официального HTTPS-источника; размеры и опубликованные SHA-1/SHA-512 сверены, целостность и безопасные пути внутри архивов проверены статически. Файлы не запускались, поэтому динамическое поведение не заявляется как протестированное.
Duels позволяет создавать наборы из текущего инвентаря администратора, просматривать доступные варианты, удалять их и выбирать комплект для следующего поединка. Если запрошенный набор отсутствует, по описанию используется комплект по умолчанию.
Можно использовать один общий комплект, несколько наборов под разные стили или отдельные варианты для событий. Перед запуском следует проверить броню, расходуемые предметы, прочность, чары и состояние инвентаря после матча. Взаимодействие со сторонними системами предметов в основе не описано.
Плагин отслеживает результаты и позволяет просматривать собственную либо чужую статистику. Таблицы лидеров доступны по победам и убийствам. Отдельно предусмотрен перенос старых данных из прежнего файла статистики в новую систему, а также перенос файловых данных в SQL-базу.
Перед миграцией следует сохранить исходные файлы, зафиксировать версию плагина, выполнить перенос на тестовой копии и сравнить несколько записей. Формат базы, параметры подключения и схема хранения в основе не раскрыты.
Отдельные права контролируют справку, вход, выход, список арен, создание площадок, управление комплектами, статистику, рейтинги и миграцию. Игрокам обычно достаточно входа, выхода, выбора набора и просмотра данных; административные операции следует оставлять доверенной группе. Это принцип разделения полномочий, а не готовая конфигурация.
Начиная с версии 3.3.3 в описании заявлены заполнители PlaceholderAPI для рейтинга побед, рейтинга убийств, личного числа побед и личного числа убийств. Рейтинговые заполнители поддерживают только первые десять позиций.
PlaceholderAPI не указан среди обязательных зависимостей, поэтому заполнители относятся к дополнительной интеграции. Их вывод зависит от стороннего плагина, умеющего обрабатывать такие значения. Рейтинг ограничен первой десяткой.
Подтверждены Minecraft 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5 и 1.20.6, а также все перечисленные версии от 1.21 до 1.21.11. Поддерживаемые серверные платформы — Paper и Spigot.
Клиентская сторона обозначена как неподдерживаемая, серверная — как обязательная. Игрок подключается обычным совместимым клиентом, а логика арен и статистики выполняется сервером.
Установка выполняется размещением JAR-файла Duels в папке plugins совместимого Paper- или Spigot-сервера. В выбранных метаданных обязательные project dependencies не указаны.
Порядок внедрения:
• сверить версию Minecraft и платформу;
• создать резервную копию;
• поместить JAR в папку плагинов;
• запустить тестовый сервер;
• создать одну арену и один комплект;
• провести полный цикл боя;
• проверить статистику и права.
Параметры конфигурации и подключения к базе в основе не приведены.
Duels использует bStats для анонимных сведений о сервере, включая версию ПО; в описании указана возможность отключения метрик средствами bStats. Из спорных игровых ситуаций подтверждён только выход при PLAYING, который считается поражением. Разрывы соединения, остановки сервера и вмешательство других плагинов в основе не описаны.
Версия Duels-4.0.6.jar имеет размер 297 441 байт. SHA-512: 9d9d26efcac282f7d89edc9a6902770c32ba7f9171143ad2cf668e854676ebc36c13c931188973edc8b7a699f7cfa24a45b40d40719dad018946a0b8a7491454; SHA-1: ed83de15a9e8a1c1fcb4196628941312985d90de.
Предыдущий файл Duels-4.0.5.jar имеет размер 293 851 байт. SHA-512: 820d1744552b50bf05bc84cc3b94cdf6daaa5da912dea1be38d730cccf2fce08846db8bd7175c1b945cb690f501118376a47785c76b579ef215736aceef13b41; SHA-1: ca46268720ebc3827b599031c54cfd6b9c10fecc.
Лицензия — MIT. Файлы получены по официальному HTTPS, сверены по хешам и прошли статическую проверку структуры и путей. Динамический запуск не выполнялся.
Нет. Плагин обязателен только на серверной стороне, а клиентская установка не поддерживается.
Да. Официальное описание заявляет отсутствие фиксированного лимита на число арен и наборов. Практический предел конкретного сервера не установлен в основе.
Если арена находится в состоянии PLAYING, выход засчитывается как поражение. При IDLE или COUNTDOWN игрок просто покидает арену.
Нет такого подтверждения. Плагин умеет переносить файловую статистику в SQL, но обязательная зависимость от базы в метаданных не указана.
Да, с версии 3.3.3 заявлены заполнители статистики и рейтингов. Для таблиц лидеров поддерживаются только первые десять мест.
Основной сценарий — управляемый поединок между двумя участниками с заранее подготовленными условиями. Администратор создаёт арены и наборы предметов, распределяет права, а плагин отслеживает состояние матча и связанные с ним результаты.
Назначение и формат игры
Duels относится к категориям мини-игр, игровой механики и экипировки. Это серверный компонент, добавляющий основу для дуэлей в существующий проект.
На подтверждённом уровне доступны:
• поединки один на один;
• произвольное количество арен;
• произвольное количество комплектов;
• настраиваемые сообщения;
• разграничение действий через разрешения;
• учёт статистики;
• таблицы лидеров по победам и убийствам.
«Неограниченное» здесь означает отсутствие заявленного фиксированного лимита в плагине, а не гарантию работы любого числа арен на конкретном сервере.
Скриншоты и внешний вид
Арены и состояния матча
Администратор может начать создание арены, задать её лобби, назначить две точки появления и завершить подготовку, после чего арена попадает в список доступных. Для каждой арены отображаются идентификатор, название и текущее игровое состояние.
В описании перечислены три состояния:
• IDLE — арена свободна или ожидает игроков;
• COUNTDOWN — идёт обратный отсчёт перед началом;
• PLAYING — дуэль уже проходит.
Игрок может присоединиться к первой доступной арене либо выбрать арену по идентификатору, если она существует и свободна. Выход учитывает состояние матча: при ожидании или обратном отсчёте участник просто покидает арену, а выход во время активного боя засчитывается как поражение в статистике.
Файлы этой карточки загружены с официального HTTPS-источника; размеры и опубликованные SHA-1/SHA-512 сверены, целостность и безопасные пути внутри архивов проверены статически. Файлы не запускались, поэтому динамическое поведение не заявляется как протестированное.
Комплекты экипировки
Duels позволяет создавать наборы из текущего инвентаря администратора, просматривать доступные варианты, удалять их и выбирать комплект для следующего поединка. Если запрошенный набор отсутствует, по описанию используется комплект по умолчанию.
Можно использовать один общий комплект, несколько наборов под разные стили или отдельные варианты для событий. Перед запуском следует проверить броню, расходуемые предметы, прочность, чары и состояние инвентаря после матча. Взаимодействие со сторонними системами предметов в основе не описано.
Статистика и таблицы лидеров
Плагин отслеживает результаты и позволяет просматривать собственную либо чужую статистику. Таблицы лидеров доступны по победам и убийствам. Отдельно предусмотрен перенос старых данных из прежнего файла статистики в новую систему, а также перенос файловых данных в SQL-базу.
Перед миграцией следует сохранить исходные файлы, зафиксировать версию плагина, выполнить перенос на тестовой копии и сравнить несколько записей. Формат базы, параметры подключения и схема хранения в основе не раскрыты.
Разрешения и разделение ролей
Отдельные права контролируют справку, вход, выход, список арен, создание площадок, управление комплектами, статистику, рейтинги и миграцию. Игрокам обычно достаточно входа, выхода, выбора набора и просмотра данных; административные операции следует оставлять доверенной группе. Это принцип разделения полномочий, а не готовая конфигурация.
PlaceholderAPI и отображение результатов
Начиная с версии 3.3.3 в описании заявлены заполнители PlaceholderAPI для рейтинга побед, рейтинга убийств, личного числа побед и личного числа убийств. Рейтинговые заполнители поддерживают только первые десять позиций.
PlaceholderAPI не указан среди обязательных зависимостей, поэтому заполнители относятся к дополнительной интеграции. Их вывод зависит от стороннего плагина, умеющего обрабатывать такие значения. Рейтинг ограничен первой десяткой.
Версии, платформы и стороны
Подтверждены Minecraft 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5 и 1.20.6, а также все перечисленные версии от 1.21 до 1.21.11. Поддерживаемые серверные платформы — Paper и Spigot.
Клиентская сторона обозначена как неподдерживаемая, серверная — как обязательная. Игрок подключается обычным совместимым клиентом, а логика арен и статистики выполняется сервером.
Установка и зависимости
Установка выполняется размещением JAR-файла Duels в папке plugins совместимого Paper- или Spigot-сервера. В выбранных метаданных обязательные project dependencies не указаны.
Порядок внедрения:
• сверить версию Minecraft и платформу;
• создать резервную копию;
• поместить JAR в папку плагинов;
• запустить тестовый сервер;
• создать одну арену и один комплект;
• провести полный цикл боя;
• проверить статистику и права.
Параметры конфигурации и подключения к базе в основе не приведены.
Телеметрия и ограничения данных
Duels использует bStats для анонимных сведений о сервере, включая версию ПО; в описании указана возможность отключения метрик средствами bStats. Из спорных игровых ситуаций подтверждён только выход при PLAYING, который считается поражением. Разрывы соединения, остановки сервера и вмешательство других плагинов в основе не описаны.
Файлы, лицензия и проверка безопасности
Версия Duels-4.0.6.jar имеет размер 297 441 байт. SHA-512: 9d9d26efcac282f7d89edc9a6902770c32ba7f9171143ad2cf668e854676ebc36c13c931188973edc8b7a699f7cfa24a45b40d40719dad018946a0b8a7491454; SHA-1: ed83de15a9e8a1c1fcb4196628941312985d90de.
Предыдущий файл Duels-4.0.5.jar имеет размер 293 851 байт. SHA-512: 820d1744552b50bf05bc84cc3b94cdf6daaa5da912dea1be38d730cccf2fce08846db8bd7175c1b945cb690f501118376a47785c76b579ef215736aceef13b41; SHA-1: ca46268720ebc3827b599031c54cfd6b9c10fecc.
Лицензия — MIT. Файлы получены по официальному HTTPS, сверены по хешам и прошли статическую проверку структуры и путей. Динамический запуск не выполнялся.
FAQ
Требуется ли Duels на клиенте?
Нет. Плагин обязателен только на серверной стороне, а клиентская установка не поддерживается.
Можно ли создать несколько арен и комплектов?
Да. Официальное описание заявляет отсутствие фиксированного лимита на число арен и наборов. Практический предел конкретного сервера не установлен в основе.
Что происходит при выходе из активного боя?
Если арена находится в состоянии PLAYING, выход засчитывается как поражение. При IDLE или COUNTDOWN игрок просто покидает арену.
Обязательна ли SQL-база?
Нет такого подтверждения. Плагин умеет переносить файловую статистику в SQL, но обязательная зависимость от базы в метаданных не указана.
Есть ли интеграция с PlaceholderAPI?
Да, с версии 3.3.3 заявлены заполнители статистики и рейтингов. Для таблиц лидеров поддерживаются только первые десять мест.
