rollCommand

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

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

Основные возможности

Плагин предоставляет гибкие инструменты для создания уникальных механик:

• Случайное выполнение: Команда /roll выбирает и запускает случайную инструкцию из текущего активного списка.
• Множественные списки: Возможность определить неограниченное количество категорий команд (например, награды, эффекты или сообщения).
• Система весов: Каждой команде в списке можно присвоить вес, который напрямую влияет на вероятность её выбора. Это позволяет делать редкие события более эксклюзивными.
• Индивидуальные кулдауны: Каждый список команд имеет свой период восстановления в секундах, что предотвращает спам и позволяет балансировать экономику или игровые события.

Управление в игре

Администраторы и игроки могут взаимодействовать с плагином через специальные команды. Использование /rlist позволяет просматривать все доступные списки и переключаться между ними в реальном времени. Для тестирования механик предусмотрена команда /rtest, которая выполняет случайную команду из списка без учета времени кулдауна (доступно только для администраторов).

/roll
/rlist
/rtest

Права доступа

Для работы с функциями плагина предусмотрены следующие права доступа (permissions):

• rollCommand.use — использование основной команды /roll (по умолчанию доступно всем).
• rollCommand.admin — доступ к управлению списками через /rlist и тестирование через /rtest (по умолчанию для операторов).

Конфигурация

Настройки плагина хранятся в файле config.yml. В конфигурации можно указать основной активный список через параметр chosenList, а в разделе commandLists описать параметры каждого списка.

chosenList: exampleList

commandLists:
  diamondList:
    cooldown: 120
    commands:
    - command: "/give %p diamond 64"
      weight: 1
    - command: "/give %p diamond_block 32"
      weight: 2
    - command: "/effect give %p haste 300 2"
      weight: 3
  exampleList:
    cooldown: 60
    commands:
    - command: "/give %p diamond 1"
      weight: 1
    - command: "/say Hello, %p!"
      weight: 2
  funList:
    cooldown: 30
    commands:
    - command: "/effect give %p jump_boost 30 3"
      weight: 3
    - command: "/effect give %p speed 30 2"
      weight: 2
    - command: "/give %p cookie 1"
      weight: 1

В конфигурационных командах переменная %p автоматически заменяется на имя игрока, выполнившего команду.