Commands on use | Dimensions Addon: автоматизация команд при использовании порталов в Minecraft
Плагин Dimensions для серверов Minecraft открывает безграничные возможности по созданию кастомных миров и порталов между ними. Но что, если нужно не просто переместить игрока, а выполнить определённую команду в момент входа в портал? Именно для этого создан аддон Commands on use — лёгкое, но мощное расширение, которое позволяет привязать любые серверные команды к событию использования портала. Больше не нужно писать громоздкие скрипты или настраивать сторонние плагины: всё решается парой строк в конфигурации.
Что такое Dimensions Addon и зачем он нужен
Dimensions — это популярный плагин для Paper, Spigot и других серверных ядер, который даёт возможность создавать собственные измерения с уникальными генераторами, биомами и правилами. Аддоны расширяют его функционал, добавляя специфические механики. Commands on use фокусируется на одном ключевом действии: как только игрок активирует портал (шагает в него, использует предмет или выполняет условие), плагин моментально выполняет заданные команды от имени консоли или самого игрока. Это превращает обычные телепорты в интерактивные события — с выдачей предметов, изменением игровых режимов, запуском мини-игр и даже интеграцией с экономикой.
Установка аддона на сервер
Процесс добавления Commands on use в ваш проект займёт не больше пары минут. Следуйте простой инструкции:
- Скачайте .jar файл аддона с официального репозитория плагина Dimensions. Обратите внимание на совместимость с версией вашего сервера — обычно поддерживаются актуальные сборки Minecraft 1.20+.
- Поместите скачанный файл в директорию ./plugins/Dimensions/Addons/ внутри папки вашего сервера. Если папка Addons отсутствует, создайте её вручную.
- Полностью перезапустите сервер. После загрузки плагин Dimensions автоматически обнаружит новый аддон и сгенерирует файл конфигурации commands-on-use.yml в той же папке Addons.
Кстати, если вы предпочитаете визуальный подход к управлению модами и аддонами, обратите внимание на лаунчер foxygame.net. Этот современный инструмент позволяет скачивать и устанавливать расширения прямо из меню, избавляя от ручного копирования файлов по FTP — достаточно выбрать нужный аддон в каталоге, и лаунчер сам разместит его в правильной папке сервера. Особенно удобно, когда вы тестируете несколько аддонов одновременно и хотите быстро переключаться между ними.
Настройка команд для порталов
После первого запуска сервера с аддоном откройте файл commands-on-use.yml любым текстовым редактором. Внутри вы увидите готовый шаблон с пояснениями. Основной синтаксис выглядит так:
portal-name:
commands:
- 'command1'
- 'command2'
execute-as: console
Где portal-name — это точное имя портала, заданное в конфигурации Dimensions. Список commands содержит любые допустимые команды Minecraft (без слеша в начале). Параметр execute-as определяет, от чьего лица выполнять команды: console (консоль сервера) или player (игрок, использовавший портал). Если указать player, команды будут выполняться с правами игрока, что важно для безопасности.
Динамические переменные в командах
Аддон поддерживает плейсхолдеры, которые делают команды по-настоящему гибкими. Например:
- {player} — имя игрока, активировавшего портал.
- {world} — название мира, из которого игрок пришёл.
- {target} — название портала-назначения (если портал ведёт в другой мир).
Таким образом, одна команда give {player} diamond 1 выдаст алмаз каждому, кто пройдёт через портал, независимо от его ника. Это незаменимо для публичных серверов с высокой посещаемостью.
Практические примеры использования
Рассмотрим несколько сценариев, где Commands on use решает типичные задачи администраторов.
Телепортация с уведомлением и эффектами
Представьте портал в мир приключений. Нужно не только переместить игрока, но и выдать зелье регенерации, а также оповестить всех о прибытии героя. Конфигурация будет такой:
adventure-gate:
commands:
- 'effect give {player} regeneration 10 1'
- 'broadcast Игрок {player} вошёл в мир приключений!'
execute-as: console
Теперь каждый вход в портал adventure-gate автоматически запускает цепочку действий. Команда broadcast отправляет сообщение на весь сервер, а эффект накладывается непосредственно на игрока.
Платный доступ в премиум-зону
С помощью аддона легко интегрировать экономику. Допустим, вход в мир "Элитный город" должен стоить 100 монет. Используйте команду от лица игрока с проверкой баланса (при условии, что у вас установлен плагин экономики вроде EssentialsX):
elite-city:
commands:
- 'eco take {player} 100'
- 'msg {player} С вашего счёта списано 100 монет за вход.'
execute-as: console
Если игрок попытается войти без достаточных средств, плагин экономики сам отменит телепортацию и вернёт ошибку — никаких дополнительных проверок писать не нужно.
Сброс инвентаря при входе в хардкорный мир
Для миров с повышенной сложностью можно очищать инвентарь, чтобы уровнять шансы всех участников:
hardcore-nether:
commands:
- 'clear {player}'
- 'give {player} stone_sword 1'
- 'give {player} bread 16'
execute-as: console
Игрок заходит в адский биом с базовым набором, а всё нажитое остаётся в предыдущем измерении. Это создаёт уникальный игровой опыт без модификации клиента.
Тонкости работы с execute-as
Выбор между console и player влияет не только на права, но и на контекст выполнения. Когда указано console, команды срабатывают мгновенно и гарантированно, даже если игрок не имеет соответствующих разрешений. Это идеально для выдачи предметов, изменения игровых правил или логирования. Режим player полезен, когда нужно, чтобы команда учитывала персональные ограничения — например, если вы хотите, чтобы игрок сам потратил свои очки опыта через команду xp. Однако помните: если у игрока нет прав на команду, она просто не выполнится. Поэтому для критичных действий (телепортация, очистка инвентаря) надёжнее использовать console.
Преимущества перед самописными решениями
Многие администраторы пытаются реализовать подобную логику через цепочки командных блоков или плагины вроде CommandSigns. Но у Commands on use есть ряд неоспоримых плюсов:
- Простота настройки — не нужно разбираться в сложных скриптах, всё делается в одном YAML-файле.
- Событийная модель — команды привязаны именно к моменту использования портала, а не к нажатию кнопки или входу в регион.
- Совместимость — аддон работает с любыми плагинами, которые регистрируют свои команды в серверном ядре.
- Гибкость — поддержка плейсхолдеров и два режима выполнения покрывают 99% потребностей.
Заключение
Аддон Commands on use для плагина Dimensions — это маленький, но крайне полезный инструмент в арсенале каждого владельца Minecraft-сервера. Он стирает грань между простым перемещением и полноценным игровым событием, позволяя автоматизировать рутину и удивлять игроков продуманными механиками. Установка занимает считанные минуты, а результат ощущается сразу: порталы становятся не просто дверьми, а триггерами для целых сценариев. Попробуйте добавить этот аддон в свой проект, и вы увидите, как привычные измерения заиграют новыми красками — без единой строчки кода на стороне клиента.