Guías y Referencias

Bienvenido a MushhX Plugins

MushhX Plugins es una colección de herramientas premium diseñadas para administradores de servidores Minecraft que buscan rendimiento, estabilidad y facilidad de uso.

Características principales

• Alto rendimiento: Código optimizado para servidores con cientos de jugadores.
• Configuración flexible: Archivos YAML bien documentados con opciones granulares.
• Actualizaciones frecuentes: Soporte activo y compatibilidad con nuevas versiones.
• Open Source: Código disponible en GitHub para auditoría y contribuciones.

Instalación General

La instalación de cualquier plugin de MushhX sigue el mismo proceso estándar:

Requisitos previos

• Servidor Paper/Spigot 1.13 o superior
• Java 17 o superior
• Acceso FTP/SFTP o panel de control del servidor

Pasos de instalación

1. Descarga: Ve a la página del plugin y descarga el archivo .jar.
2. Sube el archivo: Colócalo en la carpeta plugins/ de tu servidor.
3. Reinicia: Reinicia completamente el servidor (no uses /reload).
4. Configura: Edita los archivos en plugins/[NombrePlugin]/.
5. Aplica: Usa el comando de recarga del plugin o reinicia.

Sistema de detección de hacks avanzado para proteger tu servidor de cheaters, exploits y jugadores deshonestos. MushhXel ofrece más de 20 detecciones configurables con mínimo impacto en el rendimiento.

Características principales

• +20 detecciones: Fly, Speed, KillAura, Reach, Phase, y muchas más
• Bajo impacto: Detección asíncrona, menos del 1% de impacto en TPS
• Configurable: Cada detección tiene su propia sensibilidad y acciones
• Alertas en tiempo real: Notificaciones al staff con detalles del hack
• Sistema de violaciones: Acumula antes de sancionar para evitar falsos positivos
• Acciones personalizables: Alertar, kickear, banear, ejecutar comandos

🛡️ Detecciones de MushhXel

Lista completa de hacks y cheats que MushhXel puede detectar:

🛡️ Configuración de MushhXel

Archivo de configuración principal: plugins/MushhXel/config.yml

Estructura de archivos

plugins/MushhXel/
├── config.yml       # Configuración principal
├── messages.yml     # Mensajes personalizables
├── detections.yml   # Configuración por detección
└── data/
    └── violations/  # Datos de violaciones

Configuración general

# config.yml
settings:
  prefix: "&8[&c⛨&8] &7"
  debug: false
  check-updates: true

alerts:
  enabled: true
  permission: "mushhxel.alerts"
  format: "&c%player% &7detectado: &e%hack% &8(x%count%)"
  cooldown: 2000  # ms entre alertas del mismo tipo

violations:
  decay-time: 60  # segundos para reducir violaciones
  decay-amount: 1 # cuántas reducir

Configuración de detecciones

# detections.yml
fly:
  enabled: true
  sensitivity: "normal"  # low, normal, high, strict
  max-violations: 10
  actions:
    5: "alert"
    10: "kick %player% &cFly detectado"

killaura:
  enabled: true
  sensitivity: "normal"
  max-angle: 90           # ángulo máximo de ataque
  max-targets-per-tick: 1 # entidades por tick
  max-violations: 15
  actions:
    10: "alert"
    15: "tempban %player% 1h &cKillAura"

speed:
  enabled: true
  max-speed: 0.7          # bloques por tick
  ignore-potions: true    # ignorar efectos de velocidad
  max-violations: 8
  actions:
    8: "kick %player% &cSpeed detectado"

Niveles de sensibilidad

🛡️ Comandos de MushhXel

Comando principal: /mushhxel (alias: /mxl)

🛡️ Permisos de MushhXel

Permisos de administración

mushhxel.admin              # Acceso completo a todo
mushhxel.alerts             # Recibir alertas de detecciones
mushhxel.command.*          # Todos los comandos
mushhxel.command.reload     # Usar /mxl reload
mushhxel.command.info       # Ver info de jugadores
mushhxel.command.reset      # Resetear violaciones
mushhxel.command.toggle     # Activar/desactivar checks
mushhxel.command.exempt     # Eximir jugadores

Permisos de bypass (exención)

mushhxel.bypass             # Bypass de TODAS las detecciones
mushhxel.bypass.fly         # Bypass solo de Fly
mushhxel.bypass.speed       # Bypass solo de Speed
mushhxel.bypass.killaura    # Bypass solo de KillAura
mushhxel.bypass.reach       # Bypass solo de Reach
# ... etc para cada detección

