SkBriggy - Brigadier-команды в Skript

SkBriggy - это аддон для Skript, который решает одну из главных болей скриптеров на серверах Майнкрафт: кривые команды без нормальных подсказок. Если вы когда-нибудь писали команды через обычный Skript, то знаете эту боль - игрок вводит /ban Steve и не видит ни подсказок по аргументам, ни автокомплита, ни валидации. Просто серый текст и молитва, что синтаксис правильный.

СкБригги меняет подход. Он подключает ваши Skript-команды к Brigadier - той самой системе, которую Mojang использует для ванильных команд типа /give, /gamemode или /tp. Результат? Игроки видят нативные подсказки прямо в чате: типы аргументов подсвечиваются, Tab-комплит работает как в ванилле, ошибки синтаксиса видны до нажатия Enter.

Зачем это нужно, если есть обычные команды Skript

Честно - SkBriggy не замена классическим command /... из Skript. Это скорее апгрейд для тех случаев, когда вам важен UX команды. Представьте: вы делаете кастомный бан с выбором времени и причины. В ванильном Skript игрок увидит только /skriptban <player> <number> <text> <text> - и всё, дальше гадай сам. А с Бригги он увидит /brigban <player> <time:int> <span:string> <reason:greedystring> с подсветкой каждого аргумента и автокомплитом для minutes, hours, days.

Разница в коде тоже заметна. Вот как выглядит команда с таб-комплитом через SkBee (ещё один популярный аддон):

command /skriptban <player> <number> <text> <text>:
	trigger:
		# do stuff

on tab complete of "/skriptban":
	set tab completions for position 2 to "<time>"
	set tab completions for position 3 to "minutes", "hours" and "days"
	set tab completions for position 4 to "<reason>"

А вот та же логика через SkBriggy:

brig command /brigban <player> <time:int> <span:string> <reason:greedystring>:
	arguments:
		set suggestions of "span" arg to "minutes", "hours" and "days"
	trigger:
		# do stuff

Видите разницу? Всё в одном месте, аргументы типизированы (int, string, greedystring), подсказки настраиваются прямо в блоке arguments. Не нужно городить отдельные ивенты для таб-комплита.

Технические требования и совместимость

Актуальная версия SkBriggy рассчитана на Minecraft 1.20.6 - 1.21.11. Требования жёсткие, без них не взлетит:

• Paper - только этот загрузчик, Spigot и Bukkit не поддерживаются
• Skript 2.10+ - старые версии не подойдут
• Java 17+ - проверьте свою JVM, если сервер на хостинге

Если вы держите сервер на BungeeHost (https://bungee.host), то установка займёт пару кликов - просто закиньте jar в папку plugins и перезапустите. Плагин подхватится автоматически, если Skript уже стоит.

Что нового в версии 1.5.8

Последнее обновление принесло несколько важных фиксов, о которых стоит знать:

• Корректный аргумент block state - теперь можно принимать блоки с состояниями (например, minecraft:oak_log[axis=y]) и парсить их без костылей
• Исправлен возврат block data - раньше при получении данных блока могли быть глюки, теперь работает стабильно
• Починены список-аргументы - если вы принимали несколько значений через запятую, они больше не ломаются
• Фикс загрузки после изменений в SkBee - если вы используете SkBee для text components, конфликты устранены

Практические советы от бывалого

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

Типы аргументов - ваш друг. Используйте int для чисел, player для игроков, greedystring для длинных текстов (причин банов, сообщений). Brigadier сам валидирует ввод, и игрок увидит ошибку до выполнения команды.

Проверяйте совместимость с другими аддонами. SkBriggy довольно капризен к порядку загрузки. Если у вас стоят SkBee, skript-reflect или другие аддоны, тестируйте на dev-сервере перед продом.

Производительность. Brigadier-команды работают быстрее обычных Skript-команд, потому что парсинг происходит на уровне движка, а не через интерпретатор Skript. На больших серверах с сотнями команд разница ощутима.

Кому это нужно

Скачать SkBriggy стоит, если вы:

• Делаете сервер с кастомными механиками и хотите, чтобы команды выглядели профессионально
• Устали от вопросов игроков "а как правильно ввести команду"
• Хотите использовать современный подход к командам в Minecraft
• Готовы мириться с требованием Paper и свежего Skript

Если ваш сервер на Spigot или вы сидите на старом Skript 2.6 - увы, придётся либо обновляться, либо оставаться на классических командах. Но для новых проектов на Paper 1.20+ это практически must-have.

Скачать мод SkBriggy можно бесплатно, установка стандартная для плагинов Paper. После этого ваши скрипты получат команды, которые не стыдно показать игрокам - с подсказками, валидацией и нативным поведением Minecraft.