Crear Mute - Raul125/PanelWiki GitHub Wiki

🔇 Crear Mute

El sistema de silenciamientos (mutes) de NeonCommunity permite a los moderadores restringir las capacidades de comunicación de jugadores problemáticos. Los mutes pueden ser globales (todos los canales) o específicos del intercomunicador, con duración personalizable.


🌐 Acceso a Crear Mute

📍 Formas de Acceder

  • Menú lateral de staff → "Gestor de Muteos" → Pestaña "Nuevo Muteo"
  • URL directa: https://panel.neoncommunity.eu/scpsl/mute-manager
  • Desde perfil de jugador → Botón "Silenciar" en perfil SCP:SL
  • Desde reportes → Acción directa para casos de spam/toxicidad

🔐 Requisitos

  • Rol de Staff en Discord
  • Permisos de moderación asignados
  • Autenticación activa en el panel
  • Conocimiento de las normas de comunicación

📊 Dashboard de Muteos

📈 Métricas en Tiempo Real

Antes de crear un silenciamiento, puedes ver el estado actual del sistema:

🔇 Muteos Totales

  • Contador histórico → Número total de silenciamientos aplicados
  • Avatar rojo → Ícono de VolumeOff para identificación
  • Datos acumulados → Desde el inicio del sistema

📅 Muteos Este Mes

  • Filtro mensual → Solo muteos del período actual
  • Avatar azul → Indicador de período temporal
  • Comparativa → Tendencia mensual

👥 Usuarios Muteados

  • Usuarios únicos → Número de jugadores diferentes silenciados
  • Sin duplicados → Cuenta cada usuario solo una vez
  • Avatar azul → Métrica de alcance del sistema

🗂️ Pestañas del Sistema

📋 Pestaña: Muteos Activos

Vista de todos los silenciamientos vigentes con herramientas de gestión.

📊 Pestaña: Estadísticas

Gráficos y métricas de actividad de silenciamientos.

🕐 Pestaña: Historial

Registro completo de todos los muteos (activos y expirados).

➕ Pestaña: Nuevo Muteo

Sistema de pasos (Stepper) para crear silenciamientos:


🎯 Paso 1: Selección de Jugador

🔍 Búsqueda de Usuario

🎯 Autocompletado Específico

  • Búsqueda en tiempo real → Resultados mientras escribes
  • Criterios de búsqueda:
    • Nombre en el juego SCP:SL
    • ID del jugador en el sistema
    • ID del usuario del panel
  • Límite optimizado → 10 usuarios para rendimiento
  • Template visual:
    • Avatar del usuario (Discord) o inicial
    • Nombre completo visible
    • ID para identificación precisa

➕ Gestión de Selección

  • Botón agregar → Ícono PersonAdd junto al autocompletado
  • Validación automática → Evita duplicados en lista
  • Feedback inmediato → Notificaciones de éxito/advertencia
  • Soporte múltiple → Puede seleccionar varios usuarios

👥 Lista de Jugadores Seleccionados

📊 Información Detallada

Tabla completa con datos contextuales:

Columnas disponibles:

  • Avatar → Imagen de Discord o inicial estilizada
  • Nombre → Con highlighting de texto buscado
  • ID único → Chip oscuro con identificador
  • Conexiones históricas:
    • Primera conexión → Fecha de registro inicial
    • Última conexión → Actividad más reciente
  • Estado operativo:
    • Normal → Verde con checkmark
    • DNT Activo → Rojo con escudo (DoNotTrack)

🛠️ Acciones Disponibles

  • Eliminar → Quitar usuario específico de la lista
  • Limpiar selección → Botón para vaciar toda la lista

📋 Estados de la Lista

📝 Lista Vacía

  • Mensaje instructivo → Con ícono de búsqueda de personas
  • Texto explicativo → "Utiliza el buscador para añadir jugadores a mutear"
  • Diseño centrado → Visualmente claro

