Mythras: guía para clientes

1. Requisitos

• Paper o Spigot 1.21 o superior (Folia: solo plan Pro), Java 21+.
• PacketEvents 2.14.0 o superior en plugins/.
• Opcional: ViaVersion (clientes antiguos), Geyser/Floodgate (jugadores de Bedrock), WorldGuard (exenciones por región), PlaceholderAPI (placeholders, Pro).

2. Instalación

1. 1

   Descarga

   Descarga Mythras-<version>.jar (el mismo archivo para todos los planes).

2. 2

   Ponlo en plugins

   Ponlo en plugins/ junto con PacketEvents.

3. 3

   Inicia el servidor

   Sin clave, Mythras arranca el plan Free (beta de prueba).

4. 4

   Añade tu clave

   Para usar Pro, escribe en la consola del servidor:

   mlicense MYTH-XXXX-XXXX-XXXX-XXXX

   Copiar

   luego reinicia el servidor. La consola muestra License valid: plan PRO..

La clave se guarda en plugins/Mythras/license.yml. No copies este archivo a otros servidores: cada servidor tiene su propio server-id, y una clave Pro funciona en 1 servidor.

3. Planes

Add-ons (5,99 € cada uno, un pago, tuyos para siempre, en una clave Free o Pro)

Ningún plan incluye los add-ons: un servidor Free puede tener solo Anti-XRay, un servidor Pro Pro + ambos, etc. El check X-Ray (detecta a quien usa X-Ray por cómo mina) es parte de Pro; el add-on es lo que oculta los minerales.

Comprar. En mythras.eu inicia sesión con Discord, abre la tienda y paga con PayPal.

• Pro: la clave aparece en tu área de clientes en cuanto PayPal confirma el primer pago. Si ya tienes una clave Free (para un add-on), puedes convertirla en Pro y conservar sus add-ons.
• Add-on: elige una de tus claves, Free o Pro; sin clave recibes una clave Free con el add-on (instálala con mlicense <KEY> como cualquier clave). Se activa solo en pocos minutos, sin reiniciar (la consola muestra Add-on Anti-XRay active.).

Renovación y cancelación. Pro se renueva solo cada mes y mueve la caducidad de tu clave (3 días de margen tras cada cobro). Puedes cancelar cuando quieras desde el área de clientes o desde PayPal: la clave funciona hasta el final del mes pagado. Los add-ons se pagan una vez y nunca caducan; si tu Pro termina, la clave pasa a ser Free y sus add-ons siguen funcionando.

Aprendizaje IA (Pro). La IA observa 20 comportamientos de combate cada 20 golpes (clics, rotaciones, puntería, alcance, cambio de objetivo) y aprende qué es normal en tu servidor, a partir de jugadores castigados y limpios. Cada ajuste se puede cambiar, el staff puede entrenarla (/ac ai label) y puede castigar.

Mythras Cloud AI (Pro). Cada servidor Pro recibe además un modelo global, entrenado cada hora con los datos de combate de todos los servidores Pro. Protege un servidor nuevo desde el primer día, antes de que tu propia IA haya aprendido lo suficiente; después se combinan los dos. El modelo global es una pequeña red neuronal cuando es más precisa que un modelo simple, así también reconoce combinaciones (por ejemplo, giros rápidos junto con una puntería perfectamente estable). Qué se comparte: 20 números cada 20 golpes (velocidad y ritmo de clics, cómo gira la vista, alcance, porcentaje de golpes, estabilidad de la puntería...) y si el jugador fue castigado, nunca nombres, UUID ni direcciones IP. ai.cloud.share: false solo descarga el modelo, ai.cloud.enabled: false lo desactiva. /ac ai status muestra el modelo global.

Por qué la IA marcó a alguien. Cada alerta de la IA dice por qué, por ejemplo combat model 95% cheating: very regular clicks, aim locked on the body: los comportamientos más inusuales en comparación con los jugadores normales de tu servidor. Lo ves en la alerta, en /ac info <player> y en la repetición.

Revisar sospechosos (Pro). /ac ai review abre la lista de jugadores que la IA encontró sospechosos en la última hora, aunque ya se hayan ido. Clic izquierdo abre sus repeticiones; clic derecho = trampas, shift + clic = legítimo. Tu veredicto enseña a la IA (en tu servidor y, con Cloud AI, en todas partes), así mejora cuanto más la usas.

