Скриншоты
- Для версий
- 1.16.+
- 1.17.+
- 1.18+
- 1.19.+
- 1.20.+
- 1.21.+
mcPromo — промокоды и награды для Minecraft
Выдайте подарок за первый вход, откройте бонус после часа игры или разрешите получать награду раз в сутки. В mcPromo условия, время, количество активаций и оформление каждого кода настраиваются прямо в игре.Подготовьте акцию в меню
Откройте/code list, создайте код и добавьте награды. В его карточке находятся сроки действия, серверы, условия, статистика и отдельные разделы «Время», «Количество» и «Оформление». Быстрые команды — /createcode и /ccode. Новый код создаётся выключенным: сначала настройте и проверьте его, затем включите.Каждое ограничение включается отдельно. Выключение отыгрыша, задержки или лимита сохраняет введённое значение. Изменения записываются в базу и отражаются в YAML без перезапуска сервера. Для удаления предусмотрены два подтверждения.
Активация для игрока
Игрок вводит/code welcome или /promo welcome. Если код пока недоступен, mcPromo объясняет причину: сколько осталось играть, сколько ждать или какой лимит исчерпан. Обратный отсчёт над панелью предметов включается отдельным переключателем. Каталог секретных кодов игрокам не показывается.От создания до выдачи
- Добавьте награды и выберите серверы, на которых разрешена активация.
- Задайте время и количество использований. Для моментального кода оставьте ограничения времени выключенными.
- Выберите стиль, автора и подписи наград. Откройте личный предпросмотр.
- Включите код и сообщите его игрокам.
- После активации проверьте статистику и завершение выдач в меню.
Награды и условия
- Жетоны PlayerPoints, деньги через Vault и установленный провайдер экономики, в том числе CMI.
- Постоянная группа LuckPerms, предметы Minecraft, личные сообщения и команды консоли.
- Настроенные наборы CMI и награды игровых режимов через готовые шаблоны команд.
- Условия по правам, отыгрышу и числовым показателям PlaceholderAPI.
Отыгрыш, задержка и повторение
- Отыгрыш до активации — да/нет. Укажите порог, например
1ч30м. Проверяется накопленное игровое время на текущем сервере; время вне игры не прибавляется. Игроку показывается точный остаток. - Первая задержка — да/нет. Отсчёт начинается при первом подходящем запросе кода. Повтор команды, выход и перезапуск его не сбрасывают. Здесь считается обычное время, в том числе вне игры.
- Повторные активации — да/нет. Разрешите повтор и при необходимости включите интервал, например сутки после предыдущей принятой активации.
- Лимиты — да/нет. Отдельно задаются количество использований одним игроком и общий запас активаций. Для повторного кода увеличьте личный лимит или отключите его.
Оформление под вашу акцию
Пять стилей: «Аметист», «Золото», «Аквамарин», «Пламя» и «Компактный». Можно выбрать готовую палитру или включить собственные цвета рамки, текста и акцента. HEX-цвет вводится в форме; пример обновляется в предпросмотре.Укажите автора, красивую подпись кода, название и подзаголовок на экране. Чат, заголовок, звук, список наград и общее оповещение переключаются отдельно. Подпись
✦ GREY ✦ меняет отображение; команда активации использует исходное имя кода.Для своего сообщения есть редактор строк с переменными
{player}, {code}, {author}, {status} и цветами {primary}, {text}, {accent}. Строка {rewards} выводит список наград. Предпросмотр виден только администратору, не расходует активации и не выдаёт предметы. Сообщение о принятом коде и подтверждение завершённой выдачи различаются.Статистика каждого промокода
В каталоге видно число игроков, активаций и выполненных условий. В подробной статистике доступны день, неделя, месяц и свой диапазон дат. Серверы активации, проверки условий и выдачи фильтруются раздельно. Часовой пояс выбирается в настройках.Выдавайте награды там, где они нужны
Сервер активации, сервер проверки условия и сервер выдачи выбираются отдельно. Если нужный сервер выключен или игрок ещё не вошёл на него, награда остаётся в очереди. Меню показывает зарегистрированные экземпляры mcPromo и их доступность.Для одного сервера подходит встроенная H2. Для сети используйте общую MySQL/MariaDB или PostgreSQL, одинаковый namespace и единый UUID игрока. Redis ускоряет уведомления об изменениях; при его недоступности каталог продолжает сверяться через SQL. Отыгрыш до активации берётся со статистики текущего сервера, а не суммируется между режимами.
Меню и редакторы
На скриншотах — настоящие меню, формы, таймеры и сообщения версии 1.1.0. Длинные команды и шаблоны можно редактировать частями; на старых версиях используется наковальня, на новых доступны нативные формы Paper. DialogEngine поддерживается как отдельный редактор.Команды и доступ
/code <код>,/promo <код>— активация. Дополнительные варианты задаются в настройках./code list— каталог, редактирование и статистика./code settings— настройки экземпляра./createcode,/ccode— создание промокода./delcode <код>— удаление с двумя подтверждениями.
mcpromo.use, администратору — mcpromo.admin. По умолчанию первое доступно игрокам, второе — операторам. Названия групп owner, developer и commander сами по себе не заменяют выдачу права. Если в вашей системе прав запрещены все команды, явно разрешите игрокам mcpromo.use.Совместимость и зависимости
Интерфейсы и игровые сценарии версии 1.1.0 проверены на Paper 1.16.5, 1.21.11 и 26.3. Для mcPromo нужна Java 11 или новее; само ядро может требовать более новую Java. Проверка этих версий не означает проверку каждого промежуточного патча или всех сборок других ядер.Предметы и сообщения работают без плагинов экономики. Для других наград установите нужные PlayerPoints, Vault с провайдером, LuckPerms или CMI с его зависимостями. Для внешних показателей нужен PlaceholderAPI. В комплекте есть шаблоны наград ANARCHY, MSO, SUO и STALKER; сами плагины режимов приобретаются или устанавливаются отдельно. Команда шаблона должна поддерживаться вашей версией режима.
Установка и первый код
- Распакуйте ZIP. Остановите сервер и поместите mcPromo-1.1.0.jar в папку plugins. При обновлении удалите прежний JAR из этой папки.
- Установите необходимые плагины наград. При первом запуске mcPromo использует H2.
- Выдайте доверенным группам mcpromo.admin, игрокам — mcpromo.use.
- Откройте /code settings и проверьте настройки экземпляра.
- Создайте /ccode welcome, задайте награды, время, количество и оформление. Проверьте предпросмотр и включите код.
- Проверьте активацию обычным игроком и фактическую выдачу награды.
Перед обновлением сохраните согласованную копию JAR, настроек и базы. Обновляйте все экземпляры общей базы при остановленных серверах. Версия 1.1.0 добавляет таблицу ожидания; при ограниченных правах SQL-пользователю нужен доступ к новой таблице с вашим namespace. История активаций и существующие кампании сохраняются. Простая замена JAR на старую версию после миграции не является откатом базы. Не используйте /reload для обновления.
Вопросы и ответы
Как сделать моментальный промокод?Выключите порог отыгрыша, первую задержку и интервал. Проверьте даты акции и остальные условия. Для одноразового кода оставьте повторные активации выключенными.
Как выдавать награду раз в сутки, всего семь раз?
Включите повторные активации и интервал 1д. Включите личный лимит и задайте 7. Общий лимит всей акции настраивается отдельно.
Нужно отыграть час именно после ввода кода?
Порог до активации сравнивается с общим отыгрышем текущего сервера. Отдельного AFK-фильтра нет. Первая задержка отсчитывается от запроса, но включает время вне игры. Это разные настройки; учёт только активной игры после первого запроса здесь не заявлен.
Почему таймер закончился, а награда не пришла?
Введите код ещё раз. Таймер не активирует его автоматически. После принятия кода награды могут ожидать выполнения остальных условий или входа на сервер выдачи.
Предпросмотр расходует код или показывает сообщение всем?
Нет. Это личный пример для администратора. Общий чат оповещается только при настоящей активации, если соответствующий переключатель включён.
Что происходит при ошибке стороннего плагина или аварии?
Отсутствующая интеграция не считается успешной выдачей. Если результат начатой операции неизвестен, администратор проверяет баланс или инвентарь и принимает решение в меню. Произвольная команда подтверждает отправку, но не доказывает начисление внутри другого плагина.
Сколько стоит плагин и нужна ли лицензия с ключом?
149 ₽, без ключа. Разрешено использовать mcPromo на собственных серверах, в том числе коммерческих. Авторские права сохраняются за mcDev; распространение и перепродажа запрещены. Условия входят в комплект, сторонние библиотеки сохраняют свои лицензии.
Где получить помощь?
Войдите в аккаунт mcdev.su и откройте Поддержку. Укажите версии плагина, Paper и Java, тип базы и шаги воспроизведения. Пароли и полные базы присылать не нужно.
Конфигурация по умолчанию
YAML:
# Версия формата. Менять вручную не нужно.
schema-version: 1
# Идентичность этого экземпляра. Изменения применяются после перезапуска.
server:
# Уникальное имя сервера в общей сети: 1–48 строчных букв, цифр, - и _.
id: survival
# Хранилище. Настройки соединения применяются после перезапуска.
database:
# H2 для одного сервера; MYSQL или POSTGRESQL для общей базы сети.
type: H2
# Адрес SQL-сервера. При H2 не используется.
host: 127.0.0.1
# Порт SQL: обычно 3306 для MySQL или 5432 для PostgreSQL. При H2 не используется.
port: 3306
# Имя заранее созданной SQL-базы. H2 хранит файл mcpromo в папке плагина.
name: mcpromo
# Пользователь базы данных.
username: mcpromo
# Пароль либо env:ИМЯ_ПЕРЕМЕННОЙ. Значение env читается из окружения процесса сервера.
password: ''
# Проверять сертификат и имя SQL-сервера. Для H2 не используется.
tls: true
# Максимум подключений этого экземпляра к базе: от 1 до 16.
pool-size: 4
# Префикс таблиц: строчная буква, затем буквы/цифры/_, всего до 24 символов.
# Серверы одной сети используют одинаковые базу и namespace.
namespace: mcpromo
# Дополнительные команды. Изменения из меню применяются сразу.
commands:
# До 16 разных названий без /. Основная /code остаётся доступной.
# Занятые другим плагином имена использовать нельзя.
activation-aliases: [promo]
# Оформление, ввод и даты. Изменения из меню применяются сразу.
interface:
# AUTO: доступный DialogEngine, затем нативный диалог, иначе наковальня.
# ANVIL — наковальня; NATIVE — нативный диалог Paper; DIALOG_ENGINE — DialogEngine.
# Принудительный NATIVE/DIALOG_ENGINE требует соответствующей поддержки.
input: AUTO
# Часовой пояс дат и статистики, например Europe/Moscow или UTC.
zone: Europe/Moscow
# Основной цвет в формате #RRGGBB.
accent: '#8FE3CF'
# Дополнительный цвет в формате #RRGGBB.
secondary: '#B1A0F7'
# Префикс сообщений: &-цвета, RGB, токены <accent> и <secondary>; до 256 символов.
prefix: '<accent>✦ &fmcPromo &8› &7'
# Обработка SQL и очереди. Изменения применяются после перезапуска.
runtime:
# Число потоков обработки вне игрового тика: от 1 до 8.
workers: 2
# Максимум ожидающих задач: от 32 до 4096. Заполненная очередь отклоняет новые задачи.
queue-capacity: 512
# Интервал проверки условий и выдач: 10–200 тиков. При 20 TPS 40 тиков = 2 секунды.
poll-ticks: 40
# Необязательные уведомления сети. SQL остаётся основным хранилищем.
# Изменения Redis применяются после перезапуска.
redis:
# Включить уведомления об изменении кампаний через Redis.
enabled: false
# Имя хоста или IPv4 Redis.
host: 127.0.0.1
# Порт Redis: от 1 до 65535.
port: 6379
# ACL-пользователь Redis; пустая строка, если отдельный пользователь не задан.
username: ''
# Пароль либо env:ИМЯ_ПЕРЕМЕННОЙ; не публикуйте рабочие значения.
password: ''
# TLS с проверкой сертификата и имени сервера Redis.
tls: false
# Общий канал этой сети. Для разных сетей используйте разные каналы и namespace.
channel: mcpromo:changed-
01-catalog.png -
02-campaign.png -
03-item-reward.png -
04-reward-types.png -
05-anvil.png -
06-settings.png -
07-live-servers.png -
08-statistics.png -
09-native-form.png -
10-delete-confirm.png -
01-style-menu.png -
02-palette.png -
03-rgb-preview.png -
04-activation-title.png -
05-playtime-delay.png -
06-limits-menu.png -
07-interval.png -
08-anvil-playtime.png -
09-playtime-saved.png -
10-native-name.png -
11-custom-line.png -
12-custom-preview.png -
13-private-chat-preview.png -
14-global-limit.png
