FREE PromoSystem 1.0.0

🎁 PromoSystem — Система промокодов​

Автор: tm-max34

Описание плагина​

PromoSystem — это профессиональный инструмент для администраторов серверов, позволяющий создавать гибкую систему поощрения игроков. С помощью промокодов вы можете выдавать временные разрешения (например, VIP-статус, доступ к закрытым зонам или предметам), запускать ивенты и управлять лояльностью аудитории.

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

⚙️ Ключевые возможности​

• Гибкая настройка: задавайте точные даты начала и окончания действия кода, лимит на количество активаций и длительность эффекта в часах.
• Автоматизация: система сама выдаст разрешение игроку при вводе кода и снимет его по таймеру.
• Надёжность: плагин защищён от сбоев. В случае повреждения файла данных он будет автоматически пересоздан, а все ошибки логируются в консоль сервера.
• Удобное управление: полный контроль над всеми созданными кодами через интуитивно понятные команды.

📋 Список команд​

Все команды вводятся в игровой чат. Для использования большинства из них требуется право доступа promo.admin. Для активации кодов игроками требуется право promo.use.

1. Активация промокода (для игроков)​

/promo <код>

Эта команда позволяет игроку активировать промокод и получить бонус.

• Пример использования:Игрок вводит в чат: /promo WELCOME123
• Результат:Если код существует, активен и лимит не исчерпан, игрок получит сообщение об успешной активации и таймер обратного отсчёта до истечения бонуса.

2. Управление промокодами (для администраторов)​

Для выполнения следующих команд у пользователя должно быть разрешение promo.admin.

Создание нового кода​

/promo create <код> <разрешение> <макс_исп> <дата_начала> <время_начала> <дата_окончания> <время_окончания> <часы_действия>

Самая важная команда для создания промокода. Разберём каждый параметр:

• <код>: Уникальное имя кода (например: BLACKFRIDAY, STARTERPACK). Регистр не важен.
• <разрешение>: Право доступа, которое будет выдано игроку (например: vip.access, group.guest).
• <макс_исп>: Максимальное количество раз, которое этот код может быть использован всеми игроками вместе. Введите -1 для снятия лимита.
• <дата_начала> и <время_начала>: Дата и время, когда код станет доступен для активации.
• <дата_окончания> и <время_окончания>: Дата и время, когда активация кода станет невозможна.
• <часы_действия>: Длительность действия выданного разрешения в часах (например, 24, 168).

Формат даты и времени: ДД.ММ.ГГГГ ЧЧ:ММ (24-часовой формат).

Пример:/promo create SUMMER2026 vip.temp 500 01.06.2026 10:00 31.08.2026 23:59 72Этот код выдаст разрешение vip.temp на 72 часа (3 дня), его можно активировать 500 раз в течение лета.

Удаление кода​

/promo delete <код>

Удаляет ранее созданный промокод из системы. Игроки больше не смогут его активировать.

• Пример использования:/promo delete SUMMER2026

Просмотр списка кодов​

/promo list

Выводит в чат администратора полный список всех созданных промокодов с подробной информацией:

• Код и привязанное разрешение.
• Период активности (с какого по какое время).
• Количество использований (Исп.).
• Лимит активаций (Макс.).
• Длительность действия бонуса в часах.

Полная очистка базы данных​

/promo wipe

Полностью удаляет все промокоды из системы.

⚠️ Внимание: используйте эту команду с осторожностью. Действие необратимо.

---

⚖️ Юридическое уведомление​

Копирование, декомпиляция, изменение исходного кода и распространение данного плагина без предварительного письменного согласия автора (tm-max34) строго запрещены.

Все права на интеллектуальную собственность принадлежат автору. Использование плагина допускается только на условиях сохранения данного уведомления.