Qué hacen los jugadores, los mecánicos y el staff con Cuxial Chipeo, y las reglas de cada parte.

Instalar la radio

• chipeo_radio instala la radio en el coche junto al que está el jugador. Lleva una barra de progreso y gasta el ítem. Con install.ownerOnly = true solo puede hacerlo el dueño.
• chipeo_unmount la desinstala y devuelve chipeo_radio. Por defecto solo el dueño o quien la instaló, y solo cuando ya no queda ninguna pieza montada.
• La instalación se guarda por matrícula.

La tablet

Dentro de un coche con radio, F4 (o /chipeo) abre la tablet. El dueño, o quien la instaló, también puede abrirla desde fuera a remoteRange metros.

App	Qué hace
Reproductor	Ahora suena con espectro y forma de onda, cola, anterior/siguiente, repetir, aleatorio, fundido, avance
Bajos	Nivel de bajos, frecuencia de corte y pegada, indicadores de calor y presión
Ecualizador	Diez bandas con curva arrastrable, estilos, presets personales y Comparar
Biblioteca	USB: canciones, listas, favoritas, recientes, búsqueda, importar, peticiones
Equipo	Piezas montadas sobre una vista cenital del coche, medidor de dB en vivo, tarjeta de batería, reponer fusible, abrir/cerrar piezas desplegables
Vehículo	Puertas, ventanas, capó, maletero y extras
Grupo	Crear un grupo, invitar, expulsar, salir
Ajustes	Apariencia y las opciones personales «Solo para ti»

Mantener Alt (ui.cameraKey) suelta el ratón para mirar alrededor, y con ui.cameraMove = true el jugador puede seguir andando o conduciendo.

Solo para ti (solo afecta a quien lo cambia): volumen de la música, actualización del sonido, efectos en plataformas, modo streamer, filtros de ambiente y cables visibles. El volumen y la actualización también se cambian con /volumenmusica e /intervalomusica.

Fuentes de música

Fuente	Cómo suena	Ecualizador y bajos
Enlace directo (mp3, ogg, wav, m4a, aac, flac, opus, webm)	Audio web	Sí
YouTube / YouTube Music	Reproductor oficial incrustado	Solo con efectos en plataformas
SoundCloud	Reproductor oficial incrustado	Solo con efectos en plataformas
Spotify	Se busca y suena su vídeo de YouTube	Igual que YouTube

Efectos en plataformas. Con library.platformEffects = true en el servidor y la opción activada en «Solo para ti», YouTube y SoundCloud también pasan por el ecualizador, los bajos, el audio 3D y el limitador. Si el cliente del juego del jugador no lo permite, esa fuente suena sin efectos sola y el ecualizador vuelve a quedar bloqueado.

Los términos de YouTube y SoundCloud no permiten alterar su audio. Por eso platformEffects viene en false. El staff puede cambiarlo en vivo desde el panel.

Biblioteca en USB

• Usar un USB dentro del coche lo mete en la radio. Su capacidad (de 8 a 128) es el número de canciones que guarda.
• Las canciones van con el USB: se expulsa, se presta, se usa en otro coche o se clona en un USB vacío de igual o mayor capacidad.
• En la biblioteca: listas con nombre y portada (crear, duplicar, renombrar, ordenar, borrar, reproducir), favoritas, recientes, búsqueda instantánea y forma de onda de cada canción directa.
• Importar una lista de YouTube: pega un enlace con list=. El servidor la lee, salta los vídeos privados, borrados, directos y repetidos, enseña el progreso y luego el jugador elige Añadir a la cola (sin USB) o Guardar en el USB (hasta su capacidad). Necesita la clave de YouTube.
• Compartir una lista con un jugador que está a tu lado: se copia a su USB si acepta.

Peticiones de canciones

Los jugadores cerca de un coche con música (o los pasajeros, según social.request.who) piden una canción desde la tablet o con /pedircancion <enlace>. El dueño recibe un aviso y la acepta a la cola o la rechaza. Los topes por jugador y por coche están en social.request.

Taller de sonido

Las piezas se montan desde fuera del coche: /tallerchipeo o la opción de target Taller de sonido en un coche con radio o con piezas. Pueden usarlo el dueño, quien instaló la radio, los trabajos de mechanic.jobs, los miembros del trabajo del taller y el staff.

Portón desplegado.

Las piezas se instalan con la pieza en la mano:

