Sigue los pasos en orden. El paquete son tres recursos: cuxial_chipeo_assets, cuxial_chipeo y, si lo has comprado, el mapa cuxial_chipeo_map (Vecinos Enfadados Car Audio).

Comprueba las dependencias

Instala y arranca antes estas:

• OneSync activado en el servidor
• ox_lib
• oxmysql
• cuxial_bridge 2.16.0 o posterior, configurado para tu framework (Cuxial Bridge)
• object_gizmo
• ox_inventory, para los ítems
• Un target compatible con Cuxial Bridge, para las opciones de medusas, coches e instalaciones fijas

Copia los recursos

Pon cuxial_chipeo_assets y cuxial_chipeo en tu carpeta resources (y cuxial_chipeo_map si usas el mapa). No cambies los nombres de las carpetas: los ítems y los modelos se buscan por ese nombre.

Base de datos

Las tablas se crean en el primer arranque. Si tu usuario de la base de datos no puede crear tablas, importa install/schema.sql antes de arrancar el recurso.

install/schema.sql

-- chipeo_installs, chipeo_vehicle_damage, chipeo_vehicle_usb, chipeo_playlists,
-- chipeo_eq_presets, cuxial_chipeo_mounts, cuxial_chipeo_settings, cuxial_chipeo_special,
-- cuxial_chipeo_fixed, cuxial_chipeo_lists, cuxial_chipeo_history,
-- cuxial_chipeo_shop_points, cuxial_chipeo_shop_items, cuxial_chipeo_shop_sales,
-- cuxial_chipeo_shop_orders, cuxial_chipeo_shop_order_lines, cuxial_chipeo_shop_invoices

Si actualizas desde una versión anterior, las tablas existentes se migran en el primer arranque: se borra el antiguo almacén del taller y se añaden las columnas nuevas.

Añade los ítems

install/items.lua trae todos los ítems listos para ox_inventory con los nombres en español (install/items_en.lua trae los mismos en inglés). Pega sus entradas, sin el return { del principio ni el } del final, dentro de la tabla de ox_inventory/data/items.lua.

Grupo	Ítems
Radio	chipeo_radio (instala), chipeo_unmount (desinstala y devuelve la radio)
USB	usb_8, usb_16, usb_32, usb_64, usb_128 (el número es cuántas canciones caben)
Materiales de reparación	chipeo_amp, chipeo_crossover, chipeo_cables, chipeo_battery
Altavoces	chipeo_sub10, chipeo_sub12, chipeo_sub15, chipeo_sub18, chipeo_mid8, chipeo_mid12, chipeo_tweeter, chipeo_horn
Conjuntos	chipeo_tower_s/m/l, chipeo_box_s/m/l/xl, chipeo_gate_wall_s/m/l/xl, chipeo_roof_wall_s/m/l/xl, chipeo_cable_plug
Eléctrico	chipeo_amp_s/m/l/xl, chipeo_battery_agm, chipeo_capacitor, chipeo_fuse_block, chipeo_fuse_block_l, chipeo_alternator_ho, chipeo_alternator_xl, chipeo_fuse
Medusas	chipeo_medusa_s, chipeo_medusa_l, chipeo_medusa_pole (trípode)

• Los ítems que se usan desde el inventario llevan client = { export = 'cuxial_chipeo.<ítem>' }. Mantén esa línea.
• Los USB no se apilan: cada uno guarda sus canciones.
• Las piezas y las partes eléctricas llevan consume = 0 y su export de cliente: al usar una, la pieza pasa a las manos del jugador. Se quitan del inventario solo al confirmar la instalación y se devuelven al desmontarlas.
• Imágenes: copia install/images/*.webp a ox_inventory/web/images/ (sustituye las que tengan el mismo nombre). Hay una por ítem, a 256 px; en install/images/src/ van las mismas a 512 px en PNG.
• Nombres visibles, pesos e imágenes los eliges tú. Los nombres de ítem deben coincidir con shared/config.lua y data/components.lua.

Si actualizas desde una versión anterior, vuelve a pegar las entradas de install/items.lua (o install/items_en.lua). Sin consume = 0 y el export de cliente, las piezas no se pueden instalar desde el inventario.

Trabajo del taller (opcional)

El negocio del taller usa el trabajo taller_chipeo con tres grados (el último es el jefe). Cuxial Chipeo no lo crea: pégalo en tu framework. Sin él, el mostrador sigue funcionando y la consola muestra un aviso. Sáltate este paso con shop.job.enabled = false.

Pega la entrada de install/jobs/qbx_core.lua dentro de la tabla de qbx_core/shared/jobs.lua.

Las facturas pagadas y las ventas del mostrador en monedas normales van a la cuenta de sociedad de shop.income.society (taller_chipeo). Debe existir en tu sistema de banca o sociedades; si no existe, la consola avisa al arrancar.

Convars (opcional)

server.cfg

# Clave de YouTube Data API v3: duración y estado de cada vídeo, enlaces de Spotify e importar listas
set chipeo_youtube_key "TU_CLAVE"

# Webhook de Discord para los registros (solo con logs.enabled = true)
set cuxial_chipeo_webhook "URL_DE_TU_WEBHOOK"

# Idioma: en o es
setr ox:locale "es"

Usa set para la clave de YouTube y el webhook, nunca setr ni sets. Con set se quedan en el servidor y no llegan a los jugadores.

Sin clave de YouTube, YouTube y SoundCloud suenan igual. Los enlaces de Spotify y la importación de listas necesitan la clave. Cómo conseguirla: Problemas frecuentes, en Preguntas frecuentes.

Ajustes de producción

Abre shared/config.lua y revisa:

• debug = false. Con true el staff usa los comandos de prueba sin ítems ni trabajo.
• admin.permission: el permiso de Cuxial Bridge de tu staff ('admin' por defecto).
• mechanic.jobs: los trabajos que reparan y montan piezas a otros.
• shop.job.enabled: false si solo quieres el mostrador, sin trabajo del taller.
• library.allowedHosts: los dominios que se aceptan para enlaces directos. Viene con servicios de alojamiento habituales; déjala vacía para aceptar cualquier dominio.
• Precios y monedas del taller: se ponen en /chipeoadmin → Taller (Panel de staff).

Orden de arranque

server.cfg

ensure oxmysql
ensure ox_lib
# tu framework
ensure ox_inventory
# tu target
ensure cuxial_bridge
ensure object_gizmo

ensure cuxial_chipeo_assets
ensure cuxial_chipeo
ensure cuxial_chipeo_map   # opcional

Comprueba que funciona

1. Date chipeo_radio, usb_8, chipeo_sub12 y chipeo_amp_s.
2. Ponte junto a tu coche y usa chipeo_radio. Corre una barra de progreso y la radio queda instalada.
3. Súbete y pulsa F4. Se abre la tablet.
4. Pega un enlace directo a un archivo de audio y dale a reproducir. Bájate: la música se oye alrededor del coche.
5. Usa usb_8 dentro del coche y guarda la canción en el USB desde la biblioteca.
6. Fuera del coche, escribe /tallerchipeo, elige el subwoofer y colócalo con el gizmo. Su cono se mueve con los bajos. El staff lo coloca directamente; los demás jugadores llevan antes la pieza al coche y eligen Instalar.

Siguiente: Guía de funciones y Configuración.