👥 Con Usuarios

  • Contador dinámico → "Jugadores seleccionados (X)"
  • Tabla funcional → Información completa visible
  • Gestión flexible → Agregar/quitar usuarios fácilmente

⚙️ Paso 2: Configuración del Muteo

🎯 Tipo de Silenciamiento

🎨 Selección Visual

Dos tarjetas interactivas clickeables:

🔴 Muteo Global

  • Avatar rojo → Ícono de bloqueo total
  • Descripción → "Bloqueo de todos los canales de comunicación"
  • Alcance → Chat de texto, voz, intercomunicador
  • Borde destacado → Cuando está seleccionado

🟣 Muteo Intercom

  • Avatar morado → Ícono de micrófono
  • Descripción → "Restricción del uso del sistema de intercom"
  • Alcance → Solo el sistema de anuncios del juego
  • Más específico → Para infracciones menores

🚨 Alertas Informativas

Feedback visual según selección:

  • Global seleccionado → Alerta roja "Afecta a todos los canales"
  • Intercom seleccionado → Alerta azul "Solo sistema de Intercom"
  • Ninguno seleccionado → Alerta amarilla "Debes seleccionar un tipo"

⏱️ Configuración de Duración

🕐 Campos Numéricos

Tres campos separados para precisión:

📅 Días

  • Rango: 0-365 días
  • Ícono: Calendario
  • Para: Sanciones largas

⏰ Horas

  • Rango: 0-23 horas
  • Ícono: Reloj de arena
  • Para: Ajuste fino

⏱️ Minutos

  • Rango: 0-59 minutos
  • Ícono: Timer
  • Por defecto: 30 minutos
  • Para: Sanciones cortas

📊 Validación y Cálculo

Sistema inteligente de duración:

  • Cálculo automático → Suma total en tiempo real
  • Validación → Debe ser mayor a 0 minutos
  • Formato inteligente → "Xd Yh Zm" según magnitud
  • Alerta informativa → Muestra duración total calculada

📝 Motivo del Silenciamiento

✏️ Campo de Texto Avanzado

Características del formulario:

  • Hasta 150 caracteres → Con contador visual
  • 4 líneas de altura → Espacio cómodo para redacción
  • Validación obligatoria → Campo requerido
  • Placeholder descriptivo → "Detalla el motivo del muteo"

💡 Información Contextual

  • Helper text → "Explica claramente el motivo para facilitar revisiones futuras"
  • Label claro → "Motivo del Muteo"
  • Avatar informativo → Ícono de información neutral

✅ Paso 3: Confirmar y Aplicar

📋 Resumen Completo del Muteo

👥 Información de Jugadores

Visualización organizada:

  • Chips individuales → Hasta 5 usuarios mostrados
  • Diseño consistente → Borde redondeado con ícono
  • Contador adicional → "+X más" si hay más de 5
  • Color primario → Azul para identificación

🎯 Tipo de Muteo

Badges con indicadores visuales:

  • Global → Badge rojo con punto indicador y ícono de bloqueo
  • Intercom → Badge morado con punto indicador y ícono de micrófono
  • Diseño destacado → Fácil identificación del alcance

⏱️ Duración del Silenciamiento

Información temporal:

  • Ícono de timer → Representación visual clara
  • Duración formateada → "Xd Yh Zm" según configuración
  • Texto destacado → Duración en negrita para claridad

📝 Motivo Destacado

Presentación del motivo:

  • Sección separada → Con título descriptivo
  • Área resaltada → Fondo gris claro
  • Texto completo → Sin truncamiento
  • Espaciado optimizado → Legibilidad mejorada

⚠️ Advertencia Final

🚨 Alerta de Confirmación

Mensaje crítico con información específica:

  • Tipo específico → "muteo global" o "muteo de intercom"
  • Número exacto → "X jugador(es)" dinámico
  • Permanencia → "Esta acción queda registrada"
  • Irreversibilidad → "no puede revertirse fácilmente"
  • Gradiente visual → Fondo amarillo con degradado