1. Elige una pieza del catálogo. Solo salen las que tienes en el inventario.
2. La pieza pasa a tus manos. Las grandes (torres, portones, paredes de techo y la caja XL) se llevan en una caja embalada.
3. Ve al coche y elige Instalar (pieza) sobre él. X (shop.carry.cancelKey) suelta la pieza sin gastar nada.
4. Colócala con el gizmo. Se engancha al hueso sobre el que la dejas (chasis, maletero, techo, puertas…).
5. Confirma. El ítem sale del inventario solo en ese momento; al quitar la pieza se devuelve.

• Usar el ítem de una pieza desde el inventario también la pone en tus manos: Instalar aparece en el coche más cercano.
• Los mecánicos del taller que instalan en el coche de otro cogen antes la pieza en un banco de trabajo. Consulta Negocio del taller.
• El staff coloca las piezas directamente con el gizmo y no necesita el ítem.
• La pieza se suelta al subir a un vehículo, morir, alejarse más de shop.carry.maxDistance del coche o pulsar la tecla de soltar.

Familia	Piezas	Dónde
Altavoces	Subwoofers 10", 12", 15", 18" · medios 8", 12" · tweeter · corneta	En cualquier sitio
Cajas de maletero	S, M, L, XL	Maletero
Torres desplegables	S, M, L	Techo
Portones	S, M, L, XL	Portón trasero
Paredes de techo	S, M, L, XL	Techo
Eléctrico	Amplificadores S, M, L, XL · batería AGM · condensador 3 F · portafusibles ANL · portafusibles 600 A	Maletero
Alternadores	HO 250 A · XL 350 A	Interno (sin prop)
Conector	Conector de medusas	En cualquier sitio

• Los topes por coche y por clase están en mounts.maxPerVehicle, mounts.maxElectric y mounts.limits. Consulta Equipos grandes.
• Las piezas desplegables (torres y paredes) se abren y se cierran con su animación desde la app Equipo. Con Automático se abren al sonar la música y se cierran al pararla o si el coche va rápido.
• Conos y LED se mueven con los graves reales de la canción.
• El sonido sale de las piezas: cada una tiene su nivel en dB a 1 m y entre todas marcan a qué distancia se oye el coche. Las desplegables cerradas y las piezas dentro del maletero cerrado suenan apagadas.

Los conos siguen los graves de la canción.

Equipos grandes

• Dos cupos separados. Las piezas de sonido cuentan contra mounts.maxPerVehicle (24) y las eléctricas (amplificadores, baterías, condensadores, portafusibles y alternador) contra mounts.maxElectric (10). Añadir piezas eléctricas nunca quita un hueco de altavoz.
• Hasta 4 baterías y un alternador por coche, además de los topes por clase de mounts.limits.
• Alternadores. HO (250 A) y XL (350 A) son piezas internas: no tienen prop, sustituyen al alternador de serie y se instalan con una barra de progreso. No se mueven ni tienen anclaje.
• Piezas grandes. El amplificador XL da 12.000 W y el portafusibles grande aguanta 600 A.
• Límites por modelo. Un modelo de data/vehicles.lua puede subir o bajar el total, el cupo eléctrico o cualquier clase con limits.
• Posición por defecto. Al colocar una pieza, aparece en su sitio habitual para ese modelo (mounts en data/vehicles.lua). Sin ese dato, el sitio se estima con el tamaño del modelo.
• El asesor del taller recomienda un alternador, el amplificador XL o el portafusibles que menos piezas pide cuando el equipo lo necesita.

Proyecto especial

El staff puede marcar un coche como Proyecto especial desde el Panel de staff. Se guarda por matrícula y muestra una insignia en el taller, en la app Equipo y en el medidor de dB.

• Sin topes por clase ni total, hasta mounts.specialMax piezas.
• Energía infinita: sin caída de tensión, sin batería agotada, sin fusible y sin pérdida por amplificador.
• Sin calor: el equipo nunca se fríe.
• Sin ahogo y con más volumen (sound.special).

Negocio del taller

Una tienda de sonido con mostrador público y, si quieres, un trabajo con mecánicos, órdenes de trabajo, facturas y jefe. Se configura en shop de shared/config.lua. Los precios los pone solo el staff en el Panel de staff.

Puntos

