La mayoría de los fallos vienen de una dependencia que falta, del orden de arranque o de que el complemento no está iniciado. Busca tu síntoma aquí abajo.

Arranque

El recurso no arranca: «Could not find dependency»

Causa. Falta o está parado alguno de los recursos declarados en el manifest: ox_lib, oxmysql o cuxial_bridge. También hace falta OneSync.

Solución. Instala el recurso que falta e inícialo antes que cuxial_emotes. Activa OneSync en el servidor.

ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure cuxial_emotes

Los exports o los ítems fallan con «No such export»

Causa. Se ha renombrado la carpeta. Los demás recursos y los ítems del inventario llaman al recurso por su nombre.

Solución. Vuelve a llamar a la carpeta cuxial_emotes.

La consola avisa de que cuxial_emotes_dlc está instalado pero no iniciado

Causa. La carpeta del complemento está en el servidor pero no está en marcha.

Solución. Añade ensure cuxial_emotes_dlc encima de ensure cuxial_emotes en server.cfg. Hasta entonces, las zonas y las relaciones quedan apagadas.

Errores de base de datos en la consola al arrancar

Causa. oxmysql no está conectado, o el usuario de la base de datos no puede crear tablas.

Solución. Revisa la cadena de conexión y los permisos del usuario. Como alternativa, crea las tablas a mano con install/emotes.sql.

Menú

El menú no se abre con F3

Causa. La tecla se guarda por jugador, así que quien tenga otra asignación conserva la suya. El menú tampoco se abre mientras el jugador está muerto o bloqueado por otro recurso mediante SetEmoteLock.

Solución. Reasígnala en los ajustes de GTA, en la asignación de teclas de FiveM («Abrir Menú de Animaciones»).

El menú se abre en blanco o no aparece

Causa. Faltan los archivos de la interfaz. El recurso carga web/dist/index.html.

Solución. Comprueba que web/dist existe y tiene archivos. Si está vacía o incompleta, vuelve a copiar el recurso desde el paquete original.

He cambiado una tecla en el config y no cambia nada

Causa. keys solo fija el valor por defecto para los jugadores que nunca han entrado con el recurso. FiveM recuerda la tecla de cada jugador.

Solución. Cada jugador la cambia en sus ajustes de GTA. No renombres commands.menu.name para forzarlo: eso reinicia la tecla a todos.

Un emote o una categoría nuevos no aparecen en el menú

Causa. El archivo de la categoría no está en data/manifest.lua, o el archivo tiene un error de Lua.

Solución. Añade el nombre del archivo a categories, mira si la consola muestra errores de Lua y reinicia el recurso.

Un emote no sale marcado como nuevo

Causa. Falta el campo Added, no tiene el formato 'AAAA-MM-DD' o es más antiguo que ui.newEmoteDays.

Solución. Corrige la fecha o sube ui.newEmoteDays.

Emotes

Un emote no hace nada

Causa. Se da alguno de estos casos:

• el jugador está muerto y deadCheck.enabled es true;
• el jugador está en un vehículo y emotes.disableInCar es true;
• han pasado menos de commands.emote.cooldown milisegundos desde el último emote;
• otro recurso ha bloqueado al jugador con SetEmoteLock, o ha impedido los emotes con SetCanPlayAnimation(false) o con el estado isLimited.

Solución. Comprueba cuál es tu caso. Si otro recurso puso un bloqueo y no lo liberó, reinicia ese recurso.

Un emote propio no se reproduce, pero el menú lo muestra

Causa. El diccionario de animación no se está cargando, Dictionary y Animation están intercambiados, u otro emote ya usa el mismo Command.

Solución. Pon el archivo .ycd en la carpeta stream/ del recurso y reinicia el servidor. El diccionario es el nombre del .ycd; la animación es el clip que lleva dentro. Asegúrate de que el Command es único.

Falta un prop o los demás jugadores no lo ven

Causa. El modelo del prop no se está cargando, o el emote tiene más props que emotes.maxProps.

Solución. Revisa el nombre del modelo en Options.Props y sube emotes.maxProps si el emote necesita más.

Los jugadores muertos pueden usar emotes

Causa. deadCheck.useStateBag es true, pero tu script médico no pone el estado dead en el jugador.

Solución. Pon deadCheck.useStateBag = false para que el script pregunte al juego.

El estilo de caminar o la expresión se pierden al reconectar

Causa. La opción correspondiente de saving está en false.

Solución. Pon saving.walkStyle y saving.expression en true.

Agacharse se comporta raro o se activa dos veces

Causa. Otro recurso también gestiona el agachado con la misma tecla.

Solución. Desactiva el agachado en el otro recurso, o que los jugadores reasignen una de las dos teclas.

Emotes en pareja

«No hay nadie cerca»

Causa. No hay ningún jugador dentro de sync.distance, o el emote no tiene un Options.Shared.OtherEmote válido.

Solución. Acércate o sube sync.distance. En un emote propio, comprueba que OtherEmote apunta a un comando que existe.

«Ese jugador ya tiene una solicitud pendiente»

Causa. El otro jugador tiene una solicitud sin responder.

Solución. Espera a que responda, o a que caduque pasado sync.pendingMs.

Los dos personajes quedan descolocados

Causa. Los desplazamientos de ese emote en pareja no son correctos.

Solución. Ejecuta /syncpos <emisor> [receptor] y ajusta la posición. El comando copia un bloque Shared = { ... }: pégalo en el Options del emote, en lugar del anterior.

Zonas y staff

/emotezones no hace nada

Causa. Falta alguna de estas cosas:

• el jugador no está en el grupo ACE indicado en commands.zones.restricted;
• el jugador no tiene el permiso de cuxial_bridge indicado en admin.permission;
• el complemento cuxial_emotes_dlc no está iniciado.

Solución. Concede el grupo y el permiso, e inicia el complemento antes que Cuxial Emotes.

Los emotes de zona salen en todas partes, o nunca

Causa. zones.global está en true (en todas partes), o la zona está desactivada o no tiene emotes asignados (nunca).

Solución. Pon zones.global = false y revisa la zona en /emotezones.

Reportes y relaciones

Los reportes no llegan a Discord

Causa. La convar del webhook está vacía o tiene un nombre distinto al de report.convar.

Solución. Añádela a server.cfg y reinicia el servidor. Los reportes se guardan en cuxial_emote_reports en cualquier caso.

set cuxial_emotes:report_webhook "https://discord.com/api/webhooks/..."

Los ítems de relaciones no hacen nada al usarlos

Causa. El complemento cuxial_emotes_dlc no está iniciado. Sin él, los exports de los ítems existen solo para que el inventario no dé error.

Solución. Inicia el complemento antes que Cuxial Emotes. Los tests necesitan además que el recurso opcional cuxial_diseases esté en marcha. Sin él no hacen nada.

Crasheos

Los jugadores crashean al abrir el menú o al hacer emotes

Causa. El juego se ha quedado sin huecos para animaciones o props. Pasa sobre todo con muchos mapeos, vehículos y ropa a la vez.

Solución. Añade las líneas increase_pool_size del paso «Amplía los límites del motor» de la Instalación al principio de server.cfg y reinicia el servidor entero.