Плагин Limited Maces 1.2.1 +1.1.5

Limited Maces — серверный плагин, устанавливающий общий предел на число булав. Он предназначен для режимов, где этот предмет должен оставаться редким. Администратор задаёт максимум самостоятельно; официальное описание прямо допускает вариант с единственной булавой на всём сервере.

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

Глобальный лимит​

Главная функция — жёсткий предел количества булав во всём серверном окружении. Пока число учтённых экземпляров ниже максимума, новая булава может быть создана. После достижения лимита рецепт автоматически отключается. Когда одна из учтённых булав уничтожена, место освобождается и создание снова становится доступным.

Источник не описывает первоначальное обнаружение старых предметов и одновременные события крафта, поэтому уже существующие булавы следует проверить отдельно.

Скриншоты и внешний вид​

Учёт и очистка незаконных булав​

Limited Maces ведёт список отслеживаемых экземпляров и заявляет автоматическое удаление неучтённых или дублированных булав. Подтверждены просмотр списка, включение обычных экземпляров в общий предел, ручная очистка неучтённых предметов и административное удаление выбранной булавы.

Не указано, по какому признаку определяется учтённость и как обрабатываются предметы, существовавшие до установки. Внутренние идентификаторы и структуру записей нельзя описывать предположительно.

Контейнеры и воронки​

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

Стол зачарования и наковальня регулируются отдельной настройкой.

Поведение рамок, раздатчиков, рюкзаков и сторонних контейнеров не подтверждено и требует проверки.

Создание, уничтожение и сообщения​

При достижении лимита рецепт булавы отключается автоматически. Автокрафтеры создавать булавы не могут. Официальное описание также предусматривает глобальные сообщения об изменениях статуса предмета.

После уничтожения булавы:

• отправляется серверное широковещательное сообщение;
• число учтённых экземпляров уменьшается;
• появляется возможность создать новую булаву, если максимум больше текущего количества.

Не перечислены все события, считающиеся уничтожением, поэтому лаву, огонь, пустоту, очистку предметов и административное удаление нельзя трактовать одинаково без теста.

Управление зачарованием​

Параметр allow-mace-enchanting разрешает или запрещает зачарование булав. При значении true предмет можно помещать в стол зачарования и наковальню. При false оба интерфейса для него блокируются.

Подтверждённая функция касается именно этих интерфейсов. Источник не описывает сторонние меню, выдачу готовых зачарованных предметов, применение внешних команд и судьбу уже существующих чар. Поэтому отключение нельзя называть универсальным удалением зачарований.

Команды и права​

Официальный список содержит:

• /maces — просмотр отслеживаемых булав; limitedmaces.use;
• /maces reload — перезагрузка конфигурации; limitedmaces.reload;
• /maces setlimit — изменение максимума; limitedmaces.setlimit;
• /maces enchanting — управление зачарованием; limitedmaces.enchanting;
• /getuntrackedmace — выдача неучтённой булавы с обходом лимита; limitedmaces.getuntracked;
• /clearuntrackedmaces — удаление неучтённых булав; limitedmaces.clearuntracked;
• /removemace — удаление булавы из учёта и мира; limitedmaces.remove.

Дополнительные команды и права не подтверждены.

Взаимодействие /getuntrackedmace с автоматической очисткой не объяснено, поэтому это право следует ограничить.

Конфигурация и файл данных​

Конфигурация находится в plugins/LimitedMaces/config.yml. Подтверждены allowed-maces для максимума и allow-mace-enchanting для зачарования. Значение три в примере версии 1.2.1 не является обязательным для любого сервера.

Учёт хранится в plugins/LimitedMaces/maces.yml. Официальный текст предупреждает не редактировать файл без понимания последствий. Его структура не приведена, поэтому ручные изменения рекомендовать нельзя.

Миграция с MultiMace​

Для версии 1.1.3 и более ранних, использовавших имя MultiMace, заявлено автоматическое обнаружение plugins/MultiMace/ и перенос данных в plugins/LimitedMaces/. Дальнейшие детали опущены. Перед переходом следует сохранить копии папок и проверить результат миграции.

Совместимость и установка​

Подтверждены Bukkit, Paper, Purpur и Spigot. Версии Minecraft: 1.21–1.21.11, 26.1, 26.1.1, 26.1.2 и 26.2. Серверная сторона обозначена как required, клиентская — unsupported. Обязательные project dependencies в выбранных метаданных не указаны.

Установка выполняется помещением JAR в папку plugins совместимого сервера. Практический порядок:

• выбрать нужный выпуск;
• сверить имя, размер и хеши;
• поместить JAR в plugins;
• после штатной загрузки проверить конфигурацию и данные;
• установить требуемый лимит;
• проверить крафт, контейнеры, уничтожение и зачарование;
• затем вводить правило в основном мире.

Файлы, лицензия и статическая проверка​

Предоставлены два выпуска:

• LimitedMaces-1.2.1.jar — версия 1.2.1, 108 173 байта; SHA-512 d6e2f485cf1ae146172b1a53609f4b17d64c890fe4caaea4aa2964df2a93ef9fbc6ab7b97c1a9495d8d0df4d6e809e41093cf8bce2e8cd746907e10069dfc055; SHA-1 683edf3fe6929584fac057668dacd4b19b1eecf3;
• LimitedMaces-1.1.5.jar — версия 1.1.5, 50 493 байта; SHA-512 b371b845ca297e597b1d66dc54622e861507aaf78fe88e97bbf9130d726ec193f45a2db9cf2830cd31d4f0cf1a4321d5085d27f2f87dd638ee2e048dcba6e9bf; SHA-1 9f4b030972c941b8779ca2f864752402822e8121.

Лицензия — MIT. Файлы получены по официальному HTTPS, локально сверены по опубликованным хешам и прошли статическую проверку структуры и путей. Это не заменяет динамический запуск или аудит всей логики.

Практическая проверка и ограничения​

Перед включением следует определить число уже существующих булав.

Контрольный список:

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

Не подтверждены полный алгоритм идентификации, все типы уничтожения, сторонние контейнеры и рецепты, одновременный крафт, поведение старых и административно выданных неучтённых предметов. Достоверный вывод ограничен глобальным лимитом, блокировкой указанных хранилищ, контролем создания, очисткой и настройкой зачарования.

Безопасная проверка​

Безопаснее проверять ресурс в отдельном тестовом профиле или на копии сервера и мира. Перед установкой сохраните резервную копию конфигурации и пользовательских данных, зафиксируйте текущие версии Minecraft и загрузчика, а после запуска проверьте журнал ошибок и только затем переносите изменение в основное окружение.

FAQ​

Нужен ли игрокам клиентский мод?​

Нет. Limited Maces устанавливается на сервер; клиентская сторона обозначена как unsupported.

Можно ли оставить на сервере только одну булаву?​

Да. Официальное описание прямо приводит такой сценарий. Максимум задаётся параметром лимита или подтверждённой административной командой.

Что происходит после уничтожения предмета?​

Сервер получает сообщение, а место в лимите освобождается. После этого новую булаву можно создать, пока максимум снова не достигнут.

Можно ли хранить булаву в шалкеровом ящике?​

Нет. Шалкеровые ящики прямо перечислены среди запрещённых контейнеров. Также указаны сундуки, бочки, другие контейнеры и запрет подбора воронкой.