ModsJava
PromoTimeCode
Java mod listed for Minecraft 1.7–1.18. Downloads from the MC Java Mods app on Android.
⬇ Download on SpigotEN:
----------------------------------------------------------------
What is this?
PromoTimeCode is a powerful Minecraft server plugin that creates a referral program for YouTube bloggers and streamers.
YouTubers create unique promo codes, players activate them, play a certain amount of time on the server, and receive a group via LuckPerms. The YouTuber receives a reward for each player who completes the conditions.
----------------------------------------------------------------
✨ Features
----------------------------------------------------------------
How it works?
YouTuber → Creates a code → Player activates → Player plays → Reward is granted automatically!
1. YouTuber creates a promo code:
- One YouTuber = one code
- Cannot activate own code
2. Player activates the code:
- Only 1 code per account
- IP limit — max activations from one IP (configurable)
3. Player plays on the server:
- Time is counted only while online
- AFK check — timer pauses if player doesn't move
- Logging out "freezes" progress
4. Reward is granted automatically!
- Group via LuckPerms
- Coins added to YouTuber's balance
- In-game notifications
----------------------------------------------------------------
Commands
For all players:
For YouTubers:
For administrators:
----------------------------------------------------------------
Anti-Cheat Protection
----------------------------------------------------------------
⚙ Installation
----------------------------------------------------------------
⚙ Configuration
settings:
default-duration-minutes: 60 # Group duration (minutes)
default-balance: 50.0 # YouTuber reward (coins)
default-playtime-minutes: 120 # Time required to play (minutes)
check-interval-seconds: 10 # Check interval (seconds)
one-code-per-youtuber: true # 1 code per YouTuber
messages:
prefix: "&6[Promo] &r"
code-created: "&aPromo code &e%code% &ahas been created!"
extra:
log-actions: true # Log to console
default-group: "VIP" # Default group
anti-abuse:
max-activations-per-ip: 3 # Max activations from one IP
enable-afk-check: true # Enable AFK check
afk-threshold-seconds: 60 # Seconds without movement = AFK
enable-ip-limit: true # Enable IP limit
afk-warning-cooldown: 30 # Warning cooldown (seconds)
----------------------------------------------------------------
Requirements
----------------------------------------------------------------
Data Storage
/plugins/PromoTimeCode/
├── config.yml # Main configuration
├── playerdata.json # Player data (encrypted)
├── ip_data.json # IP activation data
├── abuse_log.txt # Abuse logs
└── codes/
└── KVASS2024.json # Each promo code's data
Code file format:
{
"code": "KVASS2024",
"groupName": "vip",
"durationMinutes": 60,
"rewardMoney": 50.0,
"requiredPlaytime": 120,
"author": "Kvassuk",
"players": ["uuid1", "uuid2"],
"balance": 400.0,
"completedPlayers": 8
}
----------------------------------------------------------------
Examples
For YouTubers:
/promo create MYCODE
/promo info
=== Your promo code MYCODE ===
Group: vip
Duration: 60 min
YouTuber reward: 50.0 coins
Required playtime: 120 min
Activated by: 15 players
Completed: 8 players
Current balance: 400.0 coins
For players:
/promo MYCODE
[Promo] You have successfully activated code MYCODE!
Play 120 minutes to receive your reward
/promo progress
=== Progress for code MYCODE ===
Played: 65/120 minutes
Status: ⏳ Waiting...
----------------------------------------------------------------
❓ FAQ
No! Anti-cheat protection prevents YouTubers from activating their own promo codes.
By default — only 1 code. Administrators can create unlimited codes.
Only 1 code. Players cannot activate multiple promo codes.
No! Time is counted only while online. Progress is saved when they leave.
No! All data is stored in JSON files. MySQL is not required.
Yes! All messages and colors can be changed in config.yml without rebuilding the plugin.
IP limit restricts activations from one IP. AFK check pauses timer when player is idle. All suspicious activity is logged.
----------------------------------------------------------------
Bug Reports
----------------------------------------------------------------
License
This project is distributed under the MIT license.
----------------------------------------------------------------
Support
----------------------------------------------------------------
----------------------------------------------------------------
Quick Start
# 1. Install LuckPerms
# 2. Download PromoTimeCode.jar
# 3. Copy to plugins/
# 4. Restart the server
# 5. Done!
# Create your first code:
/promo create TEST2024
# Activate the code:
/promo TEST2024
# Check progress:
/promo progress
RU:
----------------------------------------------------------------
Что это?
PromoTimeCode — это мощный плагин для серверов Minecraft, который создает реферальную программу для YouTube-блогеров и стримеров.
Ютуберы создают уникальные промокоды, игроки их активируют, отыгрывают определенное время на сервере и получают группу через LuckPerms. Ютубер получает вознаграждение за каждого игрока, выполнившего условия.
----------------------------------------------------------------
✨ Возможности
----------------------------------------------------------------
Как это работает?
Ютубер → Создает код → Игрок активирует → Игрок играет → Награда выдается автоматически!
1. Ютубер создает промокод:
- Один ютубер = один код
- Нельзя активировать свой код
2. Игрок активирует код:
- Только 1 код на аккаунт
- IP-лимит — макс. активаций с одного IP (настраивается)
3. Игрок играет на сервере:
- Время считается только в онлайне
- AFK-проверка — таймер останавливается, если игрок не двигается
- Выход из игры "замораживает" прогресс
4. Награда выдается автоматически!
- Группа через LuckPerms
- Монеты на баланс ютуберу
- Уведомления в чате
----------------------------------------------------------------
Команды
Для всех игроков:
Для ютуберов:
Для администраторов:
----------------------------------------------------------------
Защита от накруток
----------------------------------------------------------------
⚙ Установка
----------------------------------------------------------------
⚙ Конфигурация
settings:
default-duration-minutes: 60 # Время действия группы (мин)
default-balance: 50.0 # Награда ютуберу (монет)
default-playtime-minutes: 120 # Время для отыгровки (мин)
check-interval-seconds: 10 # Интервал проверки (сек)
one-code-per-youtuber: true # 1 код на ютубера
messages:
prefix: "&6[Promo] &r"
code-created: "&aПромокод &e%code% &aсоздан!"
extra:
log-actions: true # Логи в консоль
default-group: "VIP" # Группа по умолчанию
anti-abuse:
max-activations-per-ip: 3 # Максимум активаций с одного IP
enable-afk-check: true # Включить AFK-проверку
afk-threshold-seconds: 60 # Секунд без движения = AFK
enable-ip-limit: true # Включить IP-лимит
afk-warning-cooldown: 30 # Интервал между предупреждениями (сек)
----------------------------------------------------------------
Требования
----------------------------------------------------------------
Хранение данных
/plugins/PromoTimeCode/
├── config.yml # Основные настройки
├── playerdata.json # Данные игроков (зашифровано)
├── ip_data.json # Данные активаций по IP
├── abuse_log.txt # Логи нарушений
└── codes/
└── KVASS2024.json # Данные каждого промокода
Формат файла кода:
{
"code": "KVASS2024",
"groupName": "vip",
"durationMinutes": 60,
"rewardMoney": 50.0,
"requiredPlaytime": 120,
"author": "Kvassuk",
"players": ["uuid1", "uuid2"],
"balance": 400.0,
"completedPlayers": 8
}
----------------------------------------------------------------
Примеры использования
Для ютубера:
/promo create MYCODE
/promo info
=== Ваш промокод MYCODE ===
Группа: vip
Длительность: 60 мин
Награда ютуберу: 50.0 монет
Нужно отыграть: 120 мин
Активировали: 15 игроков
Выполнили условия: 8 игроков
Текущий баланс: 400.0 монет
Для игрока:
/promo MYCODE
[Promo] Вы успешно активировали код MYCODE!
Отыграйте 120 минут для получения награды
/promo progress
=== Прогресс по коду MYCODE ===
Отыграно: 65/120 минут
Статус: ⏳ Ожидание...
----------------------------------------------------------------
❓ Часто задаваемые вопросы
Нет! Встроена защита от накрутки — ютубер не может активировать свой собственный промокод.
По умолчанию — только 1 код. Администраторы могут создавать сколько угодно.
Только 1 код. Нельзя активировать несколько промокодов на один аккаунт.
Нет! Время считается только когда игрок онлайн. При выходе прогресс сохраняется.
Нет! Все данные хранятся в обычных файлах (JSON). Не требуется MySQL.
Да! Все сообщения и цвета можно изменить в config.yml без пересборки плагина.
IP-лимит ограничивает активации с одного IP. AFK-проверка останавливает таймер при бездействии. Все подозрительные действия логируются.
----------------------------------------------------------------
Сообщения об ошибках
----------------------------------------------------------------
Лицензия
Этот проект распространяется под лицензией MIT.
----------------------------------------------------------------
Поддержка
----------------------------------------------------------------
----------------------------------------------------------------
Быстрый старт
# 1. Установи LuckPerms
# 2. Скачай PromoTimeCode.jar
# 3. Скопируй в plugins/
# 4. Перезапусти сервер
# 5. Готово!
# Создай первый код:
/promo create TEST2024
# Активируй код:
/promo TEST2024
# Проверь прогресс:
/promo progress
PromoTimeCode
Referral program for YouTube bloggers on your Minecraft server
Referral program for YouTube bloggers on your Minecraft server
Code (Text):
Paper: 1.7.4 – 26.2
LuckPerms: Required
Java: 17+
License: MIT
LuckPerms: Required
Java: 17+
License: MIT
What is this?
PromoTimeCode is a powerful Minecraft server plugin that creates a referral program for YouTube bloggers and streamers.
YouTubers create unique promo codes, players activate them, play a certain amount of time on the server, and receive a group via LuckPerms. The YouTuber receives a reward for each player who completes the conditions.
----------------------------------------------------------------
✨ Features
- Create unique promo codes
- Automatic playtime tracking (online only)
- Auto-reward system via LuckPerms
- YouTuber balance system
- IP-based anti-bot protection — limit activations from one IP
- AFK check — timer pauses when player is idle
- Fully customizable messages and settings
----------------------------------------------------------------
How it works?
YouTuber → Creates a code → Player activates → Player plays → Reward is granted automatically!
1. YouTuber creates a promo code:
Code (Text):
/promo create KVASS2024
- Cannot activate own code
2. Player activates the code:
Code (Text):
/promo KVASS2024
- IP limit — max activations from one IP (configurable)
3. Player plays on the server:
Code (Text):
/promo progress
=== Progress for code KVASS2024 ===
Played: 65/120 minutes
Status: ⏳ Waiting...
=== Progress for code KVASS2024 ===
Played: 65/120 minutes
Status: ⏳ Waiting...
- AFK check — timer pauses if player doesn't move
- Logging out "freezes" progress
4. Reward is granted automatically!
- Group via LuckPerms
- Coins added to YouTuber's balance
- In-game notifications
----------------------------------------------------------------
Commands
For all players:
| /promo help | Show help |
| /promo <code> | Activate a promo code |
| /promo progress | Show your progress |
For YouTubers:
| /promo create <code> | Create a promo code |
| /promo info | Info about your code |
For administrators:
| /promo show <code> | View code info |
| /promo balance add/remove <code> <amount> | Change balance |
| /promo delete <code> | Delete a code |
| /promo reload | Reload the plugin |
| /promo ipstats <player> | View IP statistics |
----------------------------------------------------------------
Anti-Cheat Protection
- Cannot activate own code — YouTuber cannot earn rewards from their own code
- Only 1 code per account — Player cannot activate multiple codes
- Only 1 code per YouTuber — YouTuber cannot create multiple codes
- Time counted online — Cannot cheat time while offline
- Time resets on activation — Previous playtime does not count
- IP limit — Restrict activations from one IP (configurable)
- AFK check — Timer pauses when player is idle (configurable)
- Abuse logging — All suspicious activations are logged to abuse_log.txt
----------------------------------------------------------------
⚙ Installation
- Install LuckPerms on your server
- Download PromoTimeCode.jar
- Copy to the plugins/ folder
- Restart the server
- Edit config.yml if needed
- Grant permissions:
Code (Text):/lp user <player> permission set promotimecode.youtube true
----------------------------------------------------------------
⚙ Configuration
Code (Text):
settings:
default-duration-minutes: 60 # Group duration (minutes)
default-balance: 50.0 # YouTuber reward (coins)
default-playtime-minutes: 120 # Time required to play (minutes)
check-interval-seconds: 10 # Check interval (seconds)
one-code-per-youtuber: true # 1 code per YouTuber
messages:
prefix: "&6[Promo] &r"
code-created: "&aPromo code &e%code% &ahas been created!"
extra:
log-actions: true # Log to console
default-group: "VIP" # Default group
anti-abuse:
max-activations-per-ip: 3 # Max activations from one IP
enable-afk-check: true # Enable AFK check
afk-threshold-seconds: 60 # Seconds without movement = AFK
enable-ip-limit: true # Enable IP limit
afk-warning-cooldown: 30 # Warning cooldown (seconds)
Requirements
| Core | Paper / Spigot 1.7.4+ |
| Dependencies | LuckPerms |
| Java | 17 or higher |
----------------------------------------------------------------
Data Storage
Code (Text):
/plugins/PromoTimeCode/
├── config.yml # Main configuration
├── playerdata.json # Player data (encrypted)
├── ip_data.json # IP activation data
├── abuse_log.txt # Abuse logs
└── codes/
└── KVASS2024.json # Each promo code's data
Code (Text):
{
"code": "KVASS2024",
"groupName": "vip",
"durationMinutes": 60,
"rewardMoney": 50.0,
"requiredPlaytime": 120,
"author": "Kvassuk",
"players": ["uuid1", "uuid2"],
"balance": 400.0,
"completedPlayers": 8
}
Examples
For YouTubers:
Code (Text):
/promo create MYCODE
/promo info
=== Your promo code MYCODE ===
Group: vip
Duration: 60 min
YouTuber reward: 50.0 coins
Required playtime: 120 min
Activated by: 15 players
Completed: 8 players
Current balance: 400.0 coins
Code (Text):
/promo MYCODE
[Promo] You have successfully activated code MYCODE!
Play 120 minutes to receive your reward
/promo progress
=== Progress for code MYCODE ===
Played: 65/120 minutes
Status: ⏳ Waiting...
❓ FAQ
Can a YouTuber activate their own code?Click to expand...
How many codes can a YouTuber create?Click to expand...
How many codes can a player activate?Click to expand...
Does time count if the player leaves the server?Click to expand...
Is a database required?Click to expand...
Can messages be customized?Click to expand...
How does anti-bot protection work?Click to expand...
----------------------------------------------------------------
Bug Reports
- Create an Issue on https://github.com/Henezi/PromoTimeCode
- Attach server logs
- Describe steps to reproduce
----------------------------------------------------------------
License
This project is distributed under the MIT license.
----------------------------------------------------------------
Support
- Discord: https://discord.gg/VWZ2edCgnj
- Email: [email protected]
- GitHub: https://github.com/Henezi/PromoTimeCode
----------------------------------------------------------------
⭐ Like the plugin? Star it on GitHub! ⭐
Made with ❤️ for the Minecraft community
Made with ❤️ for the Minecraft community
----------------------------------------------------------------
Quick Start
Code (Text):
# 1. Install LuckPerms
# 2. Download PromoTimeCode.jar
# 3. Copy to plugins/
# 4. Restart the server
# 5. Done!
# Create your first code:
/promo create TEST2024
# Activate the code:
/promo TEST2024
# Check progress:
/promo progress
Good luck and have fun!
RU:
PromoTimeCode
Реферальная программа для YouTube-блогеров на вашем сервере Minecraft
Реферальная программа для YouTube-блогеров на вашем сервере Minecraft
Code (Text):
Paper: 1.7.4 – 26.2
LuckPerms: Required
Java: 17+
Лицензия: MIT
LuckPerms: Required
Java: 17+
Лицензия: MIT
Что это?
PromoTimeCode — это мощный плагин для серверов Minecraft, который создает реферальную программу для YouTube-блогеров и стримеров.
Ютуберы создают уникальные промокоды, игроки их активируют, отыгрывают определенное время на сервере и получают группу через LuckPerms. Ютубер получает вознаграждение за каждого игрока, выполнившего условия.
----------------------------------------------------------------
✨ Возможности
- Создание уникальных промокодов
- Автоматический подсчёт времени (только в онлайне)
- Автовыдача групп через LuckPerms
- Баланс ютубера
- Защита от ботов по IP — ограничение активаций с одного IP
- AFK-проверка — таймер останавливается при бездействии
- Гибкая настройка сообщений и параметров
----------------------------------------------------------------
Как это работает?
Ютубер → Создает код → Игрок активирует → Игрок играет → Награда выдается автоматически!
1. Ютубер создает промокод:
Code (Text):
/promo create KVASS2024
- Нельзя активировать свой код
2. Игрок активирует код:
Code (Text):
/promo KVASS2024
- IP-лимит — макс. активаций с одного IP (настраивается)
3. Игрок играет на сервере:
Code (Text):
/promo progress
=== Прогресс по коду KVASS2024 ===
Отыграно: 65/120 минут
Статус: ⏳ Ожидание...
=== Прогресс по коду KVASS2024 ===
Отыграно: 65/120 минут
Статус: ⏳ Ожидание...
- AFK-проверка — таймер останавливается, если игрок не двигается
- Выход из игры "замораживает" прогресс
4. Награда выдается автоматически!
- Группа через LuckPerms
- Монеты на баланс ютуберу
- Уведомления в чате
----------------------------------------------------------------
Команды
Для всех игроков:
| /promo help | Показать справку |
| /promo <код> | Активировать промокод |
| /promo progress | Показать прогресс |
Для ютуберов:
| /promo create <код> | Создать промокод |
| /promo info | Информация о вашем коде |
Для администраторов:
| /promo show <код> | Информация о коде |
| /promo balance add/remove <код> <сумма> | Изменить баланс |
| /promo delete <код> | Удалить промокод |
| /promo reload | Перезагрузить плагин |
| /promo ipstats <игрок> | Статистика по IP |
----------------------------------------------------------------
Защита от накруток
- Свой код нельзя активировать — ютубер не может получить награду за свой код
- Только 1 код на аккаунт — игрок не может активировать несколько кодов
- Только 1 код на ютубера — ютубер не может создать много кодов
- Время считается онлайн — нельзя накрутить время в оффлайне
- Время обнуляется при активации — старое время игры не учитывается
- IP-лимит — ограничение активаций с одного IP (настраивается)
- AFK-проверка — таймер останавливается при бездействии (настраивается)
- Логирование нарушений — все подозрительные активации пишутся в abuse_log.txt
----------------------------------------------------------------
⚙ Установка
- Установи LuckPerms на сервер
- Скачай PromoTimeCode.jar
- Скопируй в папку plugins/
- Перезапусти сервер
- Отредактируй config.yml при необходимости
- Выдай права:
Code (Text):/lp user <игрок> permission set promotimecode.youtube true
----------------------------------------------------------------
⚙ Конфигурация
Code (Text):
settings:
default-duration-minutes: 60 # Время действия группы (мин)
default-balance: 50.0 # Награда ютуберу (монет)
default-playtime-minutes: 120 # Время для отыгровки (мин)
check-interval-seconds: 10 # Интервал проверки (сек)
one-code-per-youtuber: true # 1 код на ютубера
messages:
prefix: "&6[Promo] &r"
code-created: "&aПромокод &e%code% &aсоздан!"
extra:
log-actions: true # Логи в консоль
default-group: "VIP" # Группа по умолчанию
anti-abuse:
max-activations-per-ip: 3 # Максимум активаций с одного IP
enable-afk-check: true # Включить AFK-проверку
afk-threshold-seconds: 60 # Секунд без движения = AFK
enable-ip-limit: true # Включить IP-лимит
afk-warning-cooldown: 30 # Интервал между предупреждениями (сек)
Требования
| Ядро | Paper / Spigot 1.7.4+ |
| Зависимости | LuckPerms |
| Java | 17 или выше |
----------------------------------------------------------------
Хранение данных
Code (Text):
/plugins/PromoTimeCode/
├── config.yml # Основные настройки
├── playerdata.json # Данные игроков (зашифровано)
├── ip_data.json # Данные активаций по IP
├── abuse_log.txt # Логи нарушений
└── codes/
└── KVASS2024.json # Данные каждого промокода
Code (Text):
{
"code": "KVASS2024",
"groupName": "vip",
"durationMinutes": 60,
"rewardMoney": 50.0,
"requiredPlaytime": 120,
"author": "Kvassuk",
"players": ["uuid1", "uuid2"],
"balance": 400.0,
"completedPlayers": 8
}
Примеры использования
Для ютубера:
Code (Text):
/promo create MYCODE
/promo info
=== Ваш промокод MYCODE ===
Группа: vip
Длительность: 60 мин
Награда ютуберу: 50.0 монет
Нужно отыграть: 120 мин
Активировали: 15 игроков
Выполнили условия: 8 игроков
Текущий баланс: 400.0 монет
Code (Text):
/promo MYCODE
[Promo] Вы успешно активировали код MYCODE!
Отыграйте 120 минут для получения награды
/promo progress
=== Прогресс по коду MYCODE ===
Отыграно: 65/120 минут
Статус: ⏳ Ожидание...
❓ Часто задаваемые вопросы
Может ли ютубер активировать свой код?Click to expand...
Сколько кодов может создать один ютубер?Click to expand...
Сколько кодов может активировать один игрок?Click to expand...
Считается ли время, если игрок вышел с сервера?Click to expand...
Нужна ли база данных?Click to expand...
Можно ли настроить сообщения?Click to expand...
Как работает защита от ботов?Click to expand...
----------------------------------------------------------------
Сообщения об ошибках
- Создайте Issue на https://github.com/Henezi/PromoTimeCode
- Приложите логи сервера
- Опишите шаги для воспроизведения
----------------------------------------------------------------
Лицензия
Этот проект распространяется под лицензией MIT.
----------------------------------------------------------------
Поддержка
- Discord: https://discord.gg/VWZ2edCgnj
- Email: [email protected]
- GitHub: https://github.com/Henezi/PromoTimeCode
----------------------------------------------------------------
⭐ Понравился плагин? Поставь звезду на GitHub! ⭐
Сделано с ❤️ для Minecraft сообщества
Сделано с ❤️ для Minecraft сообщества
----------------------------------------------------------------
Быстрый старт
Code (Text):
# 1. Установи LuckPerms
# 2. Скачай PromoTimeCode.jar
# 3. Скопируй в plugins/
# 4. Перезапусти сервер
# 5. Готово!
# Создай первый код:
/promo create TEST2024
# Активируй код:
/promo TEST2024
# Проверь прогресс:
/promo progress
Удачи в использовании!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.7, 1.8, 1.9
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
PromoTimeCode is a free Minecraft Java mod. Compatible with Minecraft 1.7, 1.8, 1.9, 1.10 and newer. Downloaded 25 times (via Spigot). Download it and open it directly in the game.