# Street Races

> Contrarrelojes en tantos circuitos como quieras, con clasificaciones y avisos de récord a todo el servidor.

- URL: https://xexstudio.com/es/scripts/street-races
- Nombre del recurso: `xex_races`
- Categoría: Gameplay
- Precio: Gratis
- Frameworks: ESX, QBCore, Qbox
- Código: Código abierto (sin escrow)
- Repositorio: https://github.com/JGCdev/xex_races
- Versión: 1.0.0
- resmon medido: 0,00 ms en reposo · 0,01 ms con el menú abierto
- Requiere: ox_lib, oxmysql, OneSync
- Entrega: inmediata, a través del Keymaster de Cfx.re
- Documentación: https://xexstudio.com/es/docs/street-races
- Vídeo: https://www.youtube.com/watch?v=mIdxvVwSfSQ

## Puntos clave
- Cuatro circuitos listos para correr y sin límite para añadir los tuyos, cada uno con sus propios vehículos
- Top 10 por circuito, mejores marcas personales y un aviso a todo el servidor cuando cae un récord (se puede activar o desactivar)
- El servidor genera el vehículo, lleva el cronómetro y comprueba cada checkpoint

Acércate al mostrador de carreras, elige un circuito y un vehículo, y corre contra el reloj por los checkpoints. Tu mejor tiempo entra en la clasificación del circuito, y batir un récord puede avisar a todo el servidor. Cuatro circuitos vienen listos; añade tantos como quieras.

El servidor ejecuta cada carrera: genera el vehículo, arranca y para el cronómetro y comprueba cada checkpoint contra la posición real del vehículo. Un cliente modificado no puede enviar un tiempo que no ha conducido. Gratis y de código abierto bajo licencia MIT.

## Características
- Mostrador de carreras con un NPC y ox_target o qb-target, o un marcador y [E] sin recurso de target
- Circuitos ilimitados: cuatro incluidos, desde una vuelta por la ciudad hasta un recorrido off-road por el desierto, y tantos más como añadas
- Cuenta atrás 3-2-1-GO, cronómetro en directo con el contador de checkpoints y ruta GPS al siguiente checkpoint
- Pantalla final con tu tiempo, tu mejor marca personal y el récord del circuito
- Clasificación por circuito con nombres de personaje y el número de récords que tiene cada jugador
- Aviso a todo el servidor cuando se bate un récord de circuito, desactivable en la config
- Modo fantasma durante las carreras, para que los corredores no choquen con otros jugadores
- Dinero opcional por un récord, una mejor marca personal o por terminar, con cooldown y límite por hora (desactivado por defecto)
- Checkpoints comprobados en el servidor en orden, por posición y por velocidad plausible; una sola llegada por carrera
- El vehículo de carrera se elimina al terminar, cancelar, morir, destrozarlo, bajarse o desconectarse
- /racetool imprime nuevos checkpoints y líneas de salida listos para pegar en el archivo de circuitos
- Hooks y eventos para battle passes, analíticas o restricciones por trabajo
- Inglés y español

## Historial de cambios
### 1.0.0
- Primera versión pública, probada con jugadores reales antes de publicarla
- Cuatro circuitos, cuenta atrás, cronómetro en directo y pantalla final
- Clasificaciones por circuito y avisos de récord opcionales a todo el servidor
- Cronometraje y comprobación de checkpoints en el servidor
- Recompensas, hooks y eventos opcionales
- ESX, QBCore y Qbox, inglés y español

## Preguntas frecuentes
### ¿Puedo cambiar el código?
Sí. Es código abierto bajo licencia MIT, el recurso completo, sin escrow. El código está en GitHub en github.com/JGCdev/xex_races.
### ¿Cuántos circuitos puedo tener?
Tantos como quieras. Cuatro vienen listos para correr, y cada circuito que añadas tiene su propia clasificación.
### ¿Puedo añadir mis propios circuitos?
Sí. Recorre la ruta con /racetool para imprimir cada checkpoint y la línea de salida, pégalos en data/tracks.lua y elige los vehículos del circuito.
### ¿Pueden los jugadores competir entre sí o usar su propio vehículo?
No en esta versión. Cada carrera es una contrarreloj en un vehículo generado por el servidor, para que el tiempo se pueda comprobar.
### ¿Paga a los jugadores?
Solo si lo activas. Las recompensas están desactivadas por defecto; al activarlas, pagan por un récord, una mejor marca personal o por terminar, con cooldown y límite por hora.
### ¿Puedo desactivar los avisos de récord?
Sí. Pon Config.Leaderboard.announceRecords en false y solo el corredor verá el nuevo récord.
### ¿Necesita un recurso de target?
No. Usa ox_target o qb-target si hay uno en marcha y un marcador con [E] si no.
