EzAfk - Управление AFK для серверов Minecraft

Управление AFK стало проще.

EzAfk - это современный и легкий плагин управления AFK для серверов Paper, Spigot, Folia, Bukkit и Purpur. По факту, если у вас сервер на 50 слотов, а 20 из них просто висят в афк ради фарма - это потеря онлайна и лишняя нагрузка. Этот плагин автоматизирует обнаружение неактивных игроков, выдает награды или списывает деньги за простой, дает персоналу панель управления в реальном времени и интегрируется с популярными плагинами. И все это без просадок TPS.

v3.1.2 · Minecraft 1.21.x - 26.2 · Java 21+ · Paper / Spigot / Bukkit / Purpur / Folia

---

Основные возможности

Функция	Описание
Обнаружение AFK	Таймер бездействия с настраиваемыми оповещениями в чате, титулами, анимациями, изменением ника и эффектом слепоты
Анти-обход	Блокировка бесконечного потока воды, езды на транспортных средствах и пузырьковых колонн для сброса таймера
AFK Кик	Кик неактивных игроков через заданное время, опционально только когда сервер полный
Предупреждения о кике	Многоэтапные сообщения (в чате и/или титулами) за заданные интервалы перед киком
Админ GUI	Панель /afk gui со списком всех AFK игроков, кик, сообщение, телепорт и кастомные команды в один клик
AFK Зоны	Кубоидные регионы, где игроки получают награды (экономика, команды или предметы) за нахождение в AFK
Экономические списания	Списание разовой платы за вход и/или регулярной платы за AFK через любой плагин экономики Vault
Таблица лидеров AFK	Накопительное время AFK для каждого игрока, таблица лидеров /afk top, сохраняется между перезапусками
PlaceholderAPI	16 плейсхолдеров для статуса, времени сессии, итогов, счетчиков, префиксов/суффиксов и игрового времени
Мультиязычность	EN, ES, NL, RU, ZH, DE, полностью настраивается для каждого сервера
Хранилища данных	YAML (по умолчанию), SQLite или MySQL
Simple Voice Chat	Воспроизведение кастомного MP3 звука, когда игрок уходит в AFK

В свежем обновлении 3.1.2 автор исправил поддержку тегов MiniMessage в сообщениях с PlaceholderAPI, а также добавил постоянные белый и чёрный списки для обхода AFK-проверки.

Установка

