AfkDetector

# AfkDetector

AfkDetector es un plugin ligero y de bajo impacto para la detección de AFK en servidores de Hytale.

Rastrea la actividad de los jugadores utilizando muestreo de movimiento (solo horizontal), marca a los jugadores como AFK después de un tiempo de inactividad configurable, opcionalmente les advierte y puede expulsar de manera segura a los jugadores inactivos utilizando el sistema de comandos nativo del servidor.

Diseñado para ser:
– eficiente
– recargable
– amigable para administradores

—

## Características

– Detecta jugadores AFK basándose en el movimiento
– Configuración basada en segundos (sin spam de milisegundos)
– Recarga de configuración en vivo (`/afk reload`)
– Comando de estado AFK (`/afk`)
– Reiniciar temporizador AFK (`/afk reset`)
– Listar jugadores AFK (`/afk whois`)
– Expulsión automática opcional
– Exención basada en permisos (sin expulsiones para administradores)
– Programación segura para recargas (sin reinicio requerido)

—

## Instalación

1. Construir el JAR del plugin
2. Colocarlo en el directorio `mods/` de tu servidor
3. Iniciar el servidor
4. Editar `config.json` en la carpeta de datos del plugin
5. Recargar con: /afk reload

—

## Configuración (`config.json`)

Todos los valores son basados en segundos para facilitar la lectura y reducir el impacto en el servidor.

“`json
{
“checkEverySeconds”: 5,
“afkAfterSeconds”: 180,

“kickEnabled”: false,
“kickAfterSeconds”: 600,
“warnBeforeKickSeconds”: 30,

“moveEpsilon”: 0.08,

“afkMessage”: “[AFK] Ahora estás AFK.”,
“backMessage”: “[AFK] ¡Bienvenido de nuevo!”,
“warnMessage”: “[AFK] Muévete o serás expulsado pronto.”,
“kickMessage”: “Expulsado por estar AFK demasiado tiempo.”,

“bypassPermission”: “afk.bypass”,
“reloadPermission”: “afk.reload”,

“enableCommand”: true
}
“`

—

Comandos

Comando
Descripción

/afk
Muestra tu estado AFK

/afk reset
Reinicia tu temporizador AFK

/afk reload
Recarga config.json

/afk whois
Lista a los jugadores AFK

/afk whois <nombre>
Muestra el estado AFK de un jugador

Permisos

Permiso
Descripción

afk.bypass
Exento de expulsiones por AFK

afk.reload
Permite /afk reload y /afk whois

Cómo Funciona

Los jugadores son revisados en un intervalo configurable (predeterminado: cada 5s)
El movimiento horizontal más allá de un pequeño umbral cuenta como actividad
Después de estar inactivo el tiempo suficiente, los jugadores son marcados como AFK
Las advertencias y expulsiones opcionales utilizan el sistema de comandos nativo del servidor
Toda la lógica se ejecuta de manera segura en el hilo del mundo

Compatibilidad