Los jugadores de Bedrock (Geyser) nunca son juzgados por la IA: los controles táctiles y la asistencia de puntería parecerían trampas.

El plan Free solo envía alertas al staff: sin setbacks ni castigos.

Tienda

Todas las comprobaciones

Cada comprobación se configura en checks.<name> de config.yml. La insignia indica el plan más bajo que la incluye; los planes superiores incluyen todo lo anterior.

Movimiento

Combate

Crystal PvP

Mundo y construcción

Paquetes y protocolo

Inventario, vehículos e IA

4. Gestionar tu licencia

Puedes hacerlo todo desde el área de clientes de esta web o desde nuestro servidor de Discord:

Mis licencias Servidor de Discord

Panel. En el área de clientes ves tus servidores (online, jugadores, TPS, versiones), las alertas, castigos y repeticiones guardadas de los últimos 30 días, los jugadores y checks más marcados, y una página por jugador. Se actualiza cada 10 segundos. Pon nombre a tus servidores con panel.server-name en config.yml.

Cambio de máquina: libera los servidores de tu clave (en la web o con /license reset), luego usa mlicense <KEY> en el nuevo servidor.

Actualizaciones: Pro se actualiza solo. En cada reinicio el servidor descarga la última versión. Cuando sale un nuevo Mythras-<version>.jar, lo avisan la consola y los admins al entrar al servidor; descárgalo desde el área de clientes (actualiza el loader y el plan Free).

Si nuestro servidor de licencias no responde, tu servidor sigue arrancando con tu plan durante 72 horas.

5. Comandos

Comando principal: /mythras (alias /ac, /myth).

6. Permisos

7. Configuración

Archivos en plugins/Mythras/:

• config.yml: contiene solo las opciones de tu plan (Free o Pro). Tras una mejora las nuevas opciones se añaden al final.
• messages_<code>.yml: todos los textos, con colores hex y degradados, en 8 idiomas (en, it, es, pt, de, fr, pl, zh). Elige con /ac lang <code> o language: en.

Opciones principales

• language: en, it, es, pt, de, fr, pl o zh (o cámbialo en el juego con /ac lang <code>).
• database.type: file (por defecto), sqlite, mysql, mongodb. Si la conexión falla, Mythras vuelve a file.
• alerts: alertas en el chat y la consola, cooldown-ms, click-command.
• exemptions (Pro): lista blanca y exenciones. players (nombres o UUID), worlds y regions de WorldGuard donde no funciona ninguna comprobación (staff, minijuegos, plataformas de lanzamiento).
• bedrock: comprobaciones usadas en jugadores de Bedrock (Geyser).
• checks.<name>: cada comprobación tiene:
  • enabled;
  • buffer: cuántas pruebas se necesitan antes de una marca (más alto = menos falsos positivos);
  • vl-weight y vl-decay-per-second;
  • punish-vl: VL que ejecuta el castigo, 0 = solo alertas (Pro);
  • punish-commands: comandos de castigo solo para esta comprobación (Pro).
• punishments.commands (Pro): [kick] <message>, [message] <text> o cualquier comando de consola, por ejemplo ban %player% 7d Cheating. Placeholders: %player%, %check%, %vl%, %kick-message%.
• setback (Pro): devuelve al tramposo a su última posición válida.
• discord (Pro): webhook para alertas y castigos. ai-suspects (Pro): nuevos sospechosos de la IA (85%+) con el motivo.
• mitigations: (Pro) cancela golpes imposibles, reduce a la mitad el daño tras flags de combate, filtro de vida; con los add-ons, en cualquier plan:
  • anti-esp y anti-storage-esp (add-on Anti-ESP, cualquier plan): los contenedores que el jugador no ve se envían como el bloque de al lado, así StorageESP/ChestESP no muestran nada tras las paredes (blocks = qué contenedores);
  • anti-xray (add-on Anti-XRay, cualquier plan): los minerales fuera de vista se envían como roca, también los abiertos a cuevas, hasta que el jugador puede verlos (blocks, max-y, max-distance). Sustituye al anti-xray de Paper, que puedes dejar apagado.
  • El Anti-ESP funciona en su propio hilo, así que casi no cuesta nada en el hilo principal. Las paredes cambiadas con comandos o WorldEdit (sin evento de bloque) se detectan en 3 segundos; las rotas, colocadas o explotadas por jugadores al momento.