1. Скачайте EzAfk-x.x.x.jar из файлов выше.
2. Закиньте его в папку plugins/ вашего сервера. Кстати, если вы хостите сервер на BungeeHost (https://bungee.host), этот плагин устанавливается в один клик через панель и сразу подхватывается ядром Paper или Purpur.
3. Перезапустите сервер. EzAfk автоматически создаст все конфиги.
4. Отредактируйте plugins/EzAfk/config.yml для настройки нужных функций.
5. Введите /afk reload в игре, чтобы применить изменения без перезапуска.

Совет: Перед тем как включать экономические списания за AFK, убедитесь, что у вас установлен Vault и привязан к экономике. Иначе плагин просто проигнорирует эту функцию, и игроки будут стоять бесплатно.

---

Команды

Команда	Описание	Права
/afk	Включить/выключить свой статус AFK	(нет)
/afk reload	Перезагрузить все файлы конфигурации	ezafk.reload
/afk gui	Открыть панель администратора AFK	ezafk.gui
/afk toggle <player>	Принудительно сменить статус AFK игрока	ezafk.toggle
/afk bypass whitelist <add|remove|list> [player]	Управление белым списком обхода	ezafk.bypass.manage
/afk bypass blacklist <add|remove|list> [player]	Управление черным списком обхода	ezafk.bypass.manage
/afk bypass <player>	Включить обход для игрока на сессию	ezafk.bypass.manage
/afk info <player>	Посмотреть детали сессии AFK игрока	ezafk.info
/afk time [player]	Посмотреть общее время AFK	ezafk.time
/afk time reset <player>	Сбросить время AFK игрока	ezafk.time.reset
/afk top	Показать таблицу лидеров по времени AFK	ezafk.top
/afk zone pos1 / pos2	Выбрать углы зоны	ezafk.zone.manage
/afk zone add <name>	Создать зону AFK	ezafk.zone.manage
/afk zone remove <name>	Удалить зону AFK	ezafk.zone.manage
/afk zone list	Список всех зон	ezafk.zone.list

Алиасы: /ezafk, /ea, /afktime, /afktop

---

Права (Permissions)

Узел	По умолчанию	Описание
ezafk.reload	OP	Перезагрузка конфигурации
ezafk.bypass	OP	Никогда не помечаться как AFK автоматически
ezafk.bypass.manage	OP	Управление обходом для других игроков
ezafk.toggle	OP	Смена статуса AFK других игроков
ezafk.info	OP	Просмотр деталей AFK других игроков
ezafk.kick.bypass	OP	Никогда не кикаться EzAfk
ezafk.gui	OP	Открытие админ-панели
ezafk.gui.view-active	OP	Просмотр не-AFK игроков в GUI
ezafk.gui.actions	OP	Использование кнопок действий в GUI
ezafk.time	все	Просмотр своего времени AFK
ezafk.time.others	OP	Просмотр времени AFK другого игрока
ezafk.time.reset	OP	Сброс времени AFK игрока
ezafk.top	OP	Просмотр таблицы лидеров
ezafk.economy.bypass	OP	Игнорировать экономические списания за AFK
ezafk.zone.list	OP	Список зон AFK
ezafk.zone.manage	OP	Создание и удаление зон

---

PlaceholderAPI плейсхолдеры

Требуется PlaceholderAPI. Расширение регистрируется автоматически. Дополнительная настройка не нужна.

Плейсхолдер	Возвращает
%ezafk_status%	AFK или ACTIVE
%ezafk_status_colored%	&cAFK или &aACTIVE
%ezafk_since%	Секунд с начала сессии AFK (пусто, если не AFK)
%ezafk_last_active%	Секунд с последней активности игрока
%ezafk_total_seconds%	Всего секунд AFK за все время
%ezafk_total%	Общее время AFK HH:MM:SS
%ezafk_total_formatted%	Развернуто, например 2 hours 15 minutes
%ezafk_prefix%	Настроенный префикс AFK в нике
%ezafk_suffix%	Настроенный суффикс AFK в нике
%ezafk_playtime_active_seconds%	Активное (не-AFK) время в секундах
%ezafk_playtime_active%	Активное время HH:MM:SS
%ezafk_playtime_active_formatted%	Активное время развернуто
%ezafk_afk_count% / %ezafk_afk_players%	Количество AFK игроков
%ezafk_active_count% / %ezafk_active_players%	Количество не-AFK игроков

---

Обзор конфигурации

Настройки EzAfk разбиты по отдельным файлам для удобства:

text config.yml Обнаружение AFK, кик, анти-обход, экономика, интеграции gui.yml Раскладка админ-GUI и кнопки действий zones.yml Определения AFK зон с координатами и наградами mysql.yml Подключение к БД (только если storage.type: mysql) messages/ Языковые файлы: en.yml, es.yml, nl.yml, ru.yml, zh.yml, de.yml

Основные настройки (config.yml)

yaml afk: timeout: 300 # секунд бездействия -> AFK broadcast: enabled: true # оповещать в чате об AFK title: enabled: true # показывать титул игроку в AFK anti: infinite-waterflow: false infinite-vehicle: false bubble-column: false

kick: enabled: false # кикать AFK игроков enabledWhenFull: false # кикать только когда сервер полон timeout: 600 # секунд в AFK перед киком warnings: enabled: true intervals: [60, 30, 10] mode: both # chat | title | both

economy: enabled: false cost: enter: enabled: true amount: 25.0

storage: type: yaml # yaml | sqlite | mysql flush-interval-seconds: 30

Важный нюанс: Если у вас слабый сервер и вы используете базу MySQL для статистики, не ставьте flush-interval-seconds слишком низко. Иначе плагин будет слишком часто обращаться к базе и может вызвать микрофризы. 30 секунд - идеальный баланс.

---

Интеграции

Интеграция	Заметки
Vault / Economy	Требуется для списаний за экономику и наград в зонах
PlaceholderAPI	Авто-обнаружение; предоставляет 16 AFK плейсхолдеров
WorldGuard	Добавляет флаг региона afk-bypass; используйте /rg flag <region> afk-bypass allow
TAB	Делегирует форматирование префикса AFK в списке табов плагину TAB
Simple Voice Chat	Проигрывает MP3 звуки при смене статуса AFK
bStats	Анонимная статистика (отключается в config.yml)
Spigot update checker	Напоминание в консоли при выходе новой версии

Скачать плагин EzAfk стоит всем админам, которые устали бороться с афкшерами вручную. Он легкий, гибкий и закрывает все базовые потребности сервера по контролю активности.