Плагин для серверов Майнкрафт на Paper, который добавляет промокоды для выдачи наград. Игрок вводит код или выбирает его в меню, а сервер выполняет заданные команды; для каждого кода можно установить лимиты и условия получения.
Возможности
- Промокод выполняет одну или несколько серверных команд от консоли либо от имени игрока; в командах доступен
%player%. - Коды можно скрыть из меню и автодополнения, сохранив возможность активировать их вручную.
- Лимит срабатываний бывает общим для всех игроков или отдельным для каждого игрока.
- Условия активации: число добытых блоков, время на сервере, количество сообщений в чате, возраст аккаунта на сервере, права и группы.
- Список доступных кодов открывается в постраничном меню; предметы, названия и оформление меню настраиваются.
Команды
Основная команда задаётся ключом command в config.yml; по умолчанию это /code, также доступна /claimo.
/<command>— открыть меню промокодов./<command> <voucher>— активировать код./<command> create— создать код через игровое меню./<command> reload— перечитать конфигурацию и файлы кодов.
Коды хранятся отдельными файлами в plugins/Claimo/vouchers/. В файле задаются команда cmd, запуск от консоли console, скрытие hide, лимиты limit и условия requirements.
Права
claimo.use— просмотр и активация промокодов; по умолчанию доступно всем.claimo.admin— создание кодов и перезагрузка настроек; по умолчанию доступно операторам.
Настройка
Основные файлы находятся в plugins/Claimo/:
config.yml— команда, хранилище статистики и счётчиков;messages.yml— сообщения игрокам;gui.yml— меню доступных кодов;vouchers/— файлы отдельных промокодов.
Счётчики можно хранить в YAML, SQLite, MySQL, PostgreSQL или MongoDB. Для сети серверов подойдут внешние базы данных. Изменение команды и типа хранилища требует перезапуска сервера.
Требования
Плагин работает на Paper. Проверка групп требует Vault и подключённого провайдера прав, например LuckPerms. Если установлен PlaceholderAPI, в командах наград можно использовать его плейсхолдеры.