• replay (Pro): mode: flag graba a los jugadores marcados, mode: always guarda los últimos 25 segundos de todos. Las repeticiones se guardan 7 días y luego se borran.
• ai (Pro): modelo que aprende solo; ajústalo y entrénalo con etiquetas del staff (/ac ai label). ai.cloud (Pro): Mythras Cloud AI, enabled y share (ver Planes).
• checks.freecam (Pro): los clics en bloques ocultos tras las paredes (FreeCam, GhostHand) se rechazan con cancel: true (un cofre tras una pared sigue cerrado) y se marcan.
• checks.xray (Pro): min-veins, max-stone-per-vein, window-minutes, ores. Por defecto solo alertas: mira la repetición del jugador antes de castigar. El anti-xray de Paper (engine-mode: 2 en paper-world-defaults.yml) funciona bien junto a él.
• network (Pro): alertas de todos los servidores detrás de BungeeCord/Velocity. Con MythrasProxy (abajo) pon network.proxy-plugin: true.
• panel (Pro): el panel de clientes de esta web. server-name: el nombre que se muestra en el panel; enabled: false deja de enviar (solo se envían nombres y UUID de los jugadores marcados, con las alertas).

8. MythrasProxy (Velocity / BungeeCord) Pro

Un plugin gratuito para el proxy: descarga MythrasProxy-<version>.jar y ponlo en la carpeta plugins/ de Velocity o BungeeCord/Waterfall (el mismo jar funciona en ambos). En cada servidor Mythras pon:

network:
  enabled: true
  server-name: "lobby"      # the name of this server in the proxy
  proxy-plugin: true

• Alertas de red: el staff ve las alertas de todos los servidores, en cualquier servidor, con el nombre del servidor; al hacer clic va allí (/server). Permiso en el proxy: mythras.alerts (p. ej. con LuckPerms en el proxy).
• Baneos de red: un castigo "[netban] 30d Cheating (%check%)" (o perm) en punishments.commands o en los punish-commands de un check banea al jugador de toda la red, también si se reconecta a otro servidor.
• Comandos del proxy (/mythrasproxy, /mpx, permiso mythras.proxy.admin): alerts (activar/desactivar), bans, ban <player> <30d|12h|perm> [reason], unban <player>, reload.
• Ajustes y textos en plugins/mythras-proxy/config.properties (Velocity) o plugins/MythrasProxy/config.properties (BungeeCord); los baneos en bans.json.

9. API para desarrolladores y placeholders Pro

• Eventos: MythrasFlagEvent (marca cancelable) y MythrasPunishEvent (castigo cancelable).
• Métodos de MythrasAPI.get():
  • getVl(player, check), getTotalVl(player), getViolations(player);
  • getAiProbability(player), getClient(player), isBedrock(player);
  • exempt(player, millis): exime a un jugador durante un tiempo (por ejemplo, durante una plataforma de lanzamiento propia).
• PlaceholderAPI:
  • %mythras_vl%, %mythras_client%, %mythras_version%, %mythras_ai%;
  • %mythras_bedrock% and %mythras_checked%.

// exempt a player for 3 seconds during your launch pad
MythrasAPI.get().exempt(player, 3000);

10. Novedades

