mCodes (Эмкодс)

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

Возможности

• Промокоды без учёта регистра с общим лимитом, лимитом на игрока, временем начала и окончания действия, а также требованием права.
• Отдельные награды командами консоли для приглашённого игрока и владельца реферального кода.
• Защита от саморефералов, повторной активации рефералов и использования одной сетевой личности у разных пригласивших.
• Журнал выдачи наград: незавершённые операции можно проверить, повторить или вручную отметить выполненными.
• Интерфейс доступен на русском языке: укажите language: ru_RU и примените изменения командой /code reload.

Команды

• /code redeem <code> — активировать промокод или реферальный код.
• /refer — создать или посмотреть личный реферальный код.
• /refer <code> — активировать код другого игрока.
• /code create <code> <global-limit> [per-player] [expires-hours] [permission|-] [starts-hours] — создать промокод.
• /code info <code> и /code list — посмотреть сведения о кодах.
• /code enable <code> и /code disable <code> — включить или отключить код.
• /code pending — показать незавершённые операции выдачи.
• /code retry <transaction-uuid> — повторить незавершённую операцию.
• /code resolve <transaction-uuid> — отметить проверенную вручную операцию как выполненную.
• /code reload — перезагрузить конфигурацию.

Права

• mcodes.use — активация кодов; выдаётся игрокам по умолчанию.
• mcodes.admin — создание и управление промокодами, а также работа с журналом наград; по умолчанию есть у операторов.

Настройка

Награды задаются командами консоли в plugins/mCodes/config.yml; в них доступны подстановки {player}, {referrer} и {redeemer}. Параметр anti-abuse.identity-enabled включает проверку сетевой личности, referral-per-identity задаёт лимит рефералов на неё, а promo-per-identity — лимит промокодов.

Файл security.identity-secret нужно хранить в тайне и не изменять: после замены прежние хеши сетевых личностей больше не будут сопоставляться.

Требования

Работает на Paper, Purpur и Folia. Внешние плагины экономики, прав или базы данных не требуются; команды наград могут обращаться к уже установленным плагинам.