Solución de Problemas (Troubleshooting) 🔧

Aquí encontrarás soluciones a los errores más comunes que pueden surgir al usar o desplegar Tiger Platform.

Errores del Bot

Error 50013: Missing Permissions

Este error ocurre comúnmente al intentar configurar el Voice Hub.

Causa: El bot intenta crear canales o categorías pero no tiene los permisos necesarios en el servidor.

Solución:

1. Asegúrate de que el rol del bot tenga el permiso de Administrator (recomendado para full setup).
2. Si no quieres dar admin, asegúrate de que tenga:
   • Manage Channels (Gestionar Canales)
   • Manage Roles (Gestionar Roles)
   • View Channel (Ver Canales)
   • Connect (Conectar)
3. Verifica que el rol del bot esté por encima de los roles de los usuarios que intenta gestionar en la jerarquía de roles de Discord.

Errores de Despliegue (Railway)

Fallo en el Build o Railpack

El despliegue falla y Railway no puede iniciar la aplicación.

Causa: En entornos monorepo, Railway a veces tiene dificultades para detectar automáticamente el entorno de ejecución de Node.js o faltan librerías del sistema necesarias para paquetes gráficos como @napi-rs/canvas.

Solución:

1. Root Directory: Asegúrate de configurar correctamente el directorio raíz (e.g., /bot o /web) en las configuraciones del servicio en Railway.
2. Dockerfile Personalizado: Si usas librerías nativas como Canvas, evita usar el Nixpack por defecto y utiliza un Dockerfile que instale las dependencias necesarias:

FROM node:18-bullseye-slim
RUN apt-get update && apt-get install -y build-essential libcairo2-dev libpango1.0-dev
# ... resto de tu configuración