Documentación de ZeroDev Sentinel

ZeroDev Sentinel: instalación y uso

ZeroDev Sentinel es un resource anti-cheat del lado del servidor para FiveM. Registra lo que ve el servidor, lo juzga con reglas que se explican solas en frases claras y da a tu staff las pruebas antes de que se castigue a nadie. Arranca en el nivel de protección Watch: registra y no castiga a nadie hasta que tú decidas otra cosa. Esta guía cubre la versión 0.1.2 en servidores ESX, QBCore, Qbox y standalone.

Para ZeroDev Sentinel 0.1.223 min de lecturaActualizado el

1. Requisitos

  • OneSync activado (set onesync on en server.cfg). El resource declara OneSync como dependencia, así que FXServer no lo arranca sin OneSync.
  • Un artifact de FXServer que ejecute scripts de Node 22 (cualquier artifact recomendado actual; el manifest pide node_version '22'). Node se encarga del hashing, la compresión, el listado de archivos y la ruta web de apelaciones.
  • Opcional: oxmysql. Con él, Sentinel guarda sus registros en tu base de datos y crea sus propias tablas en el primer arranque. No hay ningún archivo SQL que importar. Sin él, todo se guarda en el almacén key-value propio del resource.
  • Opcional: pma-voice, para escuchar el chat de voz de un jugador desde la consola o el panel del navegador.

El framework solo importa para dos cosas: el rastro de dinero e items (dinero e items que ninguna tienda, trabajo ni script pagó, bucles de recompensas, rollbacks) y quién es tu staff (grupos ACE, que usan todos los frameworks). La detección, los casos, los clips, la consola, el panel del navegador, Discord y el escritorio del dueño funcionan igual en todos los frameworks.

2. Instalación en cinco minutos

Nada necesita SQL, no hace falta editar el config para el primer arranque y no se modifica ningún otro resource.

Paso 1: Pon la carpeta en resources

Copia la carpeta zerodev_sentinel en tu carpeta resources. Mantén exactamente ese nombre de carpeta: el archivo guard informa a zerodev_sentinel, y sentinel:guard te avisa si la carpeta se llama de cualquier otra forma.

Paso 2: Añádelo a server.cfg

Arráncalo después de oxmysql y de tu framework, para que el almacenamiento y el rastro de dinero los encuentren al arrancar. El orden exacto para tu framework está en la sección 3.

Paso 3: Arranca el servidor

La consola muestra una caja de arranque y un código de dueño de un solo uso. Cada fila de la caja es una comprobación real; la última línea dice READY, o NOT READY con el número de problemas (sección 15).

Paso 4: Reclama el puesto de dueño

Entra al servidor y escribe /sentinel owner <code> en el chat. Ahora tienes el puesto de dueño (sección 4).

Paso 5: Abre el escritorio del dueño

Pulsa F7 en el juego (o escribe sentinel:console en F8) y abre OWNER. La hoja First run muestra qué está hecho y qué no: Discord, el almacenamiento de clips, tu staff y sus permisos. Cada línea tiene un botón. Después juega unos días en Watch, lee lo que Sentinel encontró en la hoja Right now y cambia el nivel de protección a Recommended en el mismo escritorio (sección 6).

3. Tu framework

Sentinel encuentra el framework y el inventario por sí solo al arrancar. No hay nada que configurar. sentinel:trail en la consola del servidor muestra qué adapter eligió.

ESX Legacy

server.cfg
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel
  • Dinero e items: se leen de los propios server events de ESX (dinero de cuenta añadido, quitado o fijado; items del inventario añadidos o quitados; items dados de jugador a jugador, con ambos lados enlazados). El rollback usa los propios métodos de jugador de ESX y vuelve a leer el resultado.
  • ESX con ox_inventory: el dinero se sigue igual. En este modo los métodos de items de ESX no devuelven resultados, así que Sentinel decide solo a partir de la relectura.
  • Staff: da a tus admins el permiso ACE (sección 5). El group.admin propio de ESX funciona como grupo ACE cuando añades la línea para él.

QBCore