Punto	Quién	Qué hace
Mostrador (shop)	Cualquiera	Tienda de sonido abre la tienda: catálogo, carrito y pago. Cada artículo se paga en su propia moneda.
Banco de trabajo (bench)	Mecánicos del taller	Donde se coge la pieza antes de instalarla en el coche de un cliente.
Bahía (bay)	Mecánicos del taller	Zona donde se trabaja en los coches. Con shop.bayOnly = true los mecánicos solo instalan en coches ajenos dentro de una bahía.
Oficina (boss)	Miembros del taller	Entrar / Salir de servicio para todos, y Gestión del taller para el jefe.

Los puntos se crean la primera vez desde data/shop.lua (coinciden con el mapa del taller). El staff los mueve, añade o borra desde el panel.

Con trabajo

Con shop.job.enabled = true, los miembros del trabajo del taller trabajan así:

1. Entran de servicio en la oficina.
2. Con el coche del cliente en una bahía, abren el taller del coche y eligen una pieza. El catálogo enseña el precio de instalación de cada pieza.
3. Un aviso arriba dice que vayan al banco de trabajo, y los bancos se marcan. En el banco, Coger (pieza) pone la pieza en sus manos.
4. La llevan al coche, eligen Instalar (pieza), la colocan con el gizmo y confirman. Corre una barra de progreso y la pieza se apunta en la orden de trabajo del coche.
5. Las reparaciones del equipo frito hechas con /repairchipeo también entran en la orden, con el precio de reparación.

Lo que puede hacer cada grado se define en shop.ranks: los tipos de pieza que instala, y si repara, factura y abre el menú de jefe. Con el trabajo activo, solo el jefe (de servicio, en una bahía o junto a un punto del taller) y el staff pueden quitar piezas.

Orden de trabajo y factura

• Cada coche tiene una orden abierta con todas las instalaciones y reparaciones: pieza, mecánico, precio y total. El panel del taller del coche la enseña en vivo.
• Facturar manda la orden al dueño del coche, o a un cliente cercano que elige el mecánico si el dueño no está.
• El cliente recibe la factura con cada línea y el total, elige la cuenta (shop.invoice.accounts) y la paga o la rechaza. Caduca a los shop.invoice.expireMs.
• Pagada: el dinero va a la cuenta de sociedad del taller y la orden se cierra. Rechazada o caducada: la orden sigue abierta y el jefe la ve como impagada.
• Los mecánicos no pueden cambiar ningún importe: los precios de instalación y de reparación salen del panel de staff.

Menú de jefe

En la oficina, Gestión del taller abre el menú de jefe (grados con boss = true, y el staff):

Pestaña	Qué enseña
Plantilla	Miembros con su grado, si están conectados y de servicio. Contratar a jugadores cercanos, subir o bajar de grado a los conectados y despedir, también a quien está desconectado.
Instalaciones	Cobrado e impagado, ingresos por día, piezas más instaladas, ranking de mecánicos y facturas impagadas de los últimos shop.boss.statsDays días.
Mostrador	Unidades e ingresos de las ventas del mostrador pagadas en monedas normales, por día y por artículo. Las ventas en monedas VIP solo las ve el staff.
Sociedad	Saldo de la cuenta de sociedad del taller.

Sin trabajo

Con shop.job.enabled = false no hay bancos, órdenes, facturas ni jefe: solo el mostrador. Cada jugador instala sus propias piezas con la pieza en la mano, y los trabajos de mechanic.jobs siguen montando y reparando.

Sistema eléctrico

El coche tiene batería y alternador. El equipo montado consume corriente según su potencia y el volumen.

• Caída de tensión. Con mucha carga baja la tensión: menos volumen, menos graves, recorte suave y luces que bajan con cada golpe.
• Motor apagado. La batería se gasta. Por debajo de electric.cutVolts la radio se corta hasta que el motor arranca o la batería se recupera.
• Amplificadores. Los altavoces necesitan vatios de amplificador. Si faltan, el equipo pierde hasta 12 dB y distorsiona.
• Batería extra y condensador. Una batería AGM suma capacidad y reduce la caída (hasta 4 por coche); un condensador suaviza cada golpe.
• Alternador. Un alternador HO o XL sustituye al de serie y carga más rápido con el motor en marcha.
• Fusible. Con portafusibles, una sobrecarga mantenida funde el fusible y corta la corriente. Reponer fusible en la app Equipo gasta un chipeo_fuse.
• Cables visibles entre batería, condensador, portafusibles y amplificadores: rojo el positivo, negro el negativo.

Sonido

