Documentación de Drag Racing 1/4 milla con árbol de luces

OV Drag Racing — Documentación

Versión: 1.0.0 Categoría: Entretenimiento Compatibilidad: QBX · QB-Core · ESX · Standalone Idiomas: Español · English · Português

---

Instalación

Copia ov_drag a tu carpeta resources/[otravida]/.
Agrega ensure ov_drag a tu server.cfg (asegúrate de que oxmysql ya esté ensureado antes).
Arranca el servidor. Las tablas ov_drag_pistas y ov_drag_records se crean automáticamente.
Entra al juego y usa /dragcreator (con permisos de admin) para colocar tu primera pista.

Dependencias

Recurso	Obligatorio
oxmysql	✓
qbx_core / qb-core / es_extended	Solo para dinero y permisos de grupo

Si usas standalone, los permisos de admin se verifican por ACE (ov_drag.admin) y las apuestas se desactivan.

---

Configuración rápida (config.lua)

Config.Idioma        = 'es'          -- 'es' | 'en' | 'pt'
Config.GruposAdmin   = { 'admin', 'superadmin', 'god' }
Config.ApuestaActiva = true
Config.ApuestaMin    = 500
Config.ApuestaMax    = 50000

-- Tiempos del árbol en milisegundos
Config.Arbol = {
    PreStage = 1200,
    Stage    = 1000,
    Y1 = 500, Y2 = 500, Y3 = 500,  -- tres amarillas
}

---

Crear una pista

Escribe /dragcreator en el chat (necesitas ser admin).
Apunta con la cámara al suelo y presiona ENTER para confirmar cada slot en orden:
Árbol — el árbol de salida (colócalo en el centro de la pista)
SensorIzq / SensorDer — un poste sensor a cada lado de la meta
Tablero — el marcador con pantalla DUI
MetaIzq / MetaDer — parado en el punto de meta de cada carril
Usa G para volver a un slot anterior si necesitas corregirlo.
Escribe /dragguardar NombreDeLaPista para guardar.

Los carriles de salida se calculan automáticamente a partir de la posición del árbol.

---

Árbol de luces

Nivel	Color	Significado
0	Ámbar	Pre-stage
1	Ámbar	Stage
2	Amarillo	⚡
3	Amarillo	⚡⚡
4	Amarillo	⚡⚡⚡
5	Verde	¡Salida!
6	Rojo	Foul

Las luces son dinámicas (DrawLightWithRange) — se apagan si reinicias el recurso sin necesitar un reinicio del servidor.

---

Cinemáticas

Presentación — encuadra a cada piloto en su carril al inicio de la carrera (se salta con X).
Salida — cámara lateral que sigue a los autos al verde.
Victoria — órbita de 180° alrededor del ganador con su nombre en pantalla.

---

Tablero DUI (pantalla dinámica)

La pantalla del tablero cambia en tiempo real:

Modo	Cuándo se activa
Espera	Sin carrera activa
En vivo	Desde el verde hasta la meta
Resultados	Al cruzar ambos pilotos

El tablero recibe los datos del cliente ganador y el perdedor y muestra tiempos, reacción, velocidad y ganador con animación.

---

Apuestas

Si Config.ApuestaActiva = true, el totem de inscripción pregunta el monto antes de unirse a la cola. El servidor valida el saldo, cobra a ambos pilotos al inicio y transfiere el doble al ganador al resolver.

---

Props 3D incluidos

Modelo	Altura	Material
`ov_drag_arbol`	5.10 m	8 slots PBR + 14 luces emisivas
`ov_drag_sensor`	3.22 m	6 slots PBR + lentes de sensor
`ov_drag_tablero`	3.60 m	7 slots PBR + pantalla DUI

Todos incluyen colisión con flags correctos (MAP_WEAPON, MAP_DYNAMIC, MAP_VEHICLE).

---

Base de datos

-- Pistas guardadas por el creador
CREATE TABLE ov_drag_pistas (
    id        INT AUTO_INCREMENT PRIMARY KEY,
    nombre    VARCHAR(64),
    data      LONGTEXT,   -- JSON con coords de cada slot
    activa    TINYINT(1) DEFAULT 1,
    creado_en TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- Récords por pista
CREATE TABLE ov_drag_records (
    id         INT AUTO_INCREMENT PRIMARY KEY,
    pista_id   INT,
    src        INT,
    nombre     VARCHAR(64),
    tiempo     FLOAT,      -- segundos
    reaccion   FLOAT,      -- segundos
    velocidad  FLOAT,      -- km/h en la meta
    fecha      TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

---

Desarrollado por Hector Nolivos — WebCa Developer · Otra Vida RP