server.cfg
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory      # or ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Dinero: se lee del evento de cambio de dinero de QBCore (añadir, quitar y fijar, con el motivo). Una pérdida y una ganancia igual en el mismo momento se enlazan como transferencia, porque QBCore no tiene un evento de transferencia propio.
  • Items: con ox_inventory, los items se siguen a través de sus hooks. Con qb-inventory, los cambios de items no se siguen (el payload de su listener no está documentado), pero un rollback sí puede mover items con los exports documentados de qb-inventory.
  • Staff: los grupos de permisos de QBCore son grupos ACE (group.admin, group.god). Añade las líneas ACE de la sección 5.

Qbox

server.cfg
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Dinero: se lee del evento de cambio de dinero de Qbox; los saldos se vuelven a leer con los propios exports de qbx_core. El dinero cambiado a un personaje desconectado (por citizen id) no dispara ningún evento, así que no aparece en el rastro.
  • Items: Qbox usa ox_inventory, y Sentinel sigue sus items a través de los hooks de ox_inventory. Los items que representan dinero del framework se dejan a la parte del framework.
  • Staff: grupos ACE, como en QBCore.

Standalone (sin framework)

server.cfg
set onesync on
ensure zerodev_sentinel
  • Todo funciona salvo el rastro de dinero e items: movimiento, mundo, eventos, eventos cebo, godmode, state bags, armas, casos, clips, replay, consola, panel, Discord, roles y bans.
  • Con ox_inventory y sin framework, los items se siguen a través de ox_inventory.
  • Almacenamiento: el almacén key-value, u oxmysql si lo arrancas antes.

Comprobar que funciona

  • sentinel:health: otra vez la caja de arranque. Cada fila es una comprobación real; READY significa que no falta nada.
  • sentinel:diag: por qué se eligieron el almacenamiento, los adapters y el nivel, cada regla con sus contadores y las últimas decisiones.
  • sentinel:trail: el adapter de dinero e items en uso y los últimos cambios de un jugador.

En el modo de almacenamiento automático, Sentinel usa oxmysql solo si oxmysql ya está arrancado (espera hasta 15 segundos mientras oxmysql arranca); si oxmysql arranca más tarde, usa el almacén key-value.

4. Primer arranque: el puesto de dueño

El primer arranque muestra en la consola del servidor un código de un solo uso, válido durante 30 minutos (sentinel:owner code muestra uno nuevo). Entra y escribe /sentinel owner <code>: el puesto queda ligado a tu cuenta y el código deja de valer.

Solo el puesto de dueño puede cambiar las claves, el nivel de protección, los roles y los permisos. sentinel:owner reset en la consola del servidor libera el puesto si tienes que pasarlo a otra cuenta.

5. Staff y permisos

En el escritorio del dueño, STAFF: elige un jugador conectado, elige un rol y pulsa GRANT. Vienen cuatro roles:

Rol Puede, de serie
Soporte ver casos, gestionar reportes, el mapa de servicio
Moderator como Support, más replays, kick y cuarentena
Admin como Moderator, más revelar, absolver, vista en directo, solicitudes de ban, apelaciones
Senior admin como Admin, más un ban que se aplica al momento

Los permisos los eliges tú. Cada rol es una lista de interruptores que puedes cambiar. Crea tus propios roles a partir de una copia (por ejemplo "Trial mod"), renombra cualquier rol y da a una persona un interruptor extra o quítale uno sin cambiar su rol. Los interruptores marcados como peligrosos (ban inmediato, escuchar el chat de voz, ajustes, gestión del staff) piden una segunda pulsación. Cada cambio se escribe en el registro del staff, así que siempre puedes ver quién cambió qué.

ACE sigue funcionando para los servidores que ya lo usan, y se lee en cada comprobación:

server.cfg
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin
Permiso Rol que da
sentinel.admin Admin (Senior admin hasta que se reclame el puesto de dueño) y todos los comandos sentinel:* en el juego
sentinel.staff Moderator; las reglas de movimiento tratan el propio movimiento de un miembro del staff como explicado

Unos pocos comandos (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) están registrados como restringidos: en el juego también necesitan command.<name>. La línea habitual add_ace group.admin command allow lo cubre. La consola del servidor puede ejecutar todos los comandos.

6. El nivel de protección

