AfkPlus - мод для управления AFK в Майнкрафт

AfkPlus - это мощный мод для Fabric, который полностью перерабатывает систему AFK (отошёл от клавиатуры) на сервере и в одиночной игре. Он форк популярного AfkDisplay, но с кучей новых фич и полной переработкой кода под современные версии Minecraft (1.19.2-1.21.4+). Если вы администратор сервера и хотите гибко контролировать, кто и почему отошёл, а также показывать это в списке игроков - этот мод вам точно пригодится.

Что умеет AfkPlus?

• Показывать AFK-статус в списке игроков: кто отошёл, сколько времени прошло, причина.
• Placeholder API - все плейсхолдеры (%afkplus:afk%, %afkplus:duration%, %afkplus:time%, %afkplus:reason%, %afkplus:invulnerable%) поддерживают форматирование MiniMessage (цвета, жирность, курсив, даже ссылки).
• Работает в одиночной игре и на LAN-сервере - можно тестировать локально.
• Полная совместимость с LuckPerms - права на команды, группы, исключения из кика.
• Интеграция с другими модами: Styled Playerlist, Vanish, Carpet Mod, Styled Nicknames, Styled Chat.

Основные фичи

Управление AFK

• Автоматическое определение - если игрок ничего не делает заданное время (по умолчанию 240 секунд), он помечается AFK.
• Команды:
  • /afk [причина] - самому уйти в AFK с указанием причины.
  • /noafk - временно отключить автоопределение AFK.
  • /afkinfo [игрок] - посмотреть статус, время и причину.
  • /afkplus set/clear/info/update/damage enable/disable - админские команды для управления AFK других игроков.

Защита AFK-игроков

• Отключение урона (disableDamage) - через 15 секунд после ухода в AFK игрок становится неуязвимым. Настраивается сообщение и кулдаун.
• Обход сна - AFK-игроки не учитываются при подсчёте процента спящих (чтобы не мешали смене дня).
• Блокировка фантомов - AFK-игроки не дают спауниться фантомам.

Автоматический кик AFK-игроков

• Можно включить авто-кик через заданное время после ухода в AFK. Настраивается:
  • Время кика (отдельно от таймаута).
  • Исключение для креатива/спектатора.
  • Уровень прав для безопасных от кика.
  • Сообщение при кике и оповещение сервера.

Гибкая настройка сообщений и плейсхолдеров

• Любые сообщения (уход, возврат, кик, включение/отключение урона) можно полностью кастомизировать через MiniMessage-форматирование.
• Плейсхолдеры можно использовать в других модах, например, в Styled Playerlist, чтобы добавить статус [AFK] к имени игрока.
• Формат длительности - можно выбрать: обычный (HH:mm:ss.fff), "человеческий" (1 день 2 часа 3 минуты), ISO или свой кастомный.

Конфигурация

Конфигурация хранится в afkplus.json в папке config вашего сервера. Вот пример основных настроек:

{
  "___comment": "AfkPlus-1.21.4-1.7.4-SNAPSHOT Config",
  "config_date": "Fri, 3 Jan 2025 00:05:08 -0500",
  "afk_plus": {
    "enableAfkCommand": true,
    "enableNoAfkCommand": true,
    "enableAfkInfoCommand": true,
    "afkCommandPermissions": 0,
    "noAfkCommandPermissions": 0,
    "afkInfoCommandPermissions": 2,
    "afkPlusCommandPermissions": 3,
    "afkCommandCooldown": 5,
    "debugMode": false
  },
  "packet": {
    "timeoutSeconds": 240,
    "resetOnMovement": false,
    "resetOnLook": false,
    "ignoreAttacks": false,
    "bypassSleepCount": true,
    "bypassInsomnia": true,
    "afkTimeoutString": "<i><gray>timeout<r>",
    "afkTimeoutIgnoreAttack": "<i><gray>only swinging their sword<r>"
  },
  "disable_damage": {
    "disableDamage": false,
    "disableDamageCooldown": 15,
    "whenDamageDisabled": "%player:displayname% <yellow>is marked as <red>Invulnerable.<r>",
    "whenDamageEnabled": "%player:displayname% <yellow>is no longer <red>Invulnerable.<r>"
  },
  "afk_kick": {
    "afkKickEnabled": false,
    "afkKickNonSurvival": false,
    "afkKickTimer": 3000,
    "afkKickSafePermissions": 3,
    "afkKickMessage": "<copper>AFK beyond the allowed time limit set by your Administrator.<r>",
    "whenKicked": "%player:displayname% <copper>was kicked for being AFK.<r>",
    "whenKickedDefaultReason": "<copper>AFK timeout",
    "whenKickedDurationDefaultPrefix": " <gray>(Gone for: <green>",
    "whenKickedDurationNamedPrefix": " <gray>(%player:displayname% was gone for: <green>",
    "whenKickedDurationSuffix": "<gray>)"
  },
  "player_list": {
    "enableListDisplay": true,
    "afkPlayerName": "<i><gray>[AFK%afkplus:invulnerable%] %player:displayname%<r>",
    "updateInterval": 10
  },
  "place_holder": {
    "afkPlaceholder": "<i><gray>[AFK%afkplus:invulnerable%]<r>",
    "afkPlusNamePlaceholderAfk": "<i><gray>[AFK%afkplus:invulnerable%] %player:displayname_unformatted%<r>",
    "afkPlusNamePlaceholder": "%player:displayname%",
    "afkDurationPlaceholderFormatting": "<green>",
    "afkTimePlaceholderFormatting": "<green>",
    "afkReasonPlaceholderFormatting": "",
    "afkInvulnerablePlaceholder": ":<red>I<r>",
    "duration": {
      "option": "REGULAR",
      "customFormat": ""
    },
    "timeDate": {
      "option": "REGULAR",
      "customFormat": ""
    }
  },
  "message": {
    "enableMessages": true,
    "whenAfk": "%player:displayname% <yellow>is now AFK<r>",
    "whenAfkPunctuation": "<yellow>,<r> ",
    "whenReturn": "%player:displayname% <yellow>is no longer AFK<r>",
    "whenReturnDurationPrefix": " <gray>(Gone for: <green>",
    "whenReturnDurationSuffix": "<gray>)",
    "defaultReason": "<gray>poof!<r>",
    "afkCooldownGreeting": "<yellow>Welcome back, <r>%player:display_name%<r>, <yellow>did you miss anything fun?",
    "whileYourVanished": "<red>You are vanished, and probably shouldn't be doing that.<r>"
  }
}

Все параметры подробно описаны в комментариях конфига - можно тонко подстроить под свой сервер.

Совместимость и возможные конфликты

Мод проверяет наличие других модов/датапаков, которые могут пересекаться по функционалу, и предупреждает администратора. Вот список известных:

• AfkDisplay - форк, не рекомендуется ставить вместе.
• Vanilla Tweaks AFK Data Pack - меняет отображение списка игроков.
• AntiLogout, Auto AFK, Sessility, Playtime-Tracker, SvrUtil - могут конфликтовать по командам /afk или таймауту.

Если используете Styled Playerlist - специально заложена интеграция для корректного отображения AFK-статуса с префиксами LuckPerms.

Для кого этот мод?

Для администраторов серверов, где много игроков и нужно:

• чётко видеть, кто отошёл;
• автоматически кикать тех, кто слишком долго AFK;
• защищать AFK-игроков от урона;
• интегрировать AFK-статус в другие системы (плейсхолдеры, чат, список игроков).

Скачайте мод AfkPlus и настройте управление AFK на своём сервере Minecraft - гибко, удобно и без компромиссов.