DuckySkript (Дакискрипт)

Плагин для серверов Майнкрафт на Spigot и Paper, который запускает собственные последовательности команд по нажатию на NPC Citizens или вручную. Скрипты задаются в YAML и могут выбирать действия по правам игрока.

Возможности

• запуск скрипта при клике правой кнопкой по NPC Citizens;
• выполнение команд от консоли, игрока или игрока с временно выданным OP;
• проверка прав сверху вниз и запуск первого подходящего блока;
• блок default, если ни одно право не подошло;
• подстановка имени игрока через %player%;
• поддержка метаданных duckyskript-script и устаревшего parlanpc-script;
• сообщения на английском и иврите.

Команды

• /duckyskript help — показать справку.
• /duckyskript reload — перезагрузить конфигурацию и скрипты.
• /duckyskript run <script> [player] — вручную запустить скрипт.

Альтернативы основной команды: /ds, /ducky, /pn.

Права

• duckyskript.use — доступ к справке.
• duckyskript.admin — перезагрузка плагина.
• duckyskript.run — ручной запуск скриптов.

Также распознаются устаревшие права с префиксом parlanpccmd..

Настройка

Скрипты хранятся в plugins/DuckySkript/scripts/, а основные параметры — в plugins/DuckySkript/config.yml. В YAML-файле команды объединяются в блоки, названные правами игрока; выполняется первый подходящий блок.

Команда без параметров запускается от консоли. Чтобы выполнить её от игрока, используйте asPlayer: true; для временной выдачи OP добавьте asOP: true.

scripts:
  duckyskript.vip:
    - "say Я VIP":
        config:
          asPlayer: true
    - "give %player% diamond 5"
  default:
    - "say У меня пока нет особых прав":
        config:
          asPlayer: true

Чтобы привязать файл скрипта к выбранному NPC, используйте:

/npc select
/npc metadata --set duckyskript-script <script_name>

Вместо <script_name> укажите имя файла без .yml. Язык сообщений выбирается ключом language в config.yml; доступны значения en и he.

Требования

Для запуска скриптов по клику на NPC нужен Citizens.