Un interruptor en el escritorio del dueño (OWNER, PROTECTION), y también sentinel:level en la consola del servidor y Config.Protection en config/config.lua. Lo que pongas en el escritorio se guarda y tiene prioridad sobre la línea del config después de un reinicio.

  • Watch: cada regla vigila y anota lo que habría hecho; no se avisa a nadie y a nadie le pasa nada. Mientras tanto, Sentinel aprende qué es normal en tu servidor: el observador de eventos (frecuencia y forma de cada evento) y la comprobación al entrar solo aprenden en Watch; los límites de entidades, combate y dinero siguen aprendiendo del juego limpio.
  • Recommended: todas las reglas están activas. El staff recibe alertas con las pruebas y se abre un caso. Sentinel nunca castiga por su cuenta; decide tu staff.
  • Strict: como Recommended, y una puntuación alta pone al jugador en cuarentena hasta que el staff lo revise; un hallazgo de nivel de prueba (Tier A: se disparó un evento cebo, una petición falsificada) además pone en cola un ban para la ban wave.

Bajo el interruptor, el escritorio muestra cada regla con su estado y de dónde viene ese estado. Ahí puedes fijar una sola regla en Live o Shadow si tu servidor lo necesita (por ejemplo, una regla que no para de marcar uno de tus propios scripts); una línea state en Config.Rules la fija en el archivo de config y tiene prioridad sobre el escritorio.

Un orden sensato:

  1. Watch durante unos días de juego normal.
  2. Lee lo que habrían hecho las reglas: la hoja Right now, sentinel:diag rules (la columna shadow cuenta las veces que una regla habría puntuado) y sentinel:diag decisions 100.
  3. Fija en Shadow cualquier regla que haya marcado a alguien de confianza, y cuéntanoslo.
  4. Cambia a Recommended. Ahora el staff ve casos y pruebas; nadie es castigado automáticamente.
  5. Strict cuando confíes en lo que te muestra Recommended.

Para volver atrás en cualquier momento: Watch en el escritorio, o sentinel:level watch.

7. La consola de staff (F7)

Pulsa F7 en el juego (o escribe sentinel:console en F8). Cada jugador puede cambiar la tecla en los ajustes del juego (Key Bindings, FiveM). Esc la cierra.

  • Right now dice con palabras claras lo que está pasando en tu servidor: quién parece una amenaza y por qué, qué se ha probado, qué se ha explicado (un revive, un teleport de un script tuyo) y qué te necesita a ti. Cada jugador que importa tiene una fila: qué hizo, qué es probablemente, cuánta seguridad tiene Sentinel (Unusual, Suspicious, Very likely, Proven), qué ha hecho ya Sentinel y un siguiente paso.
  • Expedientes: primero los casos abiertos, cada uno con su hallazgo, las pruebas, clips de pantalla, el sello (si la cadena de hashes del caso sigue verificándose) y los botones REVEAL, QUARANTINE, CLEAR y BAN (CLEAR y BAN piden una segunda pulsación).
  • Mapa de servicio: los jugadores conectados sobre un modelo 3D de la isla. El terreno lo mide el juego del primer miembro del staff y se guarda en data/map/.
  • Play replay cierra la consola y reproduce el incidente en un mundo privado; pulsa Backspace para volver.
  • Dueño (solo el puesto de dueño): First run, Protection, Keys, Staff, Internal affairs y Server check.

Los comandos en el juego van en F8 sin barra, o en el chat con barra (/sentinel:diag).

8. El panel del navegador

El mismo escritorio en un navegador web, para cuando no estás en el juego:

  • en el PC del servidor: http://127.0.0.1:<port>/zerodev_sentinel/panel/ (el puerto es el de tu servidor, 30120 por defecto)
  • desde otro sitio: http://<server address>:<port>/zerodev_sentinel/panel/, o tu propia dirección HTTPS delante

Iniciar sesión. Usa un código de un solo uso: escribe /sentinel panel en el juego (el código solo lo ves tú, funciona una vez y durante 5 minutos) o ejecuta sentinel:panel <id or account> en la consola del servidor. Una sesión dura 8 horas; SIGN OUT y END ALL MY SESSIONS la cierran. Tu rol y tus interruptores se aplican en el navegador igual que en el juego.

Vista en vivo. El staff con el interruptor de vista en vivo puede ver la pantalla de cualquier jugador conectado desde el panel o la consola. No se guarda nada en disco salvo que pulses Save to case.

Escucha. Para escuchar el chat de voz de ese jugador hace falta el interruptor de escucha (por defecto solo el dueño) y pma-voice. El sonido se reproduce a través de tu propio juego, así que tienes que estar en el juego en el mismo servidor.

