Problemas Comunes - Raul125/PanelWiki GitHub Wiki

🚨 Problemas Comunes

Esta sección contiene las soluciones a los problemas más frecuentes que pueden surgir al usar el panel de NeonCommunity. Los problemas están organizados por categorías y incluyen pasos detallados para su resolución.


🔐 Problemas de Autenticación

❌ No Puedo Iniciar Sesión

🔍 Posibles Causas

  • Cuenta no vinculada → Primera vez usando el panel
  • Discord/Steam desconectado → Cuentas no disponibles
  • Cookies/Cache corruptos → Datos de navegador problemáticos
  • Servidor en mantenimiento → Servicios temporalmente no disponibles

✅ Soluciones

  1. Limpiar cache del navegador:

    • Ctrl + Shift + R para recarga forzada
    • Limpiar cookies de panel.neoncommunity.eu
    • Probar en modo incógnito
  2. Verificar cuentas externas:

    • Verificar que Discord esté funcionando
    • Comprobar que Steam esté online
    • Revisar si las cuentas están suspendidas
  3. Probar diferentes navegadores:

    • Chrome, Firefox, Edge
    • Desactivar extensiones temporalmente
    • Verificar JavaScript habilitado

🔄 Error "OAuth Failed"

🔍 Diagnóstico

  • Permisos de Discord → Aplicación no autorizada
  • Configuración incorrecta → Client ID/Secret inválidos
  • Rate limiting → Demasiados intentos

✅ Solución Paso a Paso

  1. Revocar permisos en Discord:

    • Ir a Discord → Configuración → Apps Autorizadas
    • Eliminar "NeonCommunity Panel"
    • Intentar login nuevamente
  2. Verificar conexión:

    • Comprobar que Discord funcione normalmente
    • Verificar conexión a internet estable
    • Reintentar en unos minutos

⚠️ Sesión Expirada Constantemente

🔍 Síntomas

  • Logout automático frecuente
  • Mensajes de "sesión inválida"
  • Redirección constante al login

✅ Pasos de Resolución

  1. Configuración del navegador:

    • Permitir cookies de terceros para el sitio
    • Añadir panel.neoncommunity.eu a sitios de confianza
    • Verificar configuración de privacidad
  2. Verificar fecha/hora del sistema:

    • Sincronizar reloj del sistema
    • Verificar zona horaria correcta
    • Reiniciar navegador tras cambios

🎮 Problemas del Servidor de Juego

❌ Mi Rol No Se Aplica en el Servidor

🔍 Posibles Causas

  • Plugin desconectado → Cliente Unity no funciona
  • Rol sin SlRole configurado → Mapeo incompleto
  • Sincronización pendiente → Cambios no propagados
  • Servidor reiniciando → Servicios temporalmente down

✅ Soluciones Detalladas

  1. Verificar configuración de rol:

    • Comprobar que tu rol tenga SlRole configurado
    • Verificar peso del rol apropiado
    • Contactar administrador si falta configuración
  2. Forzar sincronización:

    • Desconectar del servidor SCP:SL
    • Esperar 30 segundos
    • Reconectar al servidor
    • El rol debería aplicarse automáticamente
  3. Verificar estado del plugin:

    • Preguntar en Discord si otros tienen el problema
    • Verificar que el servidor esté en la lista de servidores
    • Reportar a staff si persiste

⚖️ Sanción No Se Refleja en el Juego

🔍 Diagnóstico

  • Ban aplicado desde panel → Pero puedo conectar
  • Mute no funciona → Puedo hablar normalmente
  • Kick no registrado → Historial no actualizado

✅ Proceso de Resolución

  1. Para Bans no efectivos:

    • Verificar que la sanción esté activa en tu perfil
    • Comprobar servidor correcto (Normal vs RolePlay)
    • Esperar hasta 5 minutos para sincronización
    • Contactar staff si persiste
  2. Para Mutes no funcionando:

    • Verificar tipo de mute (texto, voz, global)
    • Comprobar duración restante
    • Reintentar hablar tras reconectar
    • Reportar si el problema continúa

📊 Estadísticas No Se Actualizan

🔍 Síntomas Comunes

  • Tiempo de juego no aumenta
  • Estadísticas congeladas en perfil
  • Logros no se desbloquean

