AfkDetector

AfkDetector

AfkDetector is a lightweight, low-impact AFK detection plugin for Hytale servers.

48.0 загрузок
Обновлён 15 дней назад

Скриншоты

Описание

AfkDetector Banner

Разработчик AfkDetector

AfkDetector Легкий, малоэффективный плагин для обнаружения AFK Серверы Hytale.

Контролирует активность игроков с помощью Выборка горизонтального движения, отмечает игроков как AFK после настраиваемого периода простоя, опционально предупреждает их и может безопасно пинать простаивающих игроков с помощью сервера Нативная командная система.

Предназначен для:

  • исполнитель
  • перезаряжаемый
  • Административно-дружественный

Особенности

  • Обнаружение игроков АФК на основе движения игроков
  • Конфигурация на основе секунд (без миллисекундного спама)
  • Перезагрузка конфигураций в реальном времени (/afk скачать)
  • Командующий статусом АФК/афк)
  • Сброс таймера AFK/afk сброс)
  • Список игроков АФКкто такой)
  • Дополнительный автоматический удар
  • шунтирование на основе разрешения (нет ударов для администраторов)
  • Перезагрузка-безопасное планирование (не требуется перезагрузка сервера)

Установка

  1. Создайте плагин JAR
  2. Поместите JAR в сервер модс/ справочник
  3. Запустите сервер
  4. Редактировать config.json в папке данных плагина
  5. Перезагрузить плагин: /afk reload

️ Конфигурацияconfig.json)

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

{
"Проверить все вторые": 5,
"afkAfterSeconds": 180,

"kickEnabled": ложный,
"KickAfterSeconds": 600,
"предупреждение": 30,

"moveEpsilon": 0,08,

"afkMessage": "[AFK] Ты теперь АФК.
«backMessage»: «Добро пожаловать!»
"Предупреждение": "Двигайся, или тебя скоро пнут".
«kickMessage»: «Kicked for be AFK too long»

"bypassPermission": "afk.bypass",
"reloadPermission": "afk.reload",

«Возможность командовать»: правда
?

️ Команды

Командование Описание
/афк Показать свой статус AFK
/afk сброс Сброс времени AFK
/afk скачать Перезарядка config.json
кто такой Список всех игроков АФК
/afk whois <name> Показывает статус АФК для конкретного игрока

Разрешения

Разрешение Описание
afk.bypass Освобождение от ударов АФК
afk.reload Позволяет /afk скачать и кто такой

Как это работает

  • Игроки проверяются через настраиваемый интервал (по умолчанию) 5 секунд)
  • Горизонтальное движение за небольшой порог считается активностью.
  • После достаточно долгого простоя игроки отмечены AFK.
  • Опциональные предупреждения и пинки используют Нативная серверная команда
  • Вся логика надежно работает на мировая нить

Сравнительность и дизайн

  • Разработан для современного Сервер Hytale строит
  • Избегайте хрупких зависимостей API
  • Использование отражения, где API различаются между версиями
  • Безопасно перезагружать без перезагрузки сервера.
Показать оригинальное описание (English)

AfkDetector Banner

🛡️ AfkDetector

AfkDetector is a lightweight, low-impact AFK detection plugin for Hytale servers.

It monitors player activity using horizontal movement sampling, marks players as AFK after a configurable idle period, optionally warns them, and can safely kick idle players using the server’s native command system.

Designed to be:

  • Performant
  • 🔄 Reloadable
  • 🧰 Admin-friendly

✨ Features

  • Detects AFK players based on player movement
  • Seconds-based configuration (no millisecond spam)
  • Live config reload (/afk reload)
  • AFK status command (/afk)
  • Reset AFK timer (/afk reset)
  • List AFK players (/afk whois)
  • Optional automatic kicking
  • Permission-based bypass (no kicks for admins)
  • Reload-safe scheduling (no server restart required)

📦 Installation

  1. Build the plugin JAR
  2. Place the JAR into your server’s mods/ directory
  3. Start the server
  4. Edit config.json in the plugin data folder
  5. Reload the plugin with: /afk reload

⚙️ Configuration (config.json)

All values are seconds-based for readability and minimal server impact.

{
  "checkEverySeconds": 5,
  "afkAfterSeconds": 180,

  "kickEnabled": false,
  "kickAfterSeconds": 600,
  "warnBeforeKickSeconds": 30,

  "moveEpsilon": 0.08,

  "afkMessage": "[AFK] You are now AFK.",
  "backMessage": "[AFK] Welcome back!",
  "warnMessage": "[AFK] Move or you will be kicked soon.",
  "kickMessage": "Kicked for being AFK too long.",

  "bypassPermission": "afk.bypass",
  "reloadPermission": "afk.reload",

  "enableCommand": true
}

⌨️ Commands

Command Description
/afk Shows your AFK status
/afk reset Resets your AFK timer
/afk reload Reloads config.json
/afk whois Lists all AFK players
/afk whois <name> Shows AFK status for a specific player

Permissions

Permission Description
afk.bypass Exempt from AFK kicks
afk.reload Allows /afk reload and /afk whois

How It Works

  • Players are checked at configurable interval (default 5 seconds)
  • Horizontal Movement beyond a small threshold counts as activity
  • After being idle long enough, players are marked AFK
  • Optional warnings and kicks use the native server command
  • All logic runs safely on the world thread

Comparability & Design

  • Designed for modern Hytale server builds
  • Avoids fragile API dependencies
  • Uses reflection where APIs differ between version
  • Safe to reload without restarting server.

Последние версии

AfkDetector-1.0.0.jar

Early Access 18.01.2026 22.8 КБ