Melius Commands: серверный мод Fabric для своих команд в Minecraft
Если вы держите сервер на Fabric и хотите тонко настроить чат команд без тяжёлых плагинов, мод Melius Commands часто оказывается удачным выбором. Это серверная модификация: игрокам на клиенте ничего ставить не нужно, а администратор получает понятный способ описывать команды в JSON, перезагружать конфигурацию прямо в игре и аккуратно управлять правами и поведением узлов Brigadier.
Зачем администратору Melius Commands
В ванильном и модифицированном Minecraft команды уже строятся как дерево литералов и аргументов. Melius Commands позволяет не «ломать» сервер нестандартными хаками, а расширять или переопределять поведение через файлы конфигурации: добавлять свои корневые команды, вешать условия доступа, перенаправлять выполнение на другие узлы и собирать цепочки действий из простых или продвинутых сценариев выполнения.
- кастомные команды без обязательного знания Java, если хватает готовых типов аргументов;
- модификаторы для существующих команд: по узлу пути или по строке ввода;
- поддержка плейсхолдеров из аргументов и глобальных источников, например player:name;
- инструменты отладки, когда игрок видит безликое сообщение об ошибке.
Структура файлов и быстрый старт
Кастомные команды кладутся в каталог ./config/melius-commands/commands. После правок обычно достаточно выполнить /reload в игре, чтобы сервер подхватил изменения без полного рестарта. Рядом в документации и примерах проекта есть образцы: по ним проще понять, как оформляются литералы, аргументы и блоки executes.
Формат JSON допускает поясняющие комментарии в документации, но в реальном файле строки с // копировать не стоит. Корневой узел по правилам мода всегда должен быть литеральным literal node. У каждого узла есть смысл продумать идентификатор, тип для аргументов, дочерние узлы literals и arguments, а при необходимости redirect, чтобы фактически сделать алиас на другую ветку дерева команд.
Выполнение действий: от простой строки до расширенного объекта
Выполнение может быть короткой строкой: тогда оно идёт в «тихом» режиме от имени консоли с уровнем оператора по умолчанию. Либо это объект с полями command, silent, as_console и op_level, где уровень оператора задаётся от 0 до 4. В тексте команды можно подставлять значения аргументов и глобальные плейсхолдеры в формате ${PLACEHOLDER}, где PLACEHOLDER — id аргумента или, к примеру, player:name.
Полный перечень типов аргументов смотрите в разделе ARGUMENTS у мода: часть типов требует дополнительных параметров после пробела, и это важно учитывать, когда вы импортируете заготовку из генератора или переносите пример с другого сервера.
Модификаторы команд: strict, starts_with и regex
Отдельная папка ./config/melius-commands/modifiers отвечает за «надстройки» над уже существующими командами. Здесь различаются два семейства матчеров: node matchers сопоставляют внутренний путь узла Brigadier, а command matchers работают по строке, которую игрок реально набрал. У каждого есть три варианта строгости: strict точно совпадает, starts_with распространяется на более длинные варианты, regex покрывает всё, что подходит под регулярное выражение.
Для node matchers есть поле requirement_modifier: оно позволяет изменить требование к узлу так, что команда полностью исчезнет для тех источников, которые не проходят проверку. Это удобно, когда нужно, например, спрятать опасные ветки телепортации от гостей, не ломая остальную механику.
Как узнать путь узла и не гадать вручную
Чтобы не ошибиться с путём вроде teleport.targets.location, используйте встроенную подсказку: команда /melius-commands path с теми же токенами, что вы бы ввели обычным чатом, покажет точный node path. Это экономит часы отладки, когда вы настраиваете сложные цепочки телепорта, выдачи предметов или модификаций прав.
Когда вы подбираете набор модов под свой мир, иногда проще собрать всё в одном месте с нормальной библиотекой зависимостей: этот мод можно легко установить через лаунчер foxygame.net — удобный, гибкий и современный лаунчер для Minecraft, где можно скачать моды прямо из меню, не разбрасывая jar-файлы по папкам вручную.
Плейсхолдеры кулдауна и отладка «An unexpected error occurred»
Для отображения оставшегося времени кулдауна предусмотрены плейсхолдеры вида %melius-commands:cooldown [id]% и расширенный вариант с форматированием длительности; во втором случае следите за экранированием, иначе парсер сообщений может вести себя непредсказуемо.
Если при выполнении команды игроку показывается сухое «произошла непредвиденная ошибка», включите /melius-commands debug-command-exceptions: в этом режиме в консоль сервера пишется дополнительная диагностика, и вы быстрее находите опечатку в JSON, неверный тип аргумента или конфликт модификатора.
Практические советы по эксплуатации
- держите резервную копию папок commands и modifiers перед массовыми правками;
- сначала проверяйте узкий strict-модификатор, затем расширяйте до starts_with или regex;
- не смешивайте комментарии из примеров с реальным JSON без очистки;
- после reload смотрите лог Fabric на предупреждения Brigadier и PredicateAPI.
Заключение
Melius Commands превращает настройку команд Minecraft в предсказуемый административный процесс: вы описываете дерево, задаёте выполнение и аккуратно ограничиваете доступ. На Fabric-сервере это особенно ценно, когда модпак уже насыщен и каждая лишняя «магия» на стороне ядра удорожает поддержку. Начните с простого literal-корня, добавьте один argument, проверьте плейсхолдеры и только потом усложняйте модификаторами — так вы быстрее получите стабильный результат без длительных простоев. Многие владельцы миров параллельно ведут заметки с node path для частых команд, и при следующем обновлении модпака им не приходится заново исследовать дерево Brigadier с нуля.
--- **Обновление 15.07.2026:** Добавлено 1 файл для версии 26.2 (Fabric).