Troubleshooting

description: Resolve common database, vehicle delivery, framework, and permission issues.

Troubleshooting

"La base de datos todavía no está lista"

{% hint style="warning" %} El resource intentó procesar un reclamo o un reset antes de que oxmysql terminara de conectarse, o oxmysql no está iniciado. {% endhint %}

Solución:

1. Confirma que ensure oxmysql está antes de ensure yei-starterpack en el server.cfg.
2. Revisa que las credenciales de tu base de datos en oxmysql sean correctas.
3. Espera unos segundos tras el arranque del server — el resource crea la tabla automáticamente.

El NPC no aparece

• Verifica que NPC.enabled esté en true.
• Revisa que las coords correspondan a un punto válido del mapa.
• Chequea la consola del cliente (F8) por errores de carga de modelo.

El menú no abre al interactuar

• Confirma que ox_target/qb-target está iniciado antes que yei-starterpack.
• Si no usas ninguno: el fallback nativo requiere estar dentro del interactionRange configurado.
• Revisa la consola del navegador NUI (F8) por errores de index.html/app.js.

El jugador no recibe el vehículo en su garage

• Confirma que GiveVehicleInDatabase esté en true.
• Verifica que el framework se detectó correctamente (mensaje de consola al iniciar).
• En ESX, confirma que la tabla owned_vehicles existe con la estructura estándar.

El comando /resetstarterpack no funciona

• Confirma el ACE: add_ace group.admin yei-starterpack.admin allow.
• Si el jugador está offline, pasa el identifier completo (license:...).
• Desde la consola del servidor no se requiere ACE.

Los logs de Discord no llegan

{% hint style="info" %} Verifica que Logs.enabled = true y que Logs.webhookURL no esté vacío — si está vacío, no se envía nada aunque esté habilitado. {% endhint %}

Los ítems de recompensa no llegan

• Confirma que los name en Rewards.items existen exactamente igual en tu sistema de inventario.
• Si usas ox_inventory, revisa que esté started antes que yei-starterpack.

Un jugador dice que "ya reclamó" pero nunca lo hizo

• Es probable que su identifier ya exista en la tabla yei_starterpack_claims de una prueba anterior.
• Usa /resetstarterpack [identifier] para limpiar ese registro puntual.

¿Sigues con problemas?

{% hint style="success" %} Contacta soporte de Yei Studios con: el mensaje de consola exacto, tu config.lua (sin datos sensibles como el webhook), y el framework/versión que estás usando. {% endhint %}