# EAS: documentación

> Niveles de alerta de emergencia mostrados a todos los jugadores, por jurisdicción.

- URL: https://xexstudio.com/es/docs/eas
- Versión: 2.0.0
- Ficha del producto: https://xexstudio.com/es/scripts/eas
Niveles de alerta de emergencia por jurisdicción. La policía, el sheriff o EMS fijan el nivel de su zona y todos los
jugadores dentro de ella lo ven en pantalla. ESX, QBCore y Qbox. Cada cambio se valida en el servidor.

## Requisitos

- [ox_lib](https://github.com/overextended/ox_lib)
- Un framework: **ESX**, **QBCore** o **Qbox** (o ninguno: el bridge está abierto)

## Instalación

1. Copia `xex_eas` en tu carpeta de recursos.
2. Añade a `server.cfg` después de tu framework y ox_lib:
   ```cfg
   ensure xex_eas
   ```
3. Configura el idioma con `setr ox:locale en` (o `es`).
4. Opcional, log en Discord de cada cambio (convar solo de servidor, nunca se envía a los jugadores):
   ```cfg
   set xex_eas_webhook "https://discord.com/api/webhooks/..."
   ```
5. Opcional, permite a los administradores cambiar todas las alertas:
   ```cfg
   add_ace group.admin xex_eas.admin allow
   ```

## Uso

| Comando | Qué hace |
| --- | --- |
| `/eas` | Abre el menú con las alertas que tu trabajo puede cambiar |
| `/eas police 3` | Fija una alerta directamente (también desde la consola del servidor) |
| `/toggleeas` | Oculta las alertas marcadas como `hideable` (solo existe si hay al menos una) |
| `/easmove` | Arrastra las alertas a cualquier parte de la pantalla. Se guarda por jugador; *Reset* vuelve a la posición por defecto |

## Configuración

Todo está en `config.lua`:

| Ajuste | Qué hace |
| --- | --- |
| `Config.Framework` | `auto`, o fuerza `esx` / `qb` / `qbox` |
| `Config.Command`, `Config.HideCommand`, `Config.MoveCommand` | Nombres de los comandos. `nil` desactiva ocultar o mover |
| `Config.AdminAce` | Ace que puede cambiar todas las alertas |
| `Config.Cooldown` | Segundos entre dos cambios del mismo jugador |
| `Config.Persist` | Conservar los niveles tras un reinicio (KVP del recurso, sin base de datos) |
| `Config.Notify` | Notificar a los jugadores de esa jurisdicción, o con un trabajo que gestione la alerta, cuando cambia su nivel |
| `Config.UI.theme` | `dark`, `light`, `glass` (translúcido) o `minimal` (HUD sin fondo) |
| `Config.UI.position` | Posición por defecto del HUD: `top-center`, `top-left`, `top-right`, `right`, `bottom-center`, `bottom-right` |
| `Config.UI.scale` | Tamaño del HUD, de 0.7 a 1.5 |
| `Config.UI.accent`, `Config.UI.title` | Color de acento y título del menú |
| `Config.Alerts` | Una entrada por alerta (ver más abajo) |

Cada alerta:

| Campo | Qué hace |
| --- | --- |
| `name` | Id único, usado por `/eas <name> <level>` y los exports |
| `label` | Nombre mostrado en el HUD y en el menú |
| `jobs` | `{ job = minimum grade }` que pueden cambiarla |
| `requireDuty` | Solo los jugadores de servicio pueden cambiarla (QBCore / Qbox, y versiones de ESX con servicio) |
| `visibleTo` | `nil` para todos los jugadores, o una lista de trabajos |
| `hideable` | Los jugadores pueden ocultarla con el comando de ocultar |
| `zones` | Nombres de zona de GTA donde se muestra, o `true` para todo el mapa |
| `default` | Nivel en el primer arranque (y en cada arranque con `Persist = false`) |
| `levels` | Etiqueta, color, descripción y `minGrade` opcional de cada nivel |

## Para desarrolladores

```lua
-- server
local level = exports.xex_eas:GetAlertLevel('police')
exports.xex_eas:SetAlertLevel('police', 3) -- no permission checks: trusted callers only

AddEventHandler('xex_eas:levelChanged', function(name, level, previous, source) end) -- source 0 = console or script

-- client
local level = exports.xex_eas:GetAlertLevel('police')
```

`bridge/server.lua` y `bridge/client.lua` están abiertos: adáptalos para un framework o un sistema de trabajos
personalizado.

## Seguridad

- El servidor comprueba el trabajo, el rango, el servicio y el nivel de cada cambio, y aplica un tiempo de espera por
  jugador.
- Los niveles llegan a los jugadores a través de un state bag global: ningún cliente puede enviar un nivel a los
  demás.
- El webhook de Discord se lee de una convar del servidor, así que nunca llega a los jugadores.

## Rendimiento

El cliente comprueba la zona del jugador una vez por segundo y solo habla con la interfaz cuando cambian las alertas
visibles. Las alertas ocultas y la posición del HUD se guardan por jugador con KVP del cliente: no se envía nada al
servidor.