Cada vista en vivo y cada escucha se anota en el registro del staff y en el caso del jugador, y a los jugadores se les avisa en su primera entrada de que el staff puede mirar y escuchar (el aviso de grabación, Config.Notice).

9. Casos, cuarentena, kick, ban y apelaciones

Cuando se encuentra algo, Right now nombra al jugador con palabras claras: qué hizo, cuánta seguridad tiene Sentinel y qué hizo al respecto. Abre el caso para ver las pruebas (posiciones, clips de pantalla sellados con SHA-256, un replay en 3D) y usa los botones:

  • REVEAL: muestra los identificadores del jugador.
  • QUARANTINE: saca al jugador del mundo real y lo mete en un routing bucket privado hasta que el staff lo revise. sentinel:release <server id> lo devuelve.
  • CLEAR: no hay cheat; cierra el caso y detiene su ban en cola.
  • KICK: fuera del servidor, con un motivo que el jugador lee.
  • BAN: a través de la ban wave, con un código de apelación.

La ban wave. Los bans, incluido un BAN pulsado en la consola, se ponen en cola para la ban wave y solo se aplican en Strict, por defecto en un momento aleatorio entre 2 y 24 horas después (Config.Actions). sentinel:wave los lista, sentinel:wave now <account> aplica uno al momento, sentinel:wave cancel <account> lo cancela.

Apelaciones. Un jugador baneado ve un código de apelación en el mensaje de rechazo (8 letras y dígitos). No puede entrar para apelar, así que la apelación te llega desde fuera del juego:

  1. A través de tu staff. El jugador envía el código a tu staff (un ticket de Discord, un correo). Un miembro del staff lo registra con sentinel:appeal <code> <text>.
  2. A través de la ruta web. Sentinel responde en la propia dirección de tu servidor: http://<server address>:<port>/zerodev_sentinel/appeal. Solo acepta un POST con JSON { "code": "...", "text": "...", "contact": "optional" } (texto de 10 a 2000 caracteres), así que está pensada para un formulario en tu web, no como una página a la que mandar a los jugadores. Toda petición aceptada recibe la misma respuesta, 202 "received", coincida o no el código con un ban. Demasiadas peticiones desde una dirección (5 en 10 minutos) o en total (30 por minuto) reciben 429. Detrás de tu propio reverse proxy HTTPS, pon set sentinel_http_proxy true para que los límites cuenten la dirección del visitante.

El texto de rechazo no dice dónde apelar. Díselo a los jugadores en tus normas, o escribe tu propio texto con tu enlace en Config.Bans.message (mantén el %s, se convierte en el código), por ejemplo 'You are banned. Appeal at discord.gg/yourserver with code %s'.

El staff decide en la consola o con sentinel:decide <case or code> accept|reject [note]. Accept levanta todos los bans activos de esa cuenta o ese caso y cancela un ban de la wave en cola; reject mantiene el ban. Una decisión es definitiva y se anota en el registro del caso. sentinel:appeals lista las abiertas.

10. Reportes y asuntos internos

Reportes de jugadores. Cualquier jugador escribe /report <server id> <what happened> para reportar a un jugador o a un miembro del staff. Los últimos dos minutos alrededor de ambos jugadores se guardan en un caso. El staff cierra un reporte como resuelto, sin infracción, sin pruebas o duplicado. Los reportes sobre el staff van solo al dueño.

Asuntos internos (solo el dueño, en el escritorio del dueño): qué hizo cada miembro del staff y qué necesita un vistazo (concesiones a sí mismos, esconderse en combate, bans sin caso, teleports a jugadores). Se escribe un informe semanal de imparcialidad en data/reports/; sentinel:staff report lo escribe ahora. Nada en el registro del staff castiga al staff.

11. Proteger un resource

Sin configurar nada, Sentinel observa cada evento que los jugadores pueden enviar a tus scripts y juzga al jugador. No puede impedir que se ejecute el handler de otro resource. Para parar una llamada mala antes de que se ejecute un script, añade el guard a ese script.

  1. sentinel:audit lista los eventos de cada resource iniciado que los clientes pueden disparar, clasificados según lo que hacen sus handlers (por ejemplo, un handler que da dinero con una cantidad que elige el cliente). Úsalo para decidir qué resources proteger primero.
  2. sentinel:guard <resource> muestra la línea que hay que añadir y los server_scripts del resource tal como quedarían. La línea del guard tiene que ser el primer server script. El comando solo muestra; no cambia ningún archivo.

