Respuestas a las dudas habituales y soluciones a los problemas que vienen de la instalación o de la configuración.

Preguntas frecuentes

¿Cómo consigo una clave de YouTube?

La clave es gratis y opcional. Sin ella, YouTube y SoundCloud suenan, pero YouTube no enseña la duración al añadir una canción, los enlaces de Spotify se rechazan y no se pueden importar listas.

1. Entra en la consola de Google Cloud con una cuenta de Google y crea un proyecto.
2. APIs y servicios → Biblioteca → busca YouTube Data API v3 → Habilitar.
3. APIs y servicios → Credenciales → Crear credenciales → Clave de API. Cópiala.
4. En la clave, Restricciones de API → Restringir clave → marca solo YouTube Data API v3.
5. Recomendado: Restricciones de aplicación → Direcciones IP → la IP pública de tu servidor.
6. Ponla en server.cfg con set (no setr) y reinicia el recurso:

server.cfg

set chipeo_youtube_key "TU_CLAVE"

La cuota gratis es de 10.000 unidades al día. Añadir un enlace de YouTube gasta 1 unidad; uno de Spotify, unas 101 (búsqueda); cada página de 50 vídeos al importar una lista, 2. Los enlaces ya leídos se recuerdan y las canciones guardadas en un USB no vuelven a consultarse. Las importaciones tienen su propio tope diario en library.playlist.dailyUnits.

¿Dónde se guarda el equipo?

Por matrícula. La radio, las piezas, el daño y el USB metido en el coche van con la matrícula. Si tu servidor cambia la matrícula de un coche, el equipo se queda con la antigua.

¿Funciona con otros inventarios?

Los ítems están escritos para ox_inventory: usan sus exports de ítem y guardan las canciones de cada USB en los metadatos del ítem.

¿Por qué YouTube suena sin ecualizador ni bajos?

YouTube y SoundCloud suenan dentro de su reproductor oficial. Sus términos no permiten alterar su audio, así que por defecto solo se aplican el volumen, la distancia y la cabina. Para activar los efectos:

1. El staff activa Efectos en plataformas en el Panel de staff (o library.platformEffects = true).
2. Cada jugador activa Efectos en plataformas en Ajustes → Solo para ti.

Si el cliente del juego de un jugador no lo permite, esa fuente le suena sin efectos y el ecualizador aparece bloqueado. Para tener todos los efectos, usa enlaces directos de audio.

¿Puedo dejar solo enlaces directos?

Sí. Pon library.platforms.youtube, soundcloud y spotify en false, o apágalos en vivo desde el panel.

¿Qué pasa con los ecualizadores guardados antes de la versión 2.3.0?

Los ecualizadores y presets guardados con las seis bandas antiguas se convierten a las diez bandas nuevas la primera vez que se leen. No hay que hacer nada; las bandas antiguas están en audio.eqLegacyBands.

Problemas

El recurso no arranca: falta una dependencia

Causa: falta o arranca después un recurso de la lista dependencies: ox_lib, oxmysql, cuxial_bridge, cuxial_chipeo_assets u object_gizmo, o OneSync está apagado.

Solución: instala el que falte y sigue el orden de arranque. cuxial_chipeo_assets tiene que arrancar antes que cuxial_chipeo.

La tablet no se abre o la pantalla sale vacía

Causa: la carpeta web/dist está incompleta, normalmente tras una subida a medias.

Solución: vuelve a copiar la carpeta cuxial_chipeo desde el paquete y reinicia el recurso.

Usar un ítem no hace nada

Causa: al ítem le falta la línea client = { export = 'cuxial_chipeo.<ítem>' } (las piezas también necesitan consume = 0), se ha renombrado la carpeta del recurso, o el nombre del ítem no coincide con shared/config.lua.

Solución: vuelve a copiar las entradas de install/items.lua, mantén la carpeta cuxial_chipeo y revisa los nombres en items y en data/components.lua.

Las piezas, las medusas o los trípodes no se ven

Causa: cuxial_chipeo_assets no está arrancado, o arranca después de cuxial_chipeo.

Solución: ensure cuxial_chipeo_assets antes de ensure cuxial_chipeo. Los jugadores que entraron antes del arreglo tienen que reconectar.

Los LED y los conos no laten con la música

Causas y soluciones:

• La pieza está cerrada. Las desplegables solo se mueven abiertas: ábrelas desde la app Equipo o enciende Automático.
• El jugador está más lejos de anim.range (40 m), o hay más de anim.maxAnimated piezas cerca. Acércate o sube esos valores.
• La canción viene de YouTube o SoundCloud sin efectos en plataformas. No hay nivel real de graves que leer, así que los conos siguen un latido de reserva constante (anim.fallbackHz). Con enlaces directos, o con los efectos en plataformas activados, siguen el golpe real.
• La pista suena muy baja. Por debajo de anim.minLevel el cono se queda quieto.

Fallan los enlaces de Spotify o la importación de listas

Causa: no hay clave de YouTube, la clave está restringida a otra API o a otra IP, o la cuota del día se ha gastado.

Solución: revisa set chipeo_youtube_key en server.cfg y las restricciones de la clave. La consola avisa una vez con el código de respuesta cuando YouTube rechaza la clave. La cuota se renueva cada día.

Se rechaza un enlace directo

Causa: su extensión no está en library.allowedExtensions, su dominio no está en library.allowedHosts, o es más largo que library.maxUrlLength. Cuando el motivo es el dominio, el jugador ve «Ese sitio no está permitido para enlaces directos». allowedHosts viene con servicios de alojamiento habituales (Discord, Catbox, Dropbox, GitHub, archive.org) e incluye sus subdominios. Las canciones guardadas en un USB desde un dominio que ya no está permitido se saltan.