🛡️ API de MushhXel

API para desarrolladores que quieran integrar MushhXel con otros plugins.

Dependencia Maven/Gradle

// build.gradle
repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    compileOnly 'com.github.MushhDev:MushhXel:2.0.2.5'
}

Obtener la API

import dev.mushh.mushhxel.api.MushhXelAPI;

MushhXelAPI api = MushhXel.getAPI();

// Obtener violaciones de un jugador
int flyViolations = api.getViolations(player, "fly");
int totalViolations = api.getTotalViolations(player);

// Resetear violaciones
api.resetViolations(player);
api.resetViolations(player, "fly"); // Solo fly

// Eximir temporalmente
api.exemptPlayer(player, 60); // 60 segundos
api.unexemptPlayer(player);

Eventos

// Escuchar detecciones
@EventHandler
public void onHackDetect(HackDetectEvent event) {
    Player player = event.getPlayer();
    String hackType = event.getHackType();
    int violations = event.getViolations();
    
    // Cancelar la detección (evitar acciones)
    if (miCondicion) {
        event.setCancelled(true);
    }
}

// Escuchar cuando se ejecuta una acción
@EventHandler
public void onPunishment(HackPunishEvent event) {
    String action = event.getAction(); // "kick", "ban", etc
}

Sistema avanzado de rollback de inventarios que permite a los administradores restaurar el progreso de jugadores con precisión y seguridad. Ideal para recuperar items perdidos por bugs, muertes injustas o errores del servidor.

Características principales

• Captura automática: Guarda el estado del jugador en muertes, desconexiones, cambios de mundo
• Historial completo: Navegación cronológica por snapshots
• Restauración flexible: Completa o parcial (solo armadura, solo items, solo XP)
• Vista previa: Ver el contenido antes de restaurar
• Anti-duplicación: Protección contra exploits de duplicación
• NBT completo: Soporta items personalizados, encantamientos, etc.
• Multi-servidor: Compatible con BungeeCord/Velocity

🔄 Uso de RewindCore

Flujo básico de restauración

1. Un jugador pierde su inventario (muerte, bug, etc.)
2. El staff usa /rewind <jugador> para abrir el historial
3. Navega por los snapshots y selecciona el correcto
4. Usa vista previa para confirmar que es el inventario correcto
5. Confirma la restauración

Eventos que captura

Datos que almacena cada snapshot

• Inventario completo (36 slots)
• Armadura (4 slots)
• Offhand
• Nivel de experiencia y puntos
• Efectos de poción activos
• Vida y comida
• Ubicación (mundo, x, y, z)
• Timestamp y razón de captura

🔄 Configuración de RewindCore

Estructura de archivos

plugins/RewindCore/
├── config.yml       # Configuración principal
├── messages.yml     # Mensajes personalizables
└── data/
    ├── snapshots.db # Base de datos SQLite
    └── backups/     # Backups automáticos

Configuración principal

# config.yml
capture:
  on-death: true
  on-disconnect: true
  on-world-change: true
  on-teleport: false      # Puede generar muchos datos
  
storage:
  type: "sqlite"          # sqlite, mysql
  max-snapshots-per-player: 50
  auto-purge:
    enabled: true
    days: 30              # Borrar snapshots más antiguos
  
  # Solo si type: mysql
  mysql:
    host: "localhost"
    port: 3306
    database: "rewindcore"
    username: "user"
    password: "pass"

security:
  require-confirmation: true
  log-restorations: true
  prevent-duplication: true
  
gui:
  rows: 6
  items-per-page: 45

Mensajes personalizables

# messages.yml
prefix: "&8[&b↺&8] &7"

snapshot-created: "&aSnapshot creado para &e%player%"
restored: "&aInventario restaurado correctamente"
no-snapshots: "&cNo hay snapshots para este jugador"
confirm-restore: "&e¿Confirmar restauración? &7Escribe &a/rewind confirm"

🔄 Comandos de RewindCore

Comando principal: /rewind (alias: /rw, /rollback)

Ejemplos de uso

# Abrir historial de un jugador
/rewind Notch

# Restaurar el snapshot #5 de un jugador
/rewind restore Notch 5

# Buscar snapshots de hace 2 días
/rewind search Notch 2d

# Crear backup manual antes de un evento
/rewind save Notch

🔄 Permisos de RewindCore

Permisos de uso