lua server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }

  1. Reinicia ese resource. sentinel:guard <resource> ahora dice "guarded since ...". sentinel:guard solo lista todos los resources protegidos.
  2. Añade reglas con sentinel:patch. Hasta que un resource tenga reglas, su guard deja pasar todas las llamadas, salvo las de jugadores en cuarentena, que todos los guards descartan. Ejemplo: como máximo 3 compras en 10 segundos, un nombre de item de hasta 32 caracteres y una cantidad de 1 a 10; una llamada rechazada cuenta como prueba ("hard": true):

text sentinel:patch myshop myshop:buy {"args":[{"type":"string","maxLen":32},{"type":"number","int":true,"min":1,"max":10}],"rate":3,"window":10000,"hard":true}

Para un callback del framework, escribe callback:<name> como evento: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> lista las reglas de un resource; sentinel:patch <resource> <event> off quita una.

El guard nunca edita archivos y nunca cambia lo que recibe un handler. Es Lua simple y legible en guard/guard.lua.

12. Claves de Discord y del almacenamiento de clips

Lo más fácil es el escritorio del dueño, KEYS: pega cada valor y pulsa SAVE. Las claves se guardan solo en el servidor; el escritorio y cada respuesta dicen solo "set" y nunca vuelven a mostrar una clave.

Línea en el escritorio Qué es O en server.cfg (usa set, nunca setr)
Token del bot de Discord un bot que creaste en discord.com/developers e invitaste a tu servidor set sentinel_discord_token "..."
Id del servidor de Discord clic derecho en tu servidor, Copy Server ID (con el modo desarrollador activado) set sentinel_discord_guild "..."
Id del canal de alertas donde se publican los casos, con botones para tu staff set sentinel_discord_channel "..."
Id del canal de apelaciones donde se publican las apelaciones set sentinel_discord_appeals "..."
Clave de FiveManage una clave de medios de fivemanage.com; los clips se suben allí set sentinel_fivemanage_key "..."
Webhook de clips en lugar de FiveManage: un webhook de Discord que recibe los clips set sentinel_clip_webhook "..."
Almacenamiento de clips fivemanage, discord, off o automatic (el primero que esté configurado) set sentinel_clip_storage "..."

Una clave en server.cfg tiene prioridad sobre el escritorio, y el escritorio lo indica. Los botones de Discord siguen los mismos roles e interruptores que la consola. Sin ninguno de estos, los casos y los clips se quedan en tu servidor (data/) y la consola y el panel los muestran.

Las alertas por webhook más sencillas siguen funcionando: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" o sentinel:webhook set <url> en la consola del servidor. sentinel:webhook test envía un mensaje de prueba; sentinel:webhook muestra el estado sin mostrar nunca la URL; sentinel:webhook clear borra la guardada.

13. Qué detecta cada regla

Cada regla escribe una frase clara cuando salta, diciendo qué vio y qué descartó. Antes de que una regla cuente contra alguien, Sentinel comprueba los motivos que lo explicarían (un respawn, un revive, una acción del staff, uno de tus propios scripts que mueve o paga a jugadores). Un hallazgo explicado se registra y nunca puntúa.

  • Nivel A es prueba: algo que solo hace un cheat (un evento cebo que ningún script real llama, una petición falsificada).
  • Nivel B es fuerte: un miembro del staff debería mirarlo. Por sí solo abre un caso solo cuando dos familias distintas coinciden, o la misma se repite.
  • Nivel C es débil: suma a la puntuación y nunca actúa solo.

Movimiento

Regla Detecta Lo explica Nivel
teleport Un salto de más de 150 m (o 3x lo posible) entre dos muestras spawn, respawn o revive, cambio de routing bucket, staff, el evento de teleport de tu script B
foot_speed Correr a más de 12 m/s durante 1.5 s a pie, sin caer, sin ragdoll spawn, respawn, staff, tu script B
air_float Moverse estando congelado (noclip); "caer" sin bajar (fly); moverse rápido por coordenadas mientras el juego dice que el jugador está quieto (menús de velocidad) spawn, respawn, staff, tu script B
foot_rise Subir en vertical a más de 4 m/s a pie durante 3 s spawn, respawn, staff, tu script B
vehicle_speed Un vehículo por encima de 1.3x lo más rápido que alcanza su clase en tu servidor staff, tu script B

