01Instalación
- Coloca el recurso en tu carpeta
resources/y asegúrate de que inicie antes de los scripts de tu framework que crean vehículos/objetos — valida las entidades en el momento en que se crean, así que tiene que estar corriendo antes de que existan. - Edita los archivos dentro de
config/:shared_flags.lua— flags de funcionalidad (sección 3).shared_func.lua— funciones puente con el framework (sección 2).shared_commands.lua— comandos y permisos (sección 8).shared_weapons.lua— mapa hash → nombre visible usado por el wall y por los logs.sv_detections.lua— comportamiento por detección (sección 4).sv_webhooks.lua— webhooks de Discord.sv_report_handler.lua— filtro de reportes, notificación a admins y función de baneo.
- Inicia el recurso y confirma que la consola imprime
(likizao_ac) -> Carregado com sucesso!.
Un servidor por licencia. Una licencia no se puede compartir entre varios servidores — solo se permite un servidor activo por licencia. Si necesitas un segundo servidor (uno de pruebas o desarrollo, por ejemplo), necesita su propia licencia.
02Funciones del frameworkconfig/shared_func.lua
El anticheat nunca habla directamente con tu framework — solo llama a las funciones de abajo. Complétalas con lo que use tu framework. El archivo por defecto viene escrito para vRP.
getUserIdConfig.Functions.getUserId(source)
Devuelve un ID único y estable por cuenta, derivado del source del jugador.
- vRP:
vRP.getUserId(source) - ESX:
ESX.GetPlayerFromId(source).identifier - QBCore:
QBCore.Functions.GetPlayer(source).PlayerData.citizenid - Sin ningún sistema de cuentas: simplemente
return source— funciona bien, el valor solo se usa para logs, llamadas de baneo y la etiqueta del wall.
Debe devolver nil cuando el jugador todavía no ha cargado; el anticheat maneja ese caso y
registra el reporte usando los identificadores en bruto.
Config.Functions.getUserId = function(source)
return vRP.getUserId(source)
endgetUserSourceConfig.Functions.getUserSource(user_id)
Lo inverso de getUserId: dado el ID, devuelve el source actual, o nil si está offline.
Se usa para notificar a los admins conectados.
hasPermissionConfig.Functions.hasPermission(user_id, permission)
Devuelve true/false. permission es la cadena que definas en shared_commands.lua
(player.wall, player.propmanager, player.cleanarea).
getUsersByPermissionConfig.Functions.getUsersByPermission(permission)
Devuelve una lista de user_id que tienen el permiso. La usa Config.NotifyAdmins para saber
quién debe recibir las alertas de detección (consulta player.noclip por defecto).
getIdentityConfig.Functions.getIdentity(user_id)
Devuelve la identidad del personaje para el wall. Se acepta cualquiera de estos formatos:
{ name, firstname }, { name, name2 } o { nome, sobrenome }. Devolver nil hace que el
wall muestre SEM NOME.
getUserGroupByTypeConfig.Functions.getUserGroupByType(user_id, 'job')
Devuelve el nombre del trabajo del jugador (cadena) para la etiqueta del wall, o nil/false.
NotifyConfig.Functions.Notify(src, type, message)
Tu sistema de notificaciones. type es uno de sucesso, negado, importante. Mapea esos
valores a los tipos de tu propio sistema en la tabla VALID_TYPES justo encima de la función.
LabelsConfig.Labels
Textos de los mensajes del wall y de permisos. Tradúcelos libremente.
03Flagsconfig/shared_flags.lua
Las flags son solo cadenas en Config.Flags. Todo lo que no esté listado ahí queda desactivado.
Config.Flags = {
'--heartbeat-v2',
'--enable-custom-object',
'--enable-vehicle-check',
}| Flag | Efecto |
|---|---|
--enable-custom-object |
Activa la protección de objetos y peds. Los objetos tienen que estar autorizados (sección 7) y los peds que no son jugadores quedan bloqueados. Sin ella, no se valida ningún objeto ni ped. |
--enable-vehicle-check |
Activa la validación de spawn de vehículos: un vehículo creado por un jugador tiene que autorizarse antes (sección 6). Los vehículos creados en el servidor se aceptan automáticamente. |
--enable-sv.vehicle-spawn |
Para servidores que crean vehículos solo en el lado servidor: cada vehículo nuevo tiene que confirmarse como legítimo en lugar de confiarse, así que los spawns del cliente no se mantienen. |
--enable-explosions |
Permite explosiones y proyectiles a los jugadores que tengan un arma autorizada. Sin ella, las explosiones y proyectiles se bloquean en todo el servidor. |
--disable-player-constraints |
Relaja las reglas de bucket para las comprobaciones de armas y activa el vigilante de noclip. Úsala en servidores que dependen mucho de los routing buckets. |
--disable-weapon-handler |
Apaga el módulo de armas por completo. Solo para depurar. |
--disable-unarmed-damage |
Omite la validación de daño desarmado. Útil con daño cuerpo a cuerpo personalizado. |
--disable-attachment-check |
Desactiva la comprobación de objetos adjuntos a la entidad de otro jugador. Puede producir falsos positivos por discrepancia de dueño, ya que las entidades creadas en el servidor no tienen dueño en el cliente y acaban parecidas a las de otra persona. |
--disable-citizen-check |
Lado cliente: desactiva las comprobaciones de integridad del cliente. |
--disable-scenario-check |
Desactiva la comprobación de spam de escenario. |
--anticl2 |
Una sesión por licencia: si la misma licencia entra dos veces, ambas sesiones se desconectan. |
--set-population |
Para servidores que usan población ambiental (tráfico de IA, peatones, NPCs de escenario). |
--heartbeat-v2 |
Heartbeat mejorado. Recomendada — manténla activa por defecto. |
--canary |
Nuevo manejo de spawns de vehículos hechos en el servidor. Actívala si tienes problemas con vehículos creados en el servidor. |
04Deteccionesconfig/sv_detections.lua
Config.Detections = {
['Weapon Spawn 12'] = true, -- baneo inmediato
['Weapon Spawn 10'] = 2, -- baneo tras 2 detecciones
['Spawn de Objeto'] = false, -- solo log
}true→ baneo en la primera detección.number→ baneo tras esa cantidad de detecciones (el contador se reinicia cada 50 segundos).falseo ausente → solo se registra en el webhooksuspicious, sin ninguna acción.
Los baneos se pueden apagar globalmente con la convar set likizao_enable_ban 0 (por defecto 1).
Claves opcionales extra que puedes añadir a la config:
| Clave | Propósito |
|---|---|
Config.DefaultBucket |
El bucket en el que normalmente están tus jugadores. Cuando vale 0, cualquier bucket mayor que 0 desactiva la comprobación de armas para ese jugador. Cuando vale otra cosa (o se deja sin definir), el umbral es 1000000 (ver sección 5). |
Config.ObjectsWhitelist |
Whitelist extra de objetos que se fusiona con el módulo de objetos al iniciar, con el mismo formato de la sección 7 ([modelo] = cantidad, modelo como hash o cadena). |
Config.Locales |
[nombre_de_deteccion] = "nombre traducido", aplicado al texto del log/notificación. |
Config.SendLog(type, user_id, src, reason, additionalData) |
Defínela para hacerte cargo del logging por completo; el embed de Discord incorporado se omite. type es 'suspicious' o 'banned'. |
ReportHandlerConfig.ReportHandler(src, reason, additionalData)
Se llama antes que nada en cada reporte. Devuelve false para descartar el reporte (sin
log, sin conteo, sin baneo). Úsala para bypass de staff, whitelist de eventos, etc.
NotifyAdminsConfig.NotifyAdmins(user_id, src, report_type, report_reason)
Se llama después del log. report_type es 'suspicious' o 'banned'.
BanUserConfig.BanUser(user_id, src, identifiers)
Tu implementación de baneo. identifiers es la tabla en bruto de GetPlayerIdentifiers(src).
El jugador es desconectado con Config.DisconnectMessage justo después de esta llamada.
05Armas
Dar un arma vs. solo autorizarla
Son dos cosas distintas que puedes hacer, y esta es la fuente de confusión más común:
exports.likizao_ac:giveWeapons(src, weapons) — da el arma Y la autoriza.
exports.likizao_ac:giveWeapons(source, {
['WEAPON_PISTOL'] = 250, -- solo munición
['WEAPON_CARBINERIFLE'] = { ammo = 120, isHidden = false, bForceInHand = true },
})El ped recibe realmente el arma (GiveWeaponToPed) y queda registrada como autorizada.
Las claves aceptan nombre de arma o hash; el valor es la cantidad de munición o una tabla.
TriggerEvent('likizao_ac:setWeapons', src, weapons) — solo autoriza, no da nada.
TriggerEvent('likizao_ac:setWeapons', source, {
['WEAPON_PISTOL'] = true,
['WEAPON_CARBINERIFLE'] = true,
})Esto reemplaza la lista de armas autorizadas del jugador sin tocar el ped. Úsalo cuando tu inventario ya entrega el arma en el cliente y solo necesitas que el anticheat deje de reportarla. Para añadir un arma sin borrar la lista, usa:
TriggerEvent('likizao_ac:setPlayerWeapon', source, 'WEAPON_PISTOL', 250)Otros exports de armas:
| Export | Descripción |
|---|---|
exports.likizao_ac:removeWeapons(src) |
Quita todas las armas del ped (RemoveAllPedWeapons). |
exports.likizao_ac:addAmmo(src, _, weapon, newValue) |
Define la munición de esa arma. El segundo argumento se ignora (se mantiene por compatibilidad). |
exports.likizao_ac:SetWeaponsAlias(aliasTable) |
Reemplaza la tabla de alias usada para mapear hashes de armas personalizadas/skin a su arma base: [hash] = "WEAPON_BASE" o [hash] = { "WEAPON_A", "WEAPON_B" }. Los alias de los recursos skins y skin-weapon se cargan automáticamente cuando esos recursos existen. |
Routing buckets y la comprobación de armas
La validación de daño de arma se omite según el routing bucket de quien dispara:
- Si
Config.DefaultBucket == 0: cualquier bucket > 0 omite la comprobación. - Si no: cualquier bucket > 1000000 omite la comprobación. Esta es la forma recomendada de montar minijuegos, arenas, campos de tiro o cualquier evento personalizado — pon a los jugadores en un bucket por encima de 1000000 y la protección de armas se ignora para ellos.
06Eventos para autorizar acciones
Todos estos son TriggerEvent del lado servidor (no son net events, así que un cheater no
puede dispararlos desde el cliente).
Vehículos
-- Autoriza un modelo para un jugador, opcionalmente restringido a una posición
TriggerEvent('likizao_ac:onVehicleSpawn', { src = source, name = 'adder', position = coords })
TriggerEvent('likizao_ac:onSpawnVehicle', { src = source, name = 'adder' })
-- Autoriza coordenadas: cualquier vehículo creado a menos de 30m de estos puntos se acepta
TriggerEvent('likizao_ac:setCoordsBypass', { vec3(x, y, z), vec3(x2, y2, z2) })exports.likizao_ac:setSpawnClient(src, model) hace lo mismo que onSpawnVehicle y además
preautoriza el modelo de objeto correspondiente.
Spawns en el servidor. Los vehículos creados con CreateVehicle en el servidor no tienen
dueño en el cliente, así que con --enable-vehicle-check se aceptan sin necesidad de
anunciarlos — los eventos de arriba solo hacen falta para vehículos que crea el cliente. Si
los vehículos creados en el servidor llegan a eliminarse o reportarse (por ejemplo cuando
--set-population también está activa), enciende --canary, que gestiona esos spawns por ti.
Peds
-- Permite que un jugador cree un modelo de ped durante `ttl` segundos (por defecto 30)
TriggerEvent('likizao_ac:allowPedModel', source, 'a_m_y_business_01', 30)
TriggerEvent('likizao_ac:allowPedModel', source, { 'model_a', 'model_b' }, 60)
TriggerEvent('likizao_ac:allowPedModel', source, '*', 15) -- cualquier modelo de pedForzar un reporte desde tus propios scripts
TriggerEvent('AC:ForceBan', source, {
reason = 'Mi detección personalizada',
additionalData = 'información extra',
forceBan = true,
})El anticheat también emite AC:Suspect con { reason, user_id } cada vez que ocurre un
reporte que no genera baneo, y likizao:PropManager:DeleteEntitys (user_id, entidades,
isMassDelete) cuando un admin elimina entidades — engánchate a esos eventos para tu propio log.
07Autorizar objetos en la config
El control de objetos solo funciona con --enable-custom-object activa. La whitelist se puede
extender desde la config con Config.ObjectsWhitelist o en tiempo de ejecución con los exports
de abajo.
Config.ObjectsWhitelist = {
['prop_cs_phone_01'] = 1,
[GetHashKey('prop_beer_box_01')] = 1,
['cdev_pets_bowl1_a'] = 999,
}El número es la cantidad máxima de ese objeto que un solo jugador puede tener al mismo tiempo.
= 1→ el jugador puede tener solo uno de ese objeto a la vez. Un segundo creado se trata como abuso por duplicación.> 1(p. ej.2,10,999) → se permiten varias instancias al mismo tiempo, no se hace ninguna comprobación de duplicados. Úsalo para props como camas de mascota, conos, luces o cualquier cosa que un jugador coloque legítimamente más de una vez.
El valor 0 o una entrada ausente significa que el objeto no está autorizado: se cancela y
el jugador es reportado con Spawn de Objeto.
Exports en tiempo de ejecución:
| Export | Descripción |
|---|---|
exports.likizao_ac:RegisterModel(model, amount) |
Autoriza un modelo. model acepta hash o nombre. Misma regla de 1 vs. > 1. |
exports.likizao_ac:RegisterModels({ [model] = amount, ... }) |
Autoriza varios modelos de una vez. |
exports.likizao_ac:IsObjectAllowed(owner, model, coords) |
Devuelve true/false usando las mismas reglas (whitelist + 30m + comprobación de duplicados). |
exports.likizao_ac:SetBypass(src, 'entities') |
El jugador queda totalmente ignorado por el módulo de objetos/peds. Pasa nil para quitarlo. |
exports.likizao_ac:setUserBypass(src, true) |
Bypass global: todo reporte de ese jugador se descarta. Pasa false para quitarlo. |
exports.likizao_ac:DisableBan() |
Desactiva el baneo dentro del módulo de entidades (solo logs). |
08Otros exports
| Export | Descripción |
|---|---|
exports.likizao_ac:setValidation(detection_name, callback) |
Registra una validación extra para una detección (sección 8.1). |
exports.likizao_ac:removeValidation(detection_name) |
Quita la validación. Devuelve false si no había ninguna registrada. |
exports.likizao_ac:getValidations() |
Devuelve la tabla de validaciones registradas actualmente. |
exports.likizao_ac:registerReportOverride(detection_name, callback) |
Reescribe o descarta un reporte antes de que se procese (sección 8.2). |
exports.likizao_ac:overrideConfig({ ['Detection'] = value }) |
Cambia entradas de Config.Detections en tiempo de ejecución (sección 8.3). |
exports.likizao_ac:Report(src, reason, forceBan, additionalData) |
Reporta a un jugador (un reporte por motivo por ciclo). |
exports.likizao_ac:ReportAfterCount(src, reason, maxCount, ban, additionalData) |
Reporta solo tras maxCount ocurrencias. |
Dónde corre cada hook
Cada reporte pasa por este pipeline, en este orden:
Config.ReportHandler(src, reason, additionalData)— devuelvefalsepara descartarlo.- Callback de
setValidationde esa detección — devuelvetruepara descartarlo. - Callback de
registerReportOverridede esa detección — devuelvefalsepara descartarlo, o una tabla para reescribir el reporte. Config.Detections[reason](o lo queoverrideConfighaya definido por último) decide entre log y baneo.
8.1setValidation
Registra una comprobación por detección que decide, en el momento del reporte, si ese jugador
debe ignorarse. Devolver true significa "esto es legítimo, descarta el reporte".
El callback debe pasarse entre recursos (una referencia de función de CFX), así que llama a este export desde otro recurso, no desde dentro de
likizao_ac. Las validaciones se eliminan automáticamente cuando el recurso que las registró se detiene.
-- Llamado como callback(src, ...) donde los argumentos extra dependen de la detección.
exports.likizao_ac:setValidation('Weapon Spawn', function(src, weaponHash)
-- Se pasa 'EXPLOSION' en lugar de un hash cuando la comprobación viene de un
-- evento de explosión/proyectil (solo con --enable-explosions).
if weaponHash == 'EXPLOSION' then
return isPlayerInEventZone(src)
end
-- Si no, weaponHash es el hash con signo del arma, ya resuelto por la tabla de alias.
return myInventory.hasWeapon(src, weaponHash)
end)Funciona cualquier nombre de detección, no solo Weapon Spawn; para todas las demás
detecciones el callback recibe únicamente el source:
exports.likizao_ac:setValidation('Spawn de Objeto', function(src)
return isStaffOnDuty(src)
end)
exports.likizao_ac:removeValidation('Spawn de Objeto')Solo puede existir una validación por detección — registrar una segunda sobrescribe la primera e imprime un aviso en la consola.
8.2registerReportOverride
Corre después de la validación y te deja cambiar el reporte en lugar de solo aceptarlo o
rechazarlo. El callback recibe (src, report), donde report es
{ reason, additionalData, forceBan }, y debe devolver:
false(onil) → el reporte se descarta;- una tabla → sus campos se fusionan con el reporte antes de registrarlo/banear.
exports.likizao_ac:registerReportOverride('TASK_SPAM', function(src, report)
local task = GetPedScriptTaskCommand(GetPlayerPed(src))
if task == -129606530 then
return false -- ¿ignorarlo?
end
if task == -874453556 then
return { -- misma detección, otro nombre en los logs
reason = 'Crashar Players (02)',
additionalData = '',
}
end
return { additionalData = 'Task: ' .. task } -- mantiene el reporte, solo enriquece el log
end)Devolver { forceBan = true } promueve ese reporte concreto a baneo inmediato, sin importar lo
que diga Config.Detections.
8.3overrideConfig
Cambia Config.Detections en tiempo de ejecución, con la misma semántica del archivo de config
(true = baneo inmediato, número = baneo tras N detecciones, false = solo log). Útil para
suavizar detecciones durante un evento y restaurarlas después.
exports.likizao_ac:overrideConfig({
['Weapon Spawn'] = false, -- solo log
['Spawn de Objeto'] = 3, -- baneo tras 3 detecciones
['Super Soco (1)'] = true, -- baneo inmediato
})Cada cambio se imprime en la consola del servidor.
8.4Reportes personalizados desde tu propio recurso
exports.likizao_ac:Report(src, 'Minha Detecção', false, 'información extra')
exports.likizao_ac:ReportAfterCount(src, 'Minha Detecção', 3, true, 'información extra')Report se dispara solo una vez por src+reason por ciclo. ReportAfterCount solo reporta
tras maxCount ocurrencias, y ban decide si ese reporte final banea al jugador.
09Comandos
Comandos de jugador/staffconfig/shared_commands.lua
Config.Wall = { command = 'wall', permission = 'player.wall', outline = true, opacity = 246 }
Config.PropManager = { command = 'propmanager', permission = 'player.propmanager' }
Config.CleanArea = { command = 'cleanarea', permission = 'player.cleanarea' }| Comando | Permiso | Descripción |
|---|---|---|
/wall |
player.wall |
Activa/desactiva el wall de ESP (nombres, trabajos, etiquetas de admin/novato, contadores de detección). |
/propmanager |
player.propmanager |
Abre la UI del prop manager para inspeccionar y eliminar entidades en red y sus dueños. |
/cleanarea |
player.cleanarea |
Elimina peds y objetos en un radio de 60m. Pasando cualquier argumento (p. ej. /cleanarea veh) también elimina vehículos en un radio de 40m. |
/wallconfig |
— (cliente, solo afecta al wall de quien lo llama) | linhas, nome, source, logs, killer, distancia <n>. Los ajustes se guardan por cliente. |
Definir Config.Wall, Config.PropManager o Config.CleanArea como nil desactiva ese módulo
por completo.
Comandos de la consola del servidor
| Comando | Descripción |
|---|---|
likizao_toggle_veh_check |
Alterna el módulo de comprobación de vehículos entre los comportamientos v1 y v2. |
likizao_ac_debug_vehicle |
Activa/desactiva el log detallado del módulo de vehículos en el servidor. |
likizao_block_object <hash> |
Bloquea un hash de modelo al instante y elimina todas las instancias existentes de él. |
Convars
| Convar | Por defecto | Descripción |
|---|---|---|
likizao_enable_ban |
1 |
Ponla en 0 para registrar detecciones sin banear nunca. |
10Primera configuración recomendada
- Elige tus flags con "¿Qué flags necesita mi servidor?" más abajo, y deja
Config.Detectionsvacío (solo la línea de comentario obligatoria). Cualquier detección que no esté listada ahí es solo log, así que nadie es baneado mientras todavía estás ajustando. - Completa
Config.Functionsy confirma que/wallmuestra los nombres correctos — eso prueba quegetUserId,getIdentityyhasPermissionestán bien conectados. - Activa un módulo a la vez (
--enable-custom-object, después--enable-vehicle-check), vigilando el webhooksuspiciousen busca de falsos positivos. - Autoriza tus propios scripts con los eventos de la sección 6 y la whitelist de objetos de la sección 7 hasta que los logs queden limpios.
- Solo entonces cambia las detecciones en las que confías a
trueo a un umbral numérico.
¿Qué flags necesita mi servidor?
Responde estas cuatro preguntas y ya tienes tu Config.Flags.
Empieza por --heartbeat-v2, recomendada en todos los servidores, y luego responde el resto.
¿Usas población ambiental (tráfico de IA, peatones, NPCs de escenario)?
Añade --set-population. Sin ella todo ped que no sea jugador se cancela, así que un servidor
con vida ambiental se verá completamente vacío. Si tu servidor no tiene ninguna población de IA
(peds y tráfico desactivados), déjala fuera — la protección es más estricta así.
¿Quién crea tus vehículos?
- Cliente y servidor mezclados (garajes, menús de admin, trabajos del lado cliente): usa
--enable-vehicle-check. Los spawns del cliente deben anunciarse con los eventos de la sección 6, y los del servidor se aceptan automáticamente, así que esa flag sola cubre ambos casos. - Solo en el servidor (cada vehículo viene de
CreateVehicleen el servidor): usa--enable-sv.vehicle-spawn, que confirma cada vehículo en lugar de confiarse. No la uses si alguna parte de tu servidor todavía crea vehículos desde el cliente.
En cualquier caso, enciende --canary si tienes problemas con vehículos creados en el servidor.
¿Los jugadores colocan props (objetos de inventario, mascotas, cañas de pescar, carteles, objetos de trabajo)?
Añade --enable-custom-object y autoriza esos modelos como se describe en la sección 7. Esta es
la flag que va junto con la de vehículos en casi todos los servidores.
¿Usas routing buckets mucho (instancias, casas, minijuegos)?
Añade --disable-player-constraints para que las comprobaciones de armas dejen de pelear con
tus buckets, y recuerda que cualquier bucket por encima de 1000000 ignora la protección de armas
por completo (sección 5).
Un servidor de roleplay típico con población ambiental, vehículos en cliente y servidor, y props termina con:
Config.Flags = {
'--heartbeat-v2',
'--set-population',
'--enable-vehicle-check',
'--enable-custom-object',
}