JustAFK (Джаст АФК)

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

Возможности

• Игрок получает AFK после заданного времени бездействия.
• Активностью считаются нажатия движения, прыжок, приседание, спринт, чат, ломание и установка блоков, рыбалка, использование предметов и взаимодействие с блоками, мобами и сущностями.
• Отбрасывание, взрывы, вода, поршни, падение, телепортация, смерть и возрождение не сбрасывают AFK: статус снимается только от действий самого игрока.
• Статус и его длительность сохраняются после смерти и возрождения, но сбрасываются при повторном подключении к серверу.
• Можно выводить перед именем AFK-игрока в TAB настраиваемую пометку с длительностью, например 0m, 5m или 1h.
• Плагин отправляет сообщения о переходе в AFK и возвращении в игру. Их можно показывать всем, только операторам или отключить.
• Плагин только отмечает AFK и не кикает, не замораживает, не телепортирует и не ограничивает игроков.

Команды

• /afk — переключить свой статус AFK.
• /afk <игрок> [on|off|toggle] — изменить статус находящегося на сервере игрока.
• /justafk help — показать справку.
• /justafk status — показать активные настройки.
• /justafk reload — перечитать config.yml после ручного редактирования.
• /justafk set enabled <on|off> — включить или выключить плагин.
• /justafk set automatic-afk <on|off> — включить или выключить автоматическое определение AFK.
• /justafk set timeout <seconds> — задать время бездействия до AFK.
• /justafk set announcements <all|ops|none> — настроить получателей сообщений.
• /justafk set playerlist <on|off> — включить или выключить пометку в TAB.

Вместо /justafk можно использовать /jafk. Команды поддерживают автодополнение.

Права

• justafk.use — использовать /afk для себя.
• justafk.others — менять статус других игроков.
• justafk.config — доступ к административным командам /justafk.
• justafk.admin — все права плагина.

Плагин работает со стандартными правами Bukkit и совместим с LuckPerms.

Настройка

Основные параметры в config.yml:

• enabled — полное включение плагина.
• automatic-afk-enabled — автоматическая выдача AFK; ручная команда /afk остаётся доступна при выключенной автоматике.
• inactivity-timeout-seconds — время бездействия в секундах, по умолчанию 300.
• announcements.audience — получатели сообщений: all, ops или none.
• player-list.enabled — пометка AFK в TAB.
• player-list.format — формат пометки; должен содержать {duration}.
• messages.became-afk и messages.became-active — сообщения о смене статуса; в них доступен {player}.

Поддерживаются цветовые коды с &. Изменения настроек через команды сохраняются сразу.

Требования

Нужен сервер Java Edition с Bukkit API: Paper, Purpur, Folia, Spigot или CraftBukkit. Плагин работает только на стороне сервера: игрокам не нужны моды или дополнительные файлы.

Для сборки с определением нажатий требуется Java 21 или новее. Плагин не требует Vault, ProtocolLib, PlaceholderAPI, базы данных и других внешних зависимостей. На прокси BungeeCord, Velocity и Waterfall его устанавливают на внутренние игровые серверы, а не в папку плагинов прокси.