Mundo

Regla Detecta Lo explica Nivel
entity_blocked Spawnear un modelo que has bloqueado tus scripts que lo spawnean B
entity_rate / entity_model_rate Spawnear muchas más entidades (o un modelo) por minuto de lo que hacen los jugadores y los scripts tus scripts de spawn B
entity_untrusted Entidades creadas por un cliente sin ningún script que las spawnee tus scripts de spawn B
entity_disguised Una ráfaga del mismo modelo de ped ambiental alrededor de un jugador (un menú que disfraza sus spawns de tráfico) spawn, respawn, cambio de bucket B
explosion_weapon / explosion_rate / explosion_hidden / world_distance Explosiones que el arma en mano no puede causar, demasiadas, invisibles o lejos del jugador las explosiones de tus scripts B
projectile_weapon / projectile_rate Proyectiles que el arma no puede disparar, o demasiados B
ptfx_rate Floods de efectos de partículas (un ataque habitual para crashear y causar lag) B
fire_rate Fuegos iniciados más rápido de lo que permite cualquier arma B

Combate

Regla Detecta Nivel
damage_plausibility Daño por encima del valor posible del arma B
hit_range Impactos desde más allá del alcance del arma B
shot_rate / kill_rate Disparar más rápido que el arma; kills por minuto muy por encima de lo normal en tu servidor B
silent_aim Impactos donde el jugador no apuntaba, repetidos B
aim_stats / aim_stats_backed Porcentaje de headshots y ángulos de snap muy fuera de lo de los jugadores de tu servidor en 30+ peleas C (B con otra familia)
esp_los_backed Apuntar una y otra vez a jugadores que los testigos indican ocultos detrás de paredes De C a B

Eventos y peticiones

Regla Detecta Nivel
bait_event Llamar a un evento plantado que ningún script real usa (los menús de cheats los buscan y los disparan) A
bait_statebag / statebag_write Escribir state bags que solo debería escribir el servidor (hacerse admin, flags de godmode), o state bags demasiado grandes A / B
events_before_ready / _trap Eventos enviados antes de que el jugador haya llegado a spawnear (inyectados antes de entrar) B / A
event_rate / event_shape Un evento llamado mucho más rápido de lo normal, o con argumentos con una forma distinta a las llamadas normales de tu servidor B
event_flood 500+ llamadas en 10 s; en el propio kick por overflow de FiveM, se listan los eventos más llamados B
guard_rule / guard_hard Saltarse una regla que pusiste en un evento protegido (cantidad, frecuencia, distancia) B / A

Economía

Regla Detecta Nivel
money_nowhere / item_nowhere Dinero o items que ninguna tienda, trabajo ni script ha dado (eventos de desarrollo, ventas de tienda filtradas) B
economy_repeat Un evento de recompensa o de trabajo pagado 10 veces en 30 s (farmear llamándolo en bucle) B
money_jump / money_rate Un salto repentino del saldo o un ritmo de ingresos muy por encima de lo normal en tu servidor B
economy_trap Reclamar una recompensa plantada que ningún trabajo real paga A
weapon_not_owned Llevar un arma que el inventario nunca dio B

El juego del jugador (testigo)

Regla Detecta Nivel
godmode El servidor ve al jugador invencible durante 30 s (no es una zona segura compartida) B
witness_backed Señales del juego respaldadas por lo que ve el propio servidor (godmode, invisibilidad, sin colisión) B
witness_bait El juego responde a una comprobación que no debería conocer A
witness_tamper Las propias comprobaciones de Sentinel en el juego se han hookeado o modificado B

Identidad y archivos

Regla Detecta Nivel
ban_fingerprint Un jugador baneado que vuelve con una cuenta nueva (hardware tokens, identificadores, huella del navegador) A / flag
young_account Una cuenta recién creada (solo suma peso) C
scanner_error / too_large Resources que el escáner de scripts no pudo leer, o archivos demasiado grandes que merece la pena revisar info

Lo que ninguna regla promete

Sentinel juzga lo que el servidor puede ver y lo que informa el juego de un jugador. No lee otros programas del PC de un jugador, y ningún anti-cheat puede prometer que se detecte cada cheat. Cada hallazgo viene con sus pruebas, para que tu staff decida con hechos.

