# Medical Help: documentación

> Puntos de curación y reanimación para cuando no hay EMS de servicio.

- URL: https://xexstudio.com/es/docs/medical-help
- Versión: 2.0.0
- Ficha del producto: https://xexstudio.com/es/scripts/medical-help
Puntos de curación y reanimación para las horas tranquilas. Cada punto solo se abre mientras el número de EMS de servicio es igual o inferior
a su límite, así que nunca compite con tus jugadores EMS. ESX, QBCore y Qbox.

## Requisitos

- [ox_lib](https://github.com/overextended/ox_lib)
- Un framework: **ESX** (con `esx_ambulancejob`), **QBCore** (con `qb-ambulancejob`) o **Qbox** (con `qbx_medical`)
- OneSync (activado por defecto en cualquier servidor moderno)

## Instalación

1. Copia `xex_medicalhelp` en tu carpeta de recursos.
2. Añade a `server.cfg` después de tu framework, el trabajo de ambulancia y ox_lib:
   ```cfg
   ensure xex_medicalhelp
   ```
3. Idioma: `setr ox:locale en` (o `es`).
4. Log de Discord opcional (nunca lo pongas en `config.lua`, los clientes pueden leer ese archivo):
   ```cfg
   set xex_medicalhelp:webhook "https://discord.com/api/webhooks/..."
   ```

## Cómo funciona

- **Punto de curación:** ponte sobre el marker y pulsa E. Restaura la salud (y elimina las lesiones en QBCore/Qbox).
- **Punto de reanimación:** lleva al jugador caído junto al punto (usa `/carry`) y pulsa E.
- El servidor cuenta los EMS de servicio cada 5 segundos. Un punto está abierto mientras ese recuento es igual o inferior a su `maxEMS`.

## Configuración

Todo está en `config.lua`:

| Ajuste | Qué hace |
| --- | --- |
| `Config.Framework` | `auto`, o fuerza `esx` / `qb` / `qbox` |
| `Config.EMSJobs` | Trabajos que cuentan como EMS |
| `Config.CountOffDuty` | Contar a los EMS que no están de servicio |
| `Config.Account` | Cuenta que se cobra por defecto, o una lista que se prueba en orden |
| `Config.Heal` / `Config.Revive` | Duración del tratamiento, distancia del jugador caído al punto |
| `Config.Cooldown` | Segundos entre dos usos por jugador |
| `Config.Points` | Cada punto: tipo, ubicación, `maxEMS`, precio, cuenta, trabajos/bandas permitidos, NPC, blip, marker |
| `Config.Carry` | Comando `/carry`, distancia y si solo se puede cargar a jugadores caídos |
| `Config.CanUse` | Función opcional del lado del servidor para tus propias reglas de acceso |

## Para desarrolladores

```lua
-- server: every completed heal or revive
AddEventHandler('xex_medicalhelp:used', function(source, kind, pointIndex, target, price) end)

-- server: EMS on duty as counted by this resource
local count = exports.xex_medicalhelp:GetEMSCount()
```

`bridge/server.lua` es abierto: adáptalo si usas un framework, trabajo de ambulancia o sistema de muerte personalizado.

## Seguridad

- El cliente nunca decide nada: el servidor comprueba el acceso, el recuento de EMS, la distancia, el estado del paciente y
  el tiempo que ha tardado el tratamiento, y cobra el precio de la configuración.
- Las parejas de carga se mantienen en el servidor con una animación fija; nadie puede enganchar jugadores a distancia.

## Actualización desde 1.x

`config.lua` ha cambiado. Copia tus puntos al nuevo formato (`HRPoints` → `Points`, `pointType` → `type`,
`location` → `coords`, `cost` → `price`, `whitelistedJobs` → `groups`, `NPCPed`/`NPCPedPosition` → `npc`).
Mueve el webhook a `server.cfg`.