✅ Pasos de Corrección

  1. Verificar finalización de ronda:

    • Las estadísticas se envían al terminar cada ronda
    • Jugar hasta que termine la ronda completamente
    • Verificar actualización en el panel web
  2. Comprobar conexión estable:

    • Evitar desconexiones durante partidas
    • Verificar conexión a internet estable
    • No salir del servidor abruptamente

🌐 Problemas del Panel Web

🔄 La Página No Carga Correctamente

🔍 Síntomas

  • Página en blanco
  • Elementos faltantes
  • Errores de JavaScript
  • Carga infinita

✅ Soluciones Técnicas

  1. Problemas de cache:

    - Ctrl + Shift + R (recarga forzada)
    - Limpiar cache y cookies del sitio
    - Probar en modo incógnito
    - Reiniciar navegador completamente
    
  2. Problemas de red:

    • Verificar conexión a internet
    • Probar desde diferente red (móvil/wifi)
    • Desactivar VPN temporalmente
    • Verificar si otros sitios funcionan
  3. Problemas del navegador:

    • Actualizar navegador a última versión
    • Desactivar extensiones (AdBlock, etc.)
    • Probar navegador diferente
    • Verificar JavaScript habilitado

📱 Problemas en Móvil

🔍 Síntomas Específicos

  • Botones no responden
  • Texto muy pequeño
  • Elementos superpuestos
  • Navegación difícil

✅ Optimización Móvil

  1. Configuración del navegador móvil:

    • Activar "Sitio de escritorio" si es necesario
    • Rotar pantalla para mejor visualización
    • Ajustar zoom del navegador
  2. Aplicaciones recomendadas:

    • Chrome móvil (mejor compatibilidad)
    • Firefox móvil (alternativa)
    • Evitar navegadores integrados en apps

⚡ El Panel Va Muy Lento

🔍 Posibles Causas

  • Conexión lenta a internet
  • Muchas pestañas abiertas
  • Filtros complejos aplicados
  • Servidor sobrecargado

✅ Optimizaciones

  1. En tu dispositivo:

    • Cerrar pestañas innecesarias
    • Reiniciar navegador
    • Verificar RAM disponible
    • Cerrar otras aplicaciones
  2. En el panel:

    • Usar filtros específicos en lugar de "todos"
    • Reducir elementos por página en tablas
    • Evitar mantener múltiples secciones abiertas
    • Refrescar página periódicamente

👮 Problemas de Moderación

❌ No Puedo Aplicar Sanciones

🔍 Verificaciones Iniciales

  • Permisos insuficientes → Rol sin permisos necesarios
  • Usuario ya sancionado → Conflicto con sanción existente
  • Formulario incompleto → Campos obligatorios vacíos

✅ Lista de Verificación

  1. Revisar permisos:

    • Verificar que tu rol tenga permisos de moderación
    • Comprobar jerarquía (no puedes sancionar superiores)
    • Contactar administrador si necesitas más permisos
  2. Completar formulario correctamente:

    • Llenar todos los campos obligatorios
    • Verificar formato de duración correcto
    • Añadir razón descriptiva y específica
  3. Verificar estado del usuario:

    • Comprobar si ya tiene sanciones activas
    • Verificar que el usuario existe en el sistema
    • Confirmar servidor correcto seleccionado

📋 Los Reportes No Se Muestran

🔍 Posibles Problemas

  • Filtros muy restrictivos → No hay resultados
  • Permisos de visualización → Acceso limitado
  • Cache del navegador → Datos desactualizados

✅ Soluciones

  1. Ajustar filtros:

    • Limpiar todos los filtros activos
    • Seleccionar "Todos los servidores"
    • Ampliar rango de fechas
    • Cambiar a "Reportes Activos"
  2. Verificar permisos:

    • Confirmar acceso a gestión de reportes
    • Verificar rol de staff activo
    • Contactar administrador si necesario

⚖️ Historial de Sanciones Incompleto

🔍 Síntomas

  • Sanciones faltantes en historial
  • Fechas incorrectas
  • Información incompleta

✅ Resolución

  1. Verificar filtros de búsqueda:

    • Limpiar filtros de fecha
    • Incluir sanciones archivadas
    • Buscar en todos los servidores
  2. Reportar inconsistencias:

    • Documentar sanciones faltantes específicas
    • Proporcionar fechas aproximadas
    • Contactar administrador con detalles