14. Comandos y configuración

Todos los comandos están en la página de comandos y todas las claves de config en la página de configuración, ambas generadas a partir del propio resource. Los que más vas a usar:

Comando Qué hace
/sentinel owner <code> reclamar el puesto de dueño en el juego con el código de la consola
/sentinel panel un código de acceso de un solo uso para el panel del navegador (solo staff)
/report <server id> <what happened> cualquier jugador reporta a un jugador o a un miembro del staff
sentinel:health otra vez la caja de arranque
sentinel:diag qué decidió Sentinel y por qué
sentinel:level watch\|recommended\|strict cambiar el nivel de protección y guardarlo
sentinel:wave los baneos en cola para la ban wave
sentinel:appeals las apelaciones abiertas
sentinel:audit los eventos de riesgo de cada resource iniciado
sentinel:guard <resource> la línea que protege un resource
sentinel:advisor los ajustes de FiveM que vale la pena cambiar en tu servidor

Los archivos de config en config/ (config.lua, protection.lua, watch.lua) y las traducciones en config/locales/ están abiertos para ti, igual que los adaptadores de framework en bridge/ y el archivo del guard en guard/. Mantenlos como Lua válido y reinicia zerodev_sentinel después de un cambio. Para el primer arranque no hace falta tocar la config.

15. La caja de arranque y el asesor de refuerzo

Un momento después de que el almacenamiento esté listo, Sentinel imprime una caja en la consola del servidor. Una fila FAIL significa que Sentinel no puede funcionar bien; una fila WARN significa que funciona con menos (por ejemplo, pruebas sin digests). Vuelve a imprimirla cuando quieras con sentinel:health.

Fila Qué comprueba Cuando no está OK
Build La versión y la etiqueta de build de fxmanifest.lua. -
OneSync La convar onesync. Sentinel lee posiciones, entidades y eventos del juego a través de OneSync. pon onesync en on en server.cfg
Copias en marcha Cuántas copias del resource están iniciadas, se llame como se llame su carpeta. Debe ser 1. deja una sola copia de Sentinel; detén la otra carpeta
Almacenamiento Qué almacenamiento se eligió (mysql o kvp) y si está listo. mira sentinel:diag storage
Carpeta de pruebas Una escritura y lectura de prueba en data/archive dentro del resource. crea la carpeta data/archive dentro del resource de Sentinel y asegúrate de que el servidor puede escribir en ella
SHA-256 Si node/util.js responde; saca la huella de cada prueba. las pruebas se guardan sin digests; busca un error de Node en la consola
Protección El nivel de protección, su modo y de dónde viene. -
Reglas Cuántas reglas están en Live y cuántas en Shadow. -

Después de la caja de arranque, el asesor imprime los ajustes de FiveM que vale la pena cambiar en tu servidor (con Config.Advisor.atStartup = false solo los imprime con sentinel:advisor). Para cada ajuste muestra el valor actual, el recomendado, qué bloquea, qué podría romper y la línea para copiar. Solo lee los valores; nunca cambia server.cfg. Prueba una línea en tu servidor antes de dejarla.

16. Idiomas, y qué se registra

Los textos para jugadores y staff vienen de config/locales/<code>.lua, 25 idiomas en esta build. Config.Locale elige el idioma; con Config.GameLanguage = true, un jugador cuyo juego está en un idioma que ofrece GTA lee Sentinel en ese idioma en cuanto entra al juego.

Sentinel guarda en memoria, para cada jugador, aproximadamente los dos últimos minutos de posiciones y eventos (Config.Recorder), y los escribe en un archivo en data/archive/ cuando se abre un caso o el staff usa sentinel:save. Durante una revisión pide al juego del sospechoso clips de pantalla (segmentos de 20 segundos) y los guarda en data/clips/. Guarda los identificadores que FiveM da al servidor (se registra la dirección IP, pero por defecto nunca se usa para rechazar una conexión) y, cuando Discord está activo, el id de Discord. En su primera entrada, cada jugador recibe un aviso corto en su idioma de que el servidor graba la partida y de que el staff puede mirar y escuchar (Config.Notice = false lo desactiva; en ese caso avísales en tus normas). Menciónalo también en tu política de privacidad.

En esta build los archivos y clips antiguos no se borran automáticamente: vacía tú mismo data/archive/ y data/clips/ cuando ya no los necesites.