🎉 Confirmación de Éxito

✅ Pantalla de Completado

Al aplicar correctamente:

  • Ícono de éxito → Checkmark verde prominente
  • Mensaje específico → "¡Muteo aplicado correctamente!"
  • Descripción → "La restricción de comunicación ha sido registrada"
  • Instrucciones → "Pulsa 'Reiniciar' para realizar otro muteo"
  • Reset automático → Formulario limpio para siguiente uso

🤖 Sistema de Automatización

🔧 MuteManager - Sistema Inteligente

🔄 Proceso Automatizado

1. Validar usuario, tipo, duración y motivo
2. Calcular fecha de expiración exacta
3. Crear registro en base de datos
4. Aplicar restricción al usuario
5. Generar log de auditoría
6. Notificar resultado al moderador

🛡️ Validaciones Avanzadas

  • Usuario válido → Verificación en base de datos
  • Tipo seleccionado → Global o Intercom obligatorio
  • Duración válida → Mayor a 0 minutos
  • Motivo presente → Campo obligatorio no vacío
  • Permisos staff → Autorización de moderador

📞 Sistema de Notificaciones

📊 Feedback Específico

Notificaciones detalladas:

  • Éxito múltiple → "Se aplicaron X muteos correctamente"
  • Errores individuales → "Error al mutear a [nombre]: [razón]"
  • Resumen final → Conteo de éxitos vs. fallos
  • Estados dinámicos → Procesando, completado, error

🔄 Gestión de Estados

  • Procesando → Indicador visual durante aplicación
  • Completado → Confirmación con detalles
  • Error → Mensaje específico del problema
  • Reinicio → Limpieza automática del formulario

📝 Logs Detallados de Auditoría

🔍 Registro Completo

Cada muteo genera automáticamente:

  • ID del muteo → Identificador único
  • Staff responsable → Moderador que aplicó
  • Usuario silenciado → Datos completos del afectado
  • Tipo de muteo → Global o Intercom
  • Duración exacta → Tiempo en minutos
  • Fecha de aplicación → Timestamp preciso
  • Fecha de expiración → Cuándo se levanta automáticamente
  • Motivo completo → Razón detallada
  • Estados → Aplicado, editado, revocado

📊 Pestaña: Estadísticas

📈 Análisis Visual

📅 Muteos por Mes

  • Gráfico de barras → Últimos 6 meses de actividad
  • Datos históricos → Tendencias claras
  • Colores primarios → Azul para identificación
  • Actualización → Botón refresh para datos recientes

🥧 Distribución por Tipo

Gráfico circular:

  • Global vs Intercom → Proporción visual
  • Colores diferenciados → Rojo (Global), Morado (Intercom)
  • Datos exactos → Números precisos por tipo

👮 Actividad de Moderación

Tabla de rendimiento:

  • Staff member → Nombre e imagen
  • Total muteos → Número histórico
  • Este mes → Actividad reciente
  • Último muteo → Fecha y hora exactas
  • Ordenamiento → Por actividad descendente

🕐 Pestaña: Historial

📋 Registro Completo

🔍 Filtros Avanzados

  • Rango de fechas → DateRangePicker para período específico
  • Búsqueda de texto → Nombre, staff, motivo
  • Estado → Activos vs. expirados
  • Tipo → Global vs. Intercom

📊 Información Detallada

Columnas del historial:

  • ID → Identificador único
  • Usuario muteado → Avatar + nombre + enlace
  • Staff → Moderador responsable
  • Tipo → Global (rojo) o Intercom (morado)
  • Motivo → Razón completa (truncada con tooltip)
  • Duración → Tiempo original del muteo
  • Fecha → Cuándo se aplicó
  • Estado → Activo o Expirado

