AfkDetector
AfkDetector is a lightweight, low-impact AFK detection plugin for Hytale servers.
Описание

Разработчик AfkDetector
AfkDetector Легкий, малоэффективный плагин для обнаружения AFK Серверы Hytale.
Контролирует активность игроков с помощью Выборка горизонтального движения, отмечает игроков как AFK после настраиваемого периода простоя, опционально предупреждает их и может безопасно пинать простаивающих игроков с помощью сервера Нативная командная система.
Предназначен для:
- исполнитель
- перезаряжаемый
- Административно-дружественный
Особенности
- Обнаружение игроков АФК на основе движения игроков
- Конфигурация на основе секунд (без миллисекундного спама)
- Перезагрузка конфигураций в реальном времени (
/afk скачать) - Командующий статусом АФК
/афк) - Сброс таймера AFK
/afk сброс) - Список игроков АФК
кто такой) - Дополнительный автоматический удар
- шунтирование на основе разрешения (нет ударов для администраторов)
- Перезагрузка-безопасное планирование (не требуется перезагрузка сервера)
Установка
- Создайте плагин JAR
- Поместите JAR в сервер
модс/справочник - Запустите сервер
- Редактировать
config.jsonв папке данных плагина - Перезагрузить плагин: /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
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
- Build the plugin JAR
- Place the JAR into your server’s
mods/directory - Start the server
- Edit
config.jsonin the plugin data folder - 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
Информация
Авторы:
Категории:
Версии игры:
Создан: 19.01.2026