rewindcore.admin           # Acceso completo
rewindcore.use             # Abrir GUI de historial
rewindcore.restore         # Restaurar inventarios de otros
rewindcore.restore.self    # Restaurar su propio inventario
rewindcore.preview         # Ver snapshots sin restaurar
rewindcore.save            # Crear snapshots manuales
rewindcore.search          # Buscar por fecha
rewindcore.list            # Listar snapshots
rewindcore.purge           # Eliminar datos antiguos

Configuración recomendada para LuckPerms

# Admin
/lp group admin permission set rewindcore.admin true

# Moderador
/lp group mod permission set rewindcore.use true
/lp group mod permission set rewindcore.restore true
/lp group mod permission set rewindcore.preview true

# Helper
/lp group helper permission set rewindcore.use true
/lp group helper permission set rewindcore.preview true

Preguntas Frecuentes

¿Los plugins son gratuitos?

Sí, todos los plugins de MushhX son completamente gratuitos. Puedes usarlos en cualquier servidor, ya sea personal o comercial, sin ninguna restricción ni coste.

¿Funcionan con Velocity/BungeeCord?

Los plugins están diseñados para servidores individuales (Paper/Spigot). Si tienes una red con múltiples servidores, debes instalar el plugin en cada servidor backend donde lo necesites. No se requiere ningún plugin adicional en el proxy.

¿Cómo reporto un bug?

Tienes varias opciones para reportar bugs:

• Abre un issue en el repositorio de GitHub del plugin correspondiente
• Envía un correo a mushhdev@gmail.com con los detalles
• Incluye: versión del plugin, versión de Minecraft/Paper, logs de error y pasos para reproducir

¿Hay falsos positivos en el anticheat?

MushhXel está diseñado para minimizar falsos positivos al máximo. Sin embargo, pueden ocurrir en situaciones de lag extremo, conexiones inestables o con ciertos mods del cliente. Si experimentas falsos positivos frecuentes:

• Verifica que tu servidor tenga un TPS estable (>18)
• Ajusta la sensibilidad de las detecciones en el config
• Aumenta el umbral de violaciones antes de aplicar sanciones
• Usa el modo "alert" primero para monitorear antes de banear

¿Puedo modificar el código fuente?

Sí, todos los plugins son open source bajo licencia MIT. Puedes modificar, distribuir y usar el código como quieras. Solo te pedimos que mantengas los créditos originales y, si haces mejoras significativas, considera contribuir de vuelta al proyecto.

¿Con qué versiones de Minecraft son compatibles?

Todos los plugins soportan Minecraft 1.13 hasta la última versión estable. Usamos la API de Bukkit/Spigot para máxima compatibilidad. Generalmente, las nuevas versiones de Minecraft son soportadas en los primeros días tras su lanzamiento.

¿Cómo actualizo un plugin?

Actualizar es simple:

1. Descarga la nueva versión del .jar
2. Para el servidor
3. Reemplaza el archivo .jar antiguo con el nuevo
4. Inicia el servidor

Los archivos de configuración se mantienen y se actualizan automáticamente con nuevas opciones.

¿Los plugins afectan el rendimiento?

Todos los plugins están optimizados para el mínimo impacto en el rendimiento. MushhXel, por ejemplo, usa detección asíncrona y caching inteligente. En servidores con 200+ jugadores, el impacto es inferior al 1% del tiempo de tick.

Soporte y Contacto

Estamos aquí para ayudarte. Elige el canal que mejor se adapte a tu necesidad:

📧 Correo electrónico

Para consultas directas, soporte personalizado o colaboraciones comerciales:

Tiempo de respuesta habitual: 24-48 horas en días laborables.

🐛 GitHub Issues

Para reportar bugs, solicitar nuevas funcionalidades o contribuir al código:

• Repositorio principal: github.com/MushhDev
• Usa las plantillas de issues para facilitar el proceso
• Revisa los issues existentes antes de crear uno nuevo

🤝 Comunidad VireXon

Únete a la comunidad de VireXon para obtener ayuda de otros usuarios, compartir configuraciones y estar al día de las novedades:

• Soporte entre usuarios
• Anuncios de nuevas versiones
• Showcase de servidores usando nuestros plugins

📋 Antes de contactar

💡 Recursos adicionales

• Wiki: Documentación extendida en GitHub Wiki de cada plugin
• Changelog: Historial de cambios en cada release de GitHub
• Configuraciones ejemplo: En la carpeta examples/ de cada repositorio