Instalación

Instalación del anticheat — paso a paso

Esta guía te lleva de cero a una configuración funcional. También explica por qué importa cada paso, para que sepas dónde mirar si algo falla.

Antes de empezar — requisitos

1. Descargar el paquete

Cuando tu suscripción esté activa: Panel → Servidores → tu servidor → «Descargar anticheat»

O directamente con tu clave de licencia:

curl -H "X-License-Key: YOUR_LICENSE_KEY" \
     -o tosun-ac.zip \
     https://admin.tosundev.com/api/ac_package_download.php

2. Extraer en tu carpeta resources

resources/
└── [tosun]/
    ├── tosun-ac/
    └── tosun-ac-guardian/

Ambas carpetas deben estar al mismo nivel. Guardian es un recurso independiente — en un momento verás por qué.

3. Importar el esquema de base de datos

Solo en la primera instalación:

mysql -u USER -p DATABASE < tosun-ac/sql/ts_anticheat.sql

Como alternativa, pon ts.autoSQL = true en configs/anticheat_config.lua, arranca el servidor una vez y vuelve a dejarlo en false.

ℹ️ En las actualizaciones, las diferencias de esquema se aplican automáticamente (ADD COLUMN IF NOT EXISTS) — nada manual.

4. server.cfg — el orden importa

ensure oxmysql
ensure tosun-ac
ensure tosun-ac-guardian

5. Conectar el panel

En configs/anticheat_config.lua:

ts.webPanelURL = "https://admin.tosundev.com"
ts.webPanelKey = "YOUR_API_KEY"

Obtén la clave API en Panel → Servidores → tu servidor → Clave API.

Puedes dejar ambos vacíos — el anticheat los toma de la tabla panel_settings al arrancar. Si lo configuraste desde el panel, ya están ahí.

6. Arrancar y verificar

Reinicia el servidor. Deberías ver:

[Tosun AC v9.0] NetEventGuard aktif
[AC-Guardian] Aktif — tosun-ac harici gözetmen koruması altında.

Después, dentro del juego:

/ts status     → estado de los módulos
/ts test       → autodiagnóstico

Panel → AC → Live debería mostrar tu servidor en línea en menos de 30 segundos.

7. Endurecer la plataforma — el paso de mayor valor

# Los clientes no pueden crear entidades en red (vehículos/peds/objetos)
set sv_entityLockdown "relaxed"

# Solo el servidor puede escribir state bags
set sv_stateBagStrictMode "true"

# Secuestro del control de entidades (lanzar vehículos, lanzar jugadores)
set sv_filterRequestControl "2"

# Eventos en red susceptibles de abuso
set sv_enableNetworkedSounds "false"
set sv_enableNetworkedPhoneExplosions "false"
set sv_enableNetworkedScriptEntityStates "false"

# Clientes con ScriptHookV
set sv_scriptHookAllowed "false"

# Archivos de cliente modificados (usados para silent aim)
set sv_pureLevel "1"

El anticheat audita estos valores al arrancar y enumera los que falten. Para que los seguros se apliquen automáticamente:

ts.hardening.autoApply = true

8. Conceder acceso de administrador

Cualquiera de estas opciones funciona; gana la primera coincidencia:

# 1) server.cfg — ACE
add_ace group.admin tosun.admin allow
add_principal identifier.license:YOUR_LICENSE group.admin

# 2) txAdmin — se reconoce automáticamente (ts.txAdminAuth = true)

# 3) admins/anticheat_admins.lua
Admins = { "license:xxxxxxxxxxxxxxxxxxxxxxxx" }

# 4) Panel → AC → Admin Grants

Abre el menú con /tsmenu, /ts menu o F7.

Lista de verificación de instalación

• ☐ La consola muestra NetEventGuard aktif
• ☐ La consola muestra [AC-Guardian] Aktif
• ☐ Ningún bloque rojo GUVENLIK UYARISI (o has omitido deliberadamente las convars listadas)
• ☐ El servidor aparece en línea en el panel
• ☐ /tsmenu se abre para un administrador
• ☐ /tsmenu no hace nada para un jugador normal

Problemas frecuentes

Actualizar

1. Descarga el nuevo paquete desde el panel (misma URL — siempre sirve la última build para tu licencia)
2. Haz copia de tus carpetas configs/, admins/ y editable/
3. Sustituye la carpeta del recurso
4. Restaura tus archivos de configuración — nunca se ofuscan precisamente para que puedas seguir editándolos
5. Reinicia

Al pedir soporte, incluye tu Build ID (en server/core/anticheat_000_license.lua) — identifica tu build exacta.