🛠️ Funciones de Gestión

📝 Editar Muteos Existentes

✏️ Modificación de Motivos

Desde la lista de muteos activos:

  • Botón "Editar" → En cada fila de la tabla
  • Diálogo específicoEditMuteReasonDialog
  • Cambio de motivo → Actualizar razón del silenciamiento
  • Justificación → Motivo del cambio requerido
  • Log automático → Registra modificaciones

🔊 Levantar Muteos

🗑️ Proceso de Revocación

Eliminar silenciamientos:

  • Botón "Retirar Muteo" → Ícono VolumeUp (verde)
  • Diálogo de confirmaciónDeleteMuteDialog
  • Razón requerida → Motivo de la revocación
  • Confirmación segura → Evita eliminaciones accidentales
  • Log crítico → Registro especial de revocaciones

👁️ Visualización Detallada

🔍 Ver Muteo Completo

  • Botón "Ver Muteo" → En cada entrada de la lista
  • Página dedicada/scpsl/muteview/{id}
  • Información completa → Todos los detalles del muteo
  • Historial de cambios → Modificaciones realizadas
  • Tiempo restante → Countdown en tiempo real

🔧 Características Técnicas

📊 Gestión de Tiempo

⏱️ Cálculo de Expiración

  • Suma automática → Días + horas + minutos
  • Formato inteligente → Muestra según magnitud
  • Validación continua → Debe ser > 0 minutos
  • Tiempo restante → Cálculo en tiempo real

🕐 Estados de Muteo

  • ActivoExpiresOn > DateTime.UtcNow
  • ExpiradoExpiresOn <= DateTime.UtcNow
  • Revocado → Eliminado manualmente por staff

🔍 Búsqueda y Filtros

🎯 Búsqueda Inteligente

  • Múltiples campos → Nombre, staff, motivo
  • Búsqueda instantánea → Resultados en tiempo real
  • 300px de ancho → Espacio cómodo para escribir
  • Filtros por pestañas → Activos vs. historial

📅 Filtros Temporales

  • Rango de fechas → Para historial específico
  • Período configurable → Últimos 30 días por defecto
  • Aplicación automática → Al cerrar selector

💡 Consejos para Moderadores

🔇 Cuándo Usar Muteos

✅ Situaciones Apropiadas:

  • Spam en chat → Mensajes repetidos excesivos
  • Comportamiento tóxico → Insultos constantes
  • Abuso del intercom → Uso inapropiado del sistema
  • Comunicación disruptiva → Interrupciones constantes
  • Advertencias ignoradas → Después de warns sin efecto

🎯 Selección de Tipo:

  • Global → Para problemas de comunicación general
  • Intercom → Para abuso específico del sistema de anuncios
  • Duración → Según gravedad y reincidencia

📝 Redacción de Motivos Efectivos

✅ Ejemplos de Buenos Motivos:

  • "Spam en chat durante 10 minutos consecutivos, ignorando advertencias de staff"
  • "Insultos discriminatorios en chat de voz durante 3 rondas seguidas"
  • "Abuso del sistema de intercom con contenido inapropiado y música"
  • "Comunicación tóxica constante afectando la experiencia de otros jugadores"

❌ Ejemplos de Malos Motivos:

  • "Molestando"
  • "Spam"
  • "Comportamiento malo"
  • "Mute temporal"

⏱️ Duración Recomendada

📋 Escalado Sugerido:

  • Primera vez → 30 minutos - 1 hora
  • Reincidencia → 2-6 horas
  • Problema persistente → 12-24 horas
  • Casos graves → 1-3 días
  • Última oportunidad → 1 semana

🔗 Enlaces Relacionados


🔇 Silencia con Propósito, Modera con Criterio

¿Dudas sobre el sistema de muteos? Pregunta en el canal staff de [Discord](https://discord.neoncommunity.eu/) o consulta Panel de Moderación

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