Sentinel [Anticheat]

Sentinel
Showcase video

Video de presentación en YouTube + explicación: (enlace disponible pronto)

Un plugin anticheat del lado del servidor de Hytale enfocado en verificaciones de movimiento/interacción con alertas para el personal, registros de banderas recientes y notificaciones y castigos opcionales a través de webhook de Discord.

Checks actuales

• Temporizador: Detecta movimientos e interacciones anormalmente rápidos.
• Vuelo: Marca el vuelo en modo Aventura.
• Velocidad: Marca la velocidad de movimiento horizontal sostenida por encima de un umbral.
• Resistencia infinita: Marca el sprint sin agotamiento de resistencia.

Características

• Alertas para el personal en el chat
• Alertas opcionales de webhook de Discord
• Castigos automáticos opcionales (desconexión/baneo) en recuentos altos de banderas

Configuración

El archivo de configuración se crea en el directorio de datos del plugin en la primera ejecución (típicamente mods/Al3x_HytaleAC/config.json).

Configuración predeterminada:

{
  "timer": {
    "enabled": true,
    "minMsInteractionPacket": 9,
    "minNanoMovementPacket": 15000000.0,
    "flagsNeededToAlert": 100,
    "flagsNeededToPunish": 1000
  },
  "fly": {
    "enabled": true,
    "flagsNeededToAlert": 1,
    "flagsNeededToPunish": 5
  },
  "speed": {
    "enabled": true,
    "maxSpeedThreshold": 9.5,
    "flagsNeededToAlert": 1,
    "flagsNeededToPunish": 5
  },
  "infStamina": {
    "enabled": true,
    "flagsNeededToAlert": 4,
    "flagsNeededToPunish": 8
  },
  "alerts": {
    "resetIntervalSeconds": 60,
    "notifyReset": true,
    "debugMode": false,
    "discordWebhookUrl": ""
  },
  "punishments": {
    "reason": "[Anticheat] Cheating",
    "shouldBan": false
  }
}

Opciones de configuración:

Ruta
Tipo
Predeterminado
Descripción

timer.enabled
booleano
true
Habilita o deshabilita completamente la verificación del temporizador.

timer.minMsInteractionPacket
int
9
Milisegundos mínimos entre paquetes de interacción antes de marcar.

timer.minNanoMovementPacket
número
15000000.0
Nanosegundos promedio mínimos entre paquetes de movimiento antes de marcar.

timer.flagsNeededToAlert
int
100
Banderas requeridas antes de enviar una alerta al personal (temporizador).

timer.flagsNeededToPunish
int
1000
Banderas requeridas antes de que se activen los castigos (temporizador).

fly.enabled
booleano
true
Habilita o deshabilita completamente la verificación de vuelo.

fly.flagsNeededToAlert
int
1
Banderas requeridas antes de enviar una alerta al personal (vuelo).

fly.flagsNeededToPunish
int
5
Banderas requeridas antes de que se activen los castigos (vuelo).

speed.enabled
booleano
true
Habilita o deshabilita completamente la verificación de velocidad.

speed.maxSpeedThreshold
número
14.0
Velocidad horizontal máxima antes de marcar.

speed.flagsNeededToAlert
int
1
Banderas requeridas antes de enviar una alerta al personal (velocidad).

speed.flagsNeededToPunish
int
5
Banderas requeridas antes de que se activen los castigos (velocidad).

infStamina.enabled
booleano
true
Habilita o deshabilita completamente la verificación de resistencia infinita.

infStamina.flagsNeededToAlert
int
2
Banderas requeridas antes de enviar una alerta al personal (resistencia).

infStamina.flagsNeededToPunish
int
4
Banderas requeridas antes de que se activen los castigos (resistencia).

alerts.resetIntervalSeconds
int
60
Intervalo en segundos para limpiar las banderas de los jugadores.

alerts.notifyReset
booleano
true
Si true, notifica a los miembros del personal cuando se reinician las banderas.

alerts.debugMode
booleano
false
Si true, imprime salida de depuración en la consola del servidor para diferentes verificaciones. Y no ejecuta castigos.

alerts.discordWebhookUrl
string
""
URL del webhook de Discord para alertas; déjelo vacío para deshabilitar.

punishments.reason
string
"[Anticheat] Cheating"
Razón utilizada para desconexiones/baneos y webhooks de castigo.

punishments.shouldBan
booleano
false
Si true, banea en lugar de desconectar cuando se activan los castigos.

Alertas de webhook

Si alerts.discordWebhookUrl está configurado, las alertas para el personal y las acciones de castigo también se publican en Discord. Las alertas están limitadas a una por segundo, excepto para los castigos.

Castigos

Cuando cualquier verificación alcanza su umbral de flagsNeededToPunish, el plugin desconectará al jugador por defecto y enviará un webhook de castigo. Si punishments.shouldBan es true, emitirá un baneo infinito en su lugar.

Comandos

Comando
Descripción
Permiso
Notas

/anticheat reload
Recarga las opciones de configuración del plugin.
anticheat.command
Tenga en cuenta que un reinicio del servidor es mejor.

/anticheat help
Muestra los comandos anticheat disponibles.
anticheat.command
N/A

/alerts
Activa o desactiva la recepción de alertas anticheat.
hytaleac.alerts
Los jugadores con este permiso son inscritos automáticamente al unirse.

/logs <player>
Muestra las banderas recientes para un jugador.
hytaleac.logs
Los registros se borran en el intervalo de reinicio.

Permisos

• anticheat.command: Usa /anticheat help y /anticheat reload.
• hytaleac.alerts: Usa /alerts y recibe alertas del personal.
• hytaleac.logs: Usa /logs <player>.

Instalación

Obtén el .jar de la última versión.

Copia el jar en el directorio de mods del servidor Hytale.

Inicia el servidor para generar config.json en el directorio de datos del plugin.

Solución de problemas

• Demasiadas/banderas falsas: aumenta flagsNeededToAlert o flagsNeededToPunish de la verificación relevante, y/o relaja los umbrales (por ejemplo timer.minMsInteractionPacket, timer.minNanoMovementPacket, o speed.maxSpeedThreshold).
• Sin alertas para el personal: asegúrate de que el personal tenga hytaleac.alerts, y que hayan activado las alertas con /alerts.
• Registros siempre vacíos: los registros se reinician en alerts.resetIntervalSeconds, esto es para evitar que las banderas falsas saturen los registros.
• Sin alertas de Discord: verifica que alerts.discordWebhookUrl sea una URL de webhook válida.

Notas de rendimiento

Hytale aún es nuevo y la API del servidor está evolucionando. Aunque este plugin ha sido probado en hardware de gama baja, el rendimiento puede variar según la carga del servidor y el número de jugadores. Y puede romperse si una actualización repentina cambia cómo funcionan los paquetes. Siempre monitorea el rendimiento de tu servidor después de agregar nuevos plugins.