• Oclusión. Solo las paredes y los edificios apagan la música, nunca las piezas del propio coche. Los cambios son suaves, y entre dos interiores distintos una puerta o persiana abierta deja pasar parte del sonido.
• Ventanas y puertas abiertas. Las ventanas bajadas o rotas y las puertas abiertas dejan salir el sonido de la cabina, para el dueño y para todos los de fuera. Cajas abiertas, buggies y quads cuentan como abiertos.
• Varias fuentes. Cada coche cercano mantiene sus propias fuentes y su posición, también en una quedada con muchos coches.
• Ecualizador. Diez bandas de 31 Hz a 16 kHz con curva arrastrable, 11 estilos y presets personales. Comparar, mantenido, reproduce la canción sin ecualizador al mismo volumen, solo para ti. El nivel se compensa para que una curva más fuerte no suene solo más alta.
• Nivel y limitador. Un compresor suave de graves evita que el bombo tape las voces, y un limitador evita el recorte con el volumen alto.
• Sonido 3D cercano. Las fuentes cercanas tienen audio 3D detallado; las lejanas, panorama simple, con fundido entre los dos.
• El mismo volumen entre canciones. Las canciones directas se igualan a una sonoridad común (library.normalizeTarget).

Los ecualizadores y presets guardados con las seis bandas de versiones anteriores se convierten solos a diez bandas la primera vez que se leen.

Vibración, calor y presión

• Se siente. La cámara vibra con los graves que de verdad le llegan al jugador, más dentro del coche, y un coche parado se balancea con cada golpe. Un medidor de dB enseña el nivel en vivo.
• Sobrecalentamiento. Bajos demasiado altos durante mucho rato, o más potencia de la que aguanta el equipo, lo fríen: el maletero arde y el volumen y los bajos quedan limitados hasta que un mecánico lo repara con /repairchipeo.
• Presión. En un coche cerrado del todo y con el volumen alto, la presión sube hasta que revienta una ventana.

Medusas

Medusa grande en su trípode.

Una medusa es un altavoz portátil que maneja la radio de un coche con equipo.

1. Usa el ítem. El jugador la lleva en brazos y aparece un panel pequeño en la esquina. Mantén Alt izquierdo para usar el panel sin dejar de andar.
2. Emparéjala con un coche cercano que tenga radio. Un cable va de la medusa al maletero.
3. Déjala en el suelo o ponla en un trípode (chipeo_medusa_pole). El trípode se coloca con una vista fantasma: E coloca, Retroceso cancela, la rueda del ratón y las flechas giran.
4. Hazla pública para que otros manejen la radio desde ella. Una medusa privada solo responde a su dueño. Añadir, quitar o importar canciones en el USB queda para el dueño, quien instaló la radio y quien va dentro del coche.
5. Cógela o guárdala en el inventario.

• Si la medusa se aleja más que el largo del cable (medusa.cable.length), se desenchufa y se pierde el control; se vuelve a enchufar sola a medusa.cable.reconnect metros.
• El panel de la medusa tiene las pestañas Radio, Mezcla, Cola, Equipo, Coche y Listas.
• Opciones de target en una medusa: coger, abrir panel, hacer pública/privada; en un trípode: poner la medusa, moverlo, plegarlo y guardarlo.

Grupos

El dueño de un coche con música crea un grupo en la app Grupo e invita a coches cercanos con radio o a medusas enchufadas a uno. Los equipos del mismo jugador entran directos; los demás aceptan o rechazan.

• Todos los miembros suenan con la pista del maestro en el mismo instante (pausa, avance, siguiente y fundido incluidos), cada uno con su volumen, ecualizador, piezas y posición 3D.
• Un miembro sale del grupo si se aleja más de groups.maxDistance. El grupo se disuelve si el dueño se va o el maestro desaparece.

Instalaciones fijas

Equipos de sonido que viven en el mundo: discotecas, eventos, negocios. El staff los monta desde el Panel de staff: un controlador (un prop de medusa o una zona invisible) más piezas del catálogo colocadas con el gizmo. Los jugadores los usan con la opción de target del controlador, con la misma tablet, según sus permisos y su horario.

Modo streamer

Con Modo streamer activado en «Solo para ti», el jugador no oye las canciones con derechos (contenido con licencia de YouTube, Spotify y lo que el servidor marque en library.streamer). Oye silencio, o la pista de sustitución si hay una configurada, y ve «Silenciado por modo streamer». Los demás oyen normal. El servidor puede imponerlo a todos con library.streamerForced.

Routing buckets

Con buckets.enabled = true, cada jugador solo oye y maneja los coches, medusas e instalaciones de su routing bucket. Los grupos solo unen equipos del mismo bucket.