💬 Problemas de Discord

🤖 El Bot No Responde

🔍 Diagnóstico Rápido

  • Bot offline en Discord
  • Permisos insuficientes
  • Comandos en canal incorrecto
  • Servidor de Discord con problemas

✅ Pasos de Resolución

  1. Verificar estado del bot:

    • Comprobar si aparece online en Discord
    • Verificar última actividad del bot
    • Preguntar a otros usuarios si funciona
  2. Verificar permisos:

    • Bot tiene permisos de lectura/escritura
    • Canal permite bots
    • Jerarquía de roles correcta

🔄 Roles de Discord No Sincroniza

🔍 Problemas Frecuentes

  • Rol no configurado en panel
  • Bot sin permisos suficientes
  • Usuario no en servidor Discord
  • Sincronización desactivada

✅ Solución Detallada

  1. Verificar configuración:

    • Tu rol tiene DiscordRoleId configurado
    • Estás en el servidor de Discord oficial
    • El bot está presente y activo
  2. Forzar sincronización:

    • Salir del servidor Discord temporalmente
    • Volver a unirse al servidor
    • Esperar hasta 10 minutos para sincronización
    • Contactar staff si persiste

🔧 Problemas Técnicos Generales

💾 Error "500 Internal Server Error"

🔍 Qué Significa

  • Error del servidor, no tu dispositivo
  • Problema temporal del sistema
  • Posible mantenimiento en curso

✅ Qué Hacer

  1. Soluciones inmediatas:

    • Esperar 5-10 minutos y reintentar
    • Refrescar página (F5)
    • Verificar página de estado del servicio
  2. Si persiste:

    • Reportar en Discord con detalles
    • Incluir qué acción causó el error
    • Especificar hora exacta del error

⚠️ Error "403 Forbidden"

🔍 Significado

  • No tienes permisos para esa acción
  • Tu sesión puede haber expirado
  • Intentas acceder a área restringida

✅ Solución

  1. Verificar permisos:

    • Comprobar tu rol actual
    • Verificar si la función requiere permisos especiales
    • Contactar administrador si crees que es error
  2. Renovar sesión:

    • Cerrar sesión completamente
    • Iniciar sesión nuevamente
    • Verificar que todos los datos se carguen

🌐 Error "404 Not Found"

🔍 Causas Comunes

  • URL incorrecta o modificada
  • Recurso eliminado o movido
  • Link obsoleto desde Discord/foro

✅ Resolución

  1. Verificar URL:

    • Comprobar que la dirección sea correcta
    • Navegar desde el menú principal
    • Usar enlaces oficiales únicamente
  2. Si el problema persiste:

    • Reportar link roto específico
    • Incluir desde dónde llegaste al error
    • Usar navegación del panel en su lugar

📞 Cuándo Contactar Soporte

🆘 Situaciones que Requieren Ayuda

🔴 Problemas Críticos

  • No puedes acceder al panel después de múltiples intentos
  • Sanciones aplicadas incorrectamente
  • Pérdida de datos importantes (estadísticas, historial)
  • Errores que afectan múltiples usuarios

🟡 Problemas Menores

  • Preguntas sobre funcionalidades
  • Solicitudes de cambios de configuración
  • Problemas cosméticos de interfaz
  • Sugerencias de mejora

📋 Información a Proporcionar

📊 Datos Esenciales

  • Tu nombre de usuario y rol actual
  • Descripción detallada del problema
  • Pasos exactos que llevaron al error
  • Hora aproximada cuando ocurrió
  • Navegador y dispositivo utilizado
  • Capturas de pantalla si es relevante

🔍 Para Problemas Técnicos

  • Mensaje de error exacto (copy-paste)
  • URL de la página donde ocurrió
  • Qué estabas intentando hacer
  • Si otros usuarios reportan lo mismo

🔗 Enlaces de Ayuda

💬 Canales de Soporte

📚 Recursos Adicionales


🚨 La Mayoría de Problemas Tienen Solución Simple

¿No encuentras tu problema aquí? Consulta FAQ o pregunta en [Discord](https://discord.neoncommunity.eu/)

⚠️ **GitHub.com Fallback** ⚠️