Solución: usa un enlace directo al archivo de audio de un dominio permitido, añade tu dominio a library.allowedHosts, o deja la lista vacía para aceptar cualquier dominio. YouTube, SoundCloud y Spotify no dependen de esta lista.

Otros jugadores no oyen la música

Causas y soluciones:

• Están en otro routing bucket. Con buckets.enabled = true cada jugador solo oye su bucket; buckets.shareDefault = true hace que el bucket 0 se oiga desde todos.
• Tienen el modo streamer activado y la canción tiene derechos.
• Están fuera de alcance. Sin piezas, un coche se oye a audio.defaultDistance; las piezas dan más alcance, hasta sound.maxRange.
• La emergencia está activa, o el staff bloqueó al dueño desde el panel.

Una medusa pública no deja a otros añadir canciones

Causa: es así por diseño. Desde una medusa pública los demás manejan la reproducción, pero añadir, quitar o importar canciones en el USB queda para el dueño del coche, quien instaló la radio y quien va dentro.

Solución: añade las canciones desde dentro del coche. Los demás pueden seguir mandando una petición de canción.

Un equipo grande no cabe: «Ya no caben más piezas»

Causa: se ha llegado a uno de los topes. «el máximo de piezas» es mounts.maxPerVehicle (piezas de sonido), «Ya no caben más piezas eléctricas» es mounts.maxElectric, y «Ya no caben más piezas de este tipo» es el tope por clase de mounts.limits. Un modelo puede tener sus propios valores en data/vehicles.lua.

Solución: sube esos valores, o dale a ese modelo sus propios limits en data/vehicles.lua. Para un equipo de exhibición, el staff puede activar un Proyecto especial en el coche.

La radio se corta o no suena

Causa: el sistema eléctrico. Con el motor apagado la batería se gasta y, por debajo de electric.cutVolts, la radio se corta. Un fusible fundido también corta la corriente.

Solución: arranca el motor, monta una batería AGM o un condensador, repón el fusible desde la app Equipo con un chipeo_fuse, o pon electric.enabled = false para tener corriente infinita.

No se puede desinstalar la radio

Causa: el coche aún tiene piezas montadas, o el jugador no es el dueño ni quien la instaló (install.unmountOwnerOnly = true).

Solución: quita antes todas las piezas en el taller.

«Taller de sonido» no aparece en un coche

Causa: la opción solo sale a pie y en coches con radio o con piezas. Una vez abierto, solo el dueño, el instalador, los trabajos de mechanic.jobs, los miembros del taller y el staff pueden montar piezas.

Solución: instala antes la radio, o añade el trabajo a mechanic.jobs. /tallerchipeo junto al coche abre el mismo taller.

«Instalar» no aparece en el coche con la pieza en la mano

Causas y soluciones:

• El coche está a más de shop.carry.scanRange. Acércate.
• Un mecánico del taller usó el ítem desde el inventario en el coche de otro. En los coches de clientes la pieza se coge en un banco de trabajo: abre el taller del coche, elige la pieza y ve al banco.
• Con el trabajo del taller: el mecánico está fuera de servicio, el coche no está dentro de una bahía (shop.bayOnly = true) o su grado no permite ese tipo de pieza (shop.ranks).
• La pieza cogida en el banco caducó a los shop.bench.pickExpireMs. Vuelve a cogerla.

No sale la opción del banco de trabajo

Causa: Coger (pieza) solo aparece después de elegir una pieza en el taller del coche de un cliente, y solo con shop.job.enabled = true.

Solución: entra de servicio en la oficina, abre el taller del coche en una bahía, elige la pieza y ve después al banco. Si no hay bancos, añádelos desde /chipeoadmin → Taller → Puntos.

La factura no le llega al cliente

Causas y soluciones:

• El dueño está a más de shop.invoice.ownerRange del coche, o el cliente elegido a más de shop.invoice.range del mecánico.
• El mecánico está fuera de servicio, lejos del coche, o su grado no tiene charge en shop.ranks.
• La orden está vacía o ya tiene una factura pendiente, o el cliente ya tiene otra factura abierta.
• El cliente no contestó en shop.invoice.expireMs. La orden sigue abierta y se puede volver a facturar.

El dinero no llega a la sociedad, o el mostrador dice que la cuenta del taller no está disponible

Causa: la cuenta de sociedad de shop.income.society no existe en tu sistema de banca o sociedades. La consola lo avisa al arrancar.

Solución: crea la cuenta de sociedad del trabajo (en ESX la crea install/jobs/esx.sql) y reinicia. Las ventas en monedas VIP nunca van a la sociedad.

El jefe no puede despedir a miembros desconectados

Causa: Cuxial Bridge es anterior a la 2.16.0.

Solución: actualiza Cuxial Bridge a la 2.16.0 o posterior.

El dueño no puede quitar piezas de su coche

Causa: con shop.job.enabled = true, solo quitan piezas el jefe del taller (de servicio, en una bahía o junto a un punto del taller) y el staff.

Solución: lleva el coche al taller, o pon shop.job.enabled = false si tu servidor no usa el trabajo del taller.

El cable de la medusa o los cables eléctricos parecen una cuerda normal

Causa: otro recurso también sustituye las texturas de cuerda del juego (rope.ytd) y gana el último que carga.

Solución: deja un solo recurso que streamee rope.ytd, o pon medusa.cable.rope.custom = false para usar la cuerda del juego.

Todo el mundo instala y repara sin ítems

Causa: debug = true.

Solución: pon debug = false en shared/config.lua y reinicia.

Sale «Espera un momento» a menudo

Causa: el jugador ha llegado a un tope de peticiones de limits.

Solución: sube el valor de esa acción solo si lo alcanza un uso legítimo.