• 1.25: los add-ons Anti-XRay y Anti-ESP (con Anti-StorageESP) se pagan una vez (5,99 €) y se conservan para siempre, también en servidores Free (una clave Free con el add-on).
• 1.24: dos planes, Free y Pro (19,99 €/mes, todo lo que era Enterprise, 1 servidor por clave), pagados con PayPal en mythras.eu. Anti-XRay y Anti-ESP pasaron a ser add-ons y se activan sin reiniciar. Las claves compradas antes (Base, Pro, Enterprise) ahora son Pro y conservan sus servidores.
• 1.23: las respuestas que das en el enlace de configuración de mythras.eu configuran el plugin solas (en el próximo reinicio o en 6 horas); tus cambios posteriores en el juego o en config.yml se mantienen hasta que vuelvas a rellenar el enlace. Una clave se puede bloquear a la IP de tu servidor.
• 1.22: nuevas detecciones: Criticals "Jump" (Meteor), ElytraFly "vanilla" usando cohetes, ChestStealers con retrasos aleatorios (Meteor steal); Blink detecta retenciones desde 0,4 s.
• 1.21.2: NoSlow ahora también detecta módulos NoSlow para telarañas, arena de almas y bloques de miel. No más falsos flags de BadBreak, BadPlace, Phase o FreeCam cuando el servidor rechaza una rotura o colocación (protección del spawn, WorldGuard, claims); no más falso flag de Jesus al salir del agua a una orilla a la misma altura.
• 1.21.1: no más falsos flags de Blink cuando un cliente (p. ej. Lunar) se congela un momento al entrar.
• 1.21: config más sencilla: solo bstats: true|false y update-checker.enabled; las repeticiones se guardan siempre 7 días; los castigos se aplican al momento. Las opciones antiguas se quitan de config.yml automáticamente.
• 1.20: Mythras reconstruye el mundo como lo ve el cliente de cada jugador: los demás jugadores donde su pantalla los muestra (Reach y KillAura son más estrictos con objetivos en movimiento, sin falsos flags por lag) y la forma real de losas, escaleras, vallas y paneles (Prediction ahora también juzga junto a las paredes).
• 1.19: nuevo check Prediction (Pro): reproduce el movimiento vanilla de cada tick con las teclas que pulsa el jugador y marca lo que ninguna entrada explica (speed hacks ligeros, AirStrafe, BHop "legit"). Al principio solo alertas (checks.prediction.punish-vl: 0): pon un castigo cuando lo hayas visto en tu servidor.
• 1.18: Anti-ESP, Anti-XRay y Anti-StorageESP también en Folia (Pro).
• 1.17: MythrasProxy para Velocity/BungeeCord: alertas y baneos en toda la red ([netban]).
• 1.16: panel de clientes en la web: tus servidores, alertas, castigos y repeticiones desde el navegador.
• 1.15: la IA observa 20 comportamientos en lugar de 12; cada alerta de la IA dice por qué; /ac ai review (Pro) para juzgar a los sospechosos de la última hora; Mythras Cloud AI usa una red neuronal cuando es más precisa. Tu IA conserva lo que ya aprendió.
• 1.14.1 / 1.14.2: rendimiento: Anti-ESP en su propio hilo, menos trabajo por jugador (el tiempo de Mythras en el hilo principal es cerca de un tercio de antes).
• 1.14: Mythras Cloud AI (Pro): un modelo global entrenado en todos los servidores Pro, activo desde el primer día.

11. Preguntas frecuentes

Un jugador legítimo es marcado.

Usa /ac info <player> y /ac debug <player> y envíanos el nombre de la comprobación, los detalles de la alerta, el cliente y la versión. Mientras tanto, sube el buffer de esa comprobación o pon punish-vl: 0.

Un plugin lanza a los jugadores (plataformas de lanzamiento, retroceso, élitros personalizados).

Añade el mundo o la región a exemptions, o llama a MythrasAPI.get().exempt(player, millis) desde tu plugin.

La consola dice "License key refused" (clave rechazada).

El mensaje indica el motivo:

• the key does not exist: revisa la clave;
• revoked (revocada) o expired (caducada);
• maximum number of servers: una clave Pro funciona en 1 servidor; libera los servidores en el área de clientes o con /license reset;
• IP not allowed: la clave está bloqueada a otras direcciones IP (cámbialas en el área de clientes).

"License server unreachable" (servidor de licencias inaccesible)

El servidor arranca con la copia guardada de tu plan hasta 72 horas. Comprueba que la máquina llega a https://license.mythras.eu.

¿Mythras causa lag en el servidor?

No: las comprobaciones se ejecutan en los hilos de red, el Anti-ESP y la IA en sus propios hilos. Con 100 jugadores combatiendo, Mythras usa unos 0,3 ms de los 50 ms de un tick. /ac perf muestra cuánto tiempo usa Mythras por tick en tu servidor.

La IA marcó a un jugador legítimo.

Abre /ac ai review (Pro) y haz shift + clic en el jugador: sus combates se enseñan a la IA como legit. La alerta dice por qué marcó (por ejemplo very regular clicks): envíanosla con el cliente del jugador si sigue pasando.

Soporte

Abre un ticket en nuestro servidor de Discord con tu clave (solo la primera parte, p. ej. MYTH-ABCD-…), la versión del servidor, la versión de Mythras y el registro de la consola. Servidor de Discord