Documentación de Taller de tuning completo
Taller de tuning completo
Que hace
ov_tuning es el taller de tu ciudad en un solo recurso: los jugadores personalizan su vehículo con vista previa en vivo, cambian el motor con el sonido real de cada auto, ponen turbo, supercargador, chip y nitro, y los mecánicos de cada taller instalan las piezas físicamente y cobran por ello. Las piezas también se pueden robar en la calle y se convierten en objetos del inventario.
- El servidor decide todo: precio, descuento, reparto, permisos y distancia se validan en el servidor; el cliente solo pide.
- Pedidos con dinero retenido: el cliente paga al pedir, el dinero queda retenido y se libera por categoría instalada (por defecto 50 % a la caja del taller y 50 % al banco del mecánico). Cancelar antes de instalar devuelve todo.
- Talleres creados desde el juego: un administrador crea talleres, trabajos, grados y zonas sin tocar archivos.
- Negocio completo: caja, empleados y grados, códigos de descuento, facturas, avisos y estadísticas.
- Motores con sonido: 44 motores con muestra para escuchar antes de comprar y 12 genéricos.
- Marca tuya: la interfaz y todos los textos se cambian en la configuración y los idiomas.
Requisitos
- FiveM con QBCore, QBox o ESX (puente incluido).
oxmysql(obligatorio).ox_inventorypara el nitro y el robo de piezas.ox_libes opcional (minijuego al instalar).- Los sonidos de motor reales requieren un recurso de audio con los motores (en nuestro servidor,
santabria-sounds); sin él, el catálogo de motores no cambia el sonido.
Instalacion
- Copia
ov_tuningaresourcesy añade alserver.cfg, después deoxmysql, del framework y deox_inventory:
ensure ov_tuning
add_ace group.admin ov_tuning.admin allow- Copia las definiciones de
instalar/items_ox_inventory/items_ov_tuning.luaaox_inventory/data/items.luay los iconos aweb/images. - Reinicia una vez. Las tablas se crean solas.
- En la consola del servidor, una sola vez:
ov_importar_talleres(crea siete talleres de ejemplo con sus zonas). O crea los tuyos con/ovadmin. - Pon el precio de los vehículos que quieras en
config/prices.lua(ByModel); los demás se calculan por categoría o por el valor del framework.
El recurso viene protegido con Asset Escrow de Cfx.re. La configuración (config/), los idiomas (locales/), la interfaz (web/) y los puentes no van cifrados.
Configuracion
Todo está en config/:
| Archivo | Para qué sirve |
|---|---|
config.lua | Instalación física (tiempos, distancia, minijuego, objeto requerido), negocio y cuentas de pago, supercargador, chip (campos con rangos de seguridad y perfiles), sonidos de turbo, tope de potencia, panel, cámara, stance, restricciones por clase de vehículo, misiones |
prices.lua | Precio por defecto, por modelo y por categoría, y el multiplicador de cada pieza |
nitro.lua | Botellas, tiempos, calor, colores y sonidos del nitro |
theft.lua | Robo de piezas: herramientas, piezas, reglas, avisos a la policía, comprador, efecto sin catalizador y definición de los objetos |
Valores que querrás mirar primero: Config.OrderSplit (reparto caja/mecánico), Config.Powertrain (tope de fuerza y velocidad), Config.Theft.MinPolice y AlertChance (robo de piezas).
Comandos y permisos
Permiso ov_tuning.admin para el staff.
| Comando | Para que sirve |
|---|---|
/ovtaller | Taller gratis para administradores (aplica al instante) |
/ovtaller pedido | Taller con precio: arma el pedido y retiene el dinero |
/ovpedidos | Pedidos abiertos: tomar, instalar por categoría, cancelar |
/ovnegocio | Caja, empleados, códigos de descuento, facturas y anuncios |
/ovadmin | Crear talleres, trabajos y zonas |
/ovpotencia (F6) | Panel de turbo, supercargador, chip y nitro dentro del vehículo |
/ovmision | Misión de empleado: reparar un vehículo averiado y cobrar |
/ovsonido 0-100, /ovturbo | Volumen del turbo y sonido propio |
/nitromenu, /nitromodo, /nitro_color | Nitro (Shift activar, Z purga, F5 tanque) |
Robo de piezas
Las piezas instaladas se pueden sacar de vehículos ajenos con una herramienta (amoladora, llave de cruz o juego de llaves), con barra de trabajo y minijuego. El servidor valida herramienta, distancia, que no haya nadie dentro, que esté parado, que no sea tuyo, enfriamiento por vehículo, policías conectados y tiempo mínimo. La pieza pasa al inventario con sus datos; se puede vender a un comprador (ped configurable) o montar en otro vehículo (el dueño o un mecánico). Sin catalizador, el vehículo pierde potencia, echa humo y petardea. Todo se ajusta o se apaga en config/theft.lua.
Como funciona por dentro
- El jugador arma el pedido; el servidor recalcula el total con su tabla de precios, cobra y crea el pedido en una transacción.
- Un mecánico lo toma e instala categoría por categoría (token de sesión, distancia, tiempo mínimo y minijuego).
- Al terminar cada categoría se libera su parte de dinero y queda anotada en un libro mayor que solo se agrega; al arrancar se comprueba que no hay descuadres.
- El estado del tuning se guarda en el vehículo del jugador y llega a su garaje (compatible con JG Garage y con garajes propios); los vehículos de tráfico no ensucian la base de datos.
- No hay bucles cuando no hay nada que hacer: el consumo en reposo es prácticamente cero.
Probado
Se probó con simulación: más de 940 pruebas automáticas (pedidos y dinero, taller, negocio, nitro, cámara, robo de piezas, tienda, potencia, instalación, persistencia y misiones), comprobaciones de base de datos y la interfaz en un navegador.
Aviso importante
Aún no se ha probado dentro del juego: las cámaras, el sonido del motor forzado, la sensación de potencia, el camber y los efectos de humo pueden necesitar ajustes. Los iconos de las piezas robadas usan los de ox_inventory hasta que haya iconos propios, y el desgaste de piezas, el dinamómetro y el elevador no están hechos todavía.