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.
1. Requisitos
- OneSync activado (
set onesync onen 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 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
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.adminpropio de ESX funciona como grupo ACE cuando añades la línea para él.
QBCore
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
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)
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:
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:
- Watch durante unos días de juego normal.
- 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) ysentinel:diag decisions 100. - Fija en Shadow cualquier regla que haya marcado a alguien de confianza, y cuéntanoslo.
- Cambia a Recommended. Ahora el staff ve casos y pruebas; nadie es castigado automáticamente.
- 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:
- 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>. - 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, ponset sentinel_http_proxy truepara 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.
sentinel:auditlista 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.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' }
- Reinicia ese resource.
sentinel:guard <resource>ahora dice "guarded since ...".sentinel:guardsolo lista todos los resources protegidos. - 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:
- Haz una copia de seguridad de la carpeta
zerodev_sentinel: sus carpetasconfig/ydata/(archivos, clips, reportes, baselines aprendidas) y, con oxmysql, de las tablaszds_. - Detén el servidor, reemplaza la carpeta
zerodev_sentinelpor la nueva (mantén el nombre de la carpeta) y vuelve a poner tu carpetadata/. Pasa los ajustes que cambiaste a los nuevos archivos de config en lugar de copiar los archivos viejos encima. - 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
- Quita la línea del guard de cada resource que protegiste (
sentinel:guardlos lista) y reinicia esos resources. Hazlo primero: el archivo del guard desaparece en cuanto desaparece la carpeta. - Quita
ensure zerodev_sentinely las líneassentinel.admin/sentinel.staffde server.cfg, y luego detén el resource. Sisentinel:lockdowncambió el entity lockdown, detener Sentinel vuelve a poner el modo original. - Borra la carpeta
zerodev_sentinel. Eso eliminadata/con todos los archivos, clips y reportes, así que copia antes lo que quieras conservar. - 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.