Con oxmysql, los registros de Sentinel están en las tablas zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report y zds_trail. Sin oxmysql, esos mismos registros viven en el almacén key-value del resource (claves que empiezan por zds:). Los baneos siempre se copian también al almacén key-value, así que siguen aplicándose mientras la base de datos está caída.

17. Actualizar

Las versiones nuevas se publican en el mismo asset de Keymaster. Sentinel guarda sus pruebas dentro de su propia carpeta, así que antes de reemplazarlo:

  1. Haz una copia de seguridad de la carpeta zerodev_sentinel: sus carpetas config/ y data/ (archivos, clips, reportes, baselines aprendidas) y, con oxmysql, de las tablas zds_.
  2. Detén el servidor, reemplaza la carpeta zerodev_sentinel por la nueva (mantén el nombre de la carpeta) y vuelve a poner tu carpeta data/. Pasa los ajustes que cambiaste a los nuevos archivos de config en lugar de copiar los archivos viejos encima.
  3. Arranca el servidor y lee la caja de arranque (sentinel:health).

Antes de actualizar, lee las notas de la nueva versión en el changelog.

18. Desinstalar

  1. Quita la línea del guard de cada resource que protegiste (sentinel:guard los lista) y reinicia esos resources. Hazlo primero: el archivo del guard desaparece en cuanto desaparece la carpeta.
  2. Quita ensure zerodev_sentinel y las líneas sentinel.admin / sentinel.staff de server.cfg, y luego detén el resource. Si sentinel:lockdown cambió el entity lockdown, detener Sentinel vuelve a poner el modo original.
  3. Borra la carpeta zerodev_sentinel. Eso elimina data/ con todos los archivos, clips y reportes, así que copia antes lo que quieras conservar.
  4. Con oxmysql, borra las tablas zds_ de la sección 16 si ya no quieres los baneos ni los casos. Los registros key-value se quedan en el almacén del servidor con el nombre del resource y sin él no hacen nada.

Sentinel solo escribe dentro de su propia carpeta, sus tablas de la base de datos y su almacén key-value. No modifica otros resources ni server.cfg.

Preguntas frecuentes

¿Sentinel banea o expulsa a alguien por su cuenta?

No en Watch ni en Recommended. Empieza en Watch, donde solo registra lo que habría hecho. En Recommended el staff recibe las pruebas y decide. Solo en Strict una puntuación alta pone a un jugador en cuarentena hasta que el staff lo mire, y un hallazgo de nivel prueba pone un baneo en cola para la ban wave.

¿Necesito una base de datos?

No. Con oxmysql, Sentinel guarda sus registros en tu base de datos y crea sus propias tablas en el primer arranque; no hay archivo SQL que importar. Sin él, todo se guarda en el almacén key-value propio del resource.

¿Funciona en QBCore y Qbox?

Sí. La detección, los casos, los clips, la consola, el panel del navegador, Discord y el escritorio del dueño son iguales en todos los frameworks. El rastro de dinero e ítems tiene su propio adaptador para ESX, QBCore, Qbox y ox_inventory.

¿Cómo doy acceso a mis admins?

En el escritorio del dueño, STAFF: elige un jugador conectado, elige un rol y pulsa GRANT. O sigue usando ACE: sentinel.admin da Admin y sentinel.staff da Moderator.

¿Puede apelar un jugador baneado?

Sí. El mensaje de rechazo muestra un código de apelación. El jugador se lo envía a tu staff, que lo registra con sentinel:appeal, o tu web lo envía a la ruta de apelaciones de Sentinel. El staff la acepta o la rechaza en la consola o con sentinel:decide.

¿Puede ver programas de cheats en el PC de un jugador?

No. Sentinel juzga lo que el servidor puede ver y lo que informa el juego de un jugador. No lee otros programas del PC de un jugador.

¿Está listo escuchar el chat de voz?

Necesita pma-voice y el interruptor de escucha (por defecto solo para el dueño), y suena a través de tu propio juego.

¿Qué ven los jugadores?

En su primera entrada, un aviso corto en su idioma de que el servidor graba la partida y de que el staff puede mirar y escuchar (Config.Notice). Para un jugador limpio no cambia nada más.

Traducido del inglés. Si algo de aquí no coincide con la página en inglés, la página en inglés es la correcta. English