Item Restriction (Айтем рестрикшн)

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

Возможности

• Отключает тотемы бессмертия, элитры, булаву, кристаллы энда и якоря возрождения: запрещённые предметы нельзя получить, подобрать, скрафтить или использовать в зависимости от механики.
• Ограничивает зелья силы II, скорости II и «Черепашьего мастера», запрещает их варку.
• Ограничивает вагонетки с динамитом: не более двух в чанке и без поджигания огнём, лавой, огненными зарядами и горящими стрелами.
• Не даёт поршням двигать динамит, чтобы закрыть распространённые дюпы.
• Убирает у обычных жителей сделки с «Починкой», запрещает чары «Пробитие», «Плотность» и «Отбрасывание II», ограничивает прочность трезубца и запрещает накладывать на него «Починку».
• Блокирует появление железных големов от деревенской механики; големов, собранных игроком из четырёх железных блоков и вырезанной тыквы, это не касается.
• Для любого предмета можно запретить получение, крафт, установку и выбрасывание клавишей Q или после смерти, установить размер стака от 1 до 64 и максимальную прочность.
• Для отдельного предмета можно убирать выбранные зачарования, принудительно задать название и строки описания с цветами.
• Меню /itemgui содержит список предметов, редактор правил и выбор зачарований. Настроенные предметы отмечаются зачарованным блеском, а в подсказке показываются действующие ограничения.

Команды

Все команды требуют право restrictions.admin.

• /restrict или /restrict list — показать состояния глобальных ограничений.
• /restrict toggle <key> — переключить правило; /restrict enable <key> и /restrict disable <key> — включить или выключить его.
• /restrict enableall и /restrict disableall — включить или выключить все глобальные правила.
• /restrict reload — перечитать config.yml.
• /itemgui — открыть меню настройки предметов; доступно только игроку.
• /itemrestrict list — показать предметы с настроенными правилами.
• /itemrestrict info <item|hand> — показать правила предмета. Аргумент hand выбирает предмет в руке.
• /itemrestrict set <item|hand> banned <true|false> — полностью запретить предмет.
• /itemrestrict set <item|hand> max_stack <1-64> — задать размер стака; значение -1 сбрасывает его к ванильному.
• /itemrestrict set <item|hand> max_durability <number> — ограничить прочность; -1 сбрасывает ограничение.
• /itemrestrict set <item|hand> banned_in_crafting <true|false> — запретить предмет в рецептах и как результат крафта.
• /itemrestrict set <item|hand> banned_placing <true|false> — запретить установку блока.
• /itemrestrict set <item|hand> banned_dropping <true|false> — запретить выбрасывание и выпадение после смерти.
• /itemrestrict set <item|hand> banned_enchants add <enchant> — запретить зачарование для предмета; remove <enchant> отменяет один запрет, clear — все.
• /itemrestrict set <item|hand> force_name <name> — задать название, clear — убрать его.
• /itemrestrict set <item|hand> force_lore add <text> — добавить строку описания; remove <index> удаляет строку по индексу, clear очищает описание.
• /itemrestrict clear <item|hand> — удалить все правила предмета.
• /itemrestrict reload — перечитать items.yml.

Ключи глобальных правил: totem, crystal_anchor, mace, elytra, potions, tnt_minecart, tnt_duper, mending_trade, enchantments, trident, iron_farm.

Права

• restrictions.admin — доступ ко всем командам и меню; по умолчанию есть у операторов сервера.

Настройка

Глобальные ограничения хранятся в plugins/RestrictionsPlugin/config.yml, а правила отдельных предметов — в plugins/RestrictionsPlugin/items.yml. Изменения через /itemgui и /itemrestrict сохраняются автоматически и начинают работать без перезапуска сервера.

Названия зачарований в командах и items.yml указываются внутренними ключами Майнкрафт: например, sharpness, fire_aspect, swift_sneak. Для цветов и форматирования названий и описаний используется символ &, например &a, &c и &l.

Требования

Нужен сервер на Paper и Java 17 или новее. Зависимости не требуются.