Errores de generación

Errores habituales durante la generación de items y cómo resolverlos.

1. Límite del plan gratuito alcanzado

Error: FREE_TIER_LIMIT o «Te has quedado sin tokens gratuitos»

Causa: has llegado al límite diario de generación de las cuentas gratuitas (12 generaciones al día).

Solución:

• Espera al día siguiente (los límites se reinician a medianoche UTC)
• Pásate a Pro para tener generaciones ilimitadas

2. Límite diario de items alcanzado

Error: DAILY_ITEM_LIMIT_REACHED

Causa: has gastado todos tus tokens diarios de generación o de conversión.

Solución:

• La generación y la conversión tienen cupos separados (12 de cada uno en el plan gratuito)
• Comprueba cuál de los dos has agotado
• Espera a mañana o mejora tu plan

3. Faltan campos obligatorios

Error: «Completa todos los campos obligatorios antes de enviar»

Causa: uno o más campos obligatorios del formulario están vacíos.

Solución:

• Comprueba que has rellenado el nombre del proyecto y el namespace, y que has elegido al menos un plugin
• Según el tipo de item, asegúrate de haber subido los archivos necesarios:
  • Sprites: al menos una textura PNG
  • Items 3D: un archivo JSON de modelo + las texturas
  • Armaduras: los archivos de textura de cada pieza que hayas elegido
• Busca los campos resaltados en rojo en el formulario

4. La generación por lotes no está disponible

Error: BATCH_NOT_AVAILABLE

Causa: la generación por lotes (generar varios items a la vez) es una función solo de Pro.

Solución:

• Genera los items de uno en uno con el modo individual, o
• Pásate a Pro para acceder a la generación por lotes

5. Archivo demasiado grande

Error: «El archivo es demasiado grande. El tamaño máximo es 10 MB»

Causa: uno de los archivos subidos pasa del límite de 10 MB.

Solución:

• Reduce el tamaño del archivo bajando la resolución de la textura
• En los modelos, simplifica la geometría para reducir el tamaño del JSON
• Tamaño máximo de textura recomendado: 128x128 píxeles

6. Tipo de archivo no admitido

Error: «Tipo de archivo no admitido»

Causa: has subido un formato de archivo que no se acepta.

Solución:

• Texturas: solo archivos .png (ni .jpg, ni .gif, ni .webp)
• Modelos: archivos .json
• Entrada del conversor: archivos .yml o .yaml

7. Límite de peticiones

Error: RATE_LIMITED o «Demasiadas peticiones»

Causa: estás enviando peticiones demasiado rápido.

Solución:

• Espera unos segundos antes de volver a intentarlo
• No hagas clic muchas veces seguidas en el botón de generar

8. Error del servidor (500)

Error: «Error del servidor. Inténtalo de nuevo más tarde.»

Causa: ha ocurrido un error inesperado en el backend.

Solución:

1. Espera un momento y vuelve a intentarlo
2. Si el error persiste, prueba con una configuración más simple (menos plugins, menos items)
3. Comprueba que tus archivos de entrada no estén corruptos
4. Cuéntanoslo en Discord  con los detalles de lo que estabas generando