Mythras : guide client

1. Prérequis

• Paper ou Spigot 1.21 ou plus récent (Folia : offre Pro uniquement), Java 21+.
• PacketEvents 2.14.0 ou plus récent dans plugins/.
• Facultatif : ViaVersion (anciens clients), Geyser/Floodgate (joueurs Bedrock), WorldGuard (exemptions par région), PlaceholderAPI (placeholders, Pro).

2. Installation

1. 1

   Téléchargement

   Télécharge Mythras-<version>.jar (le même fichier pour toutes les offres).

2. 2

   Ajoute-le dans plugins

   Mets-le dans plugins/ avec PacketEvents.

3. 3

   Démarre le serveur

   Sans clé, Mythras démarre l'offre Free (bêta test).

4. 4

   Ajoute ta clé

   Pour utiliser Pro, tape dans la console du serveur :

   mlicense MYTH-XXXX-XXXX-XXXX-XXXX

   Copier

   puis redémarre le serveur. La console affiche License valid: plan PRO..

La clé est enregistrée dans plugins/Mythras/license.yml. Ne copie pas ce fichier sur d'autres serveurs : chaque serveur a son propre server-id, et une clé Pro fonctionne sur 1 serveur.

3. Offres

Add-ons (5,99 € chacun, un paiement, à toi pour toujours, sur une clé Free ou Pro)

Aucun plan n'inclut les add-ons : un serveur Free peut avoir seulement Anti-XRay, un serveur Pro Pro + les deux, et ainsi de suite. Le check X-Ray (il repère les utilisateurs de X-Ray à leur façon de miner) fait partie de Pro ; l'add-on est ce qui cache les minerais.

Acheter. Sur mythras.eu connecte-toi avec Discord, ouvre la boutique et paie avec PayPal.

• Pro : la clé apparaît dans ton espace client dès que PayPal confirme le premier paiement. Si tu as déjà une clé Free (pour un add-on), tu peux la passer en Pro et garder ses add-ons.
• Add-on : choisis une de tes clés, Free ou Pro ; sans clé tu reçois une clé Free avec l'add-on (installe-la avec mlicense <KEY> comme toute clé). Il s'active tout seul en quelques minutes, sans redémarrage (la console affiche Add-on Anti-XRay active.).

Renouvellement et résiliation. Pro se renouvelle tout seul chaque mois et repousse l'expiration de ta clé (3 jours de marge après chaque prélèvement). Tu peux annuler à tout moment depuis l'espace client ou PayPal : la clé fonctionne jusqu'à la fin du mois payé. Les add-ons se paient une fois et n'expirent jamais ; si ton Pro se termine, la clé devient une clé Free et ses add-ons continuent de fonctionner.

Apprentissage IA (Pro). L'IA observe 20 comportements de combat tous les 20 coups (clics, rotations, visée, portée, changement de cible) et apprend ce qui est normal sur ton serveur, à partir des joueurs punis et propres. Chaque réglage est modifiable, le staff peut l'entraîner (/ac ai label) et elle peut punir.

Mythras Cloud AI (Pro). Chaque serveur Pro reçoit aussi un modèle global, entraîné toutes les heures sur les données de combat de tous les serveurs Pro. Il protège un nouveau serveur dès le premier jour, avant que ta propre IA ait assez appris ; ensuite les deux sont combinés. Le modèle global est un petit réseau de neurones quand c'est plus précis qu'un modèle simple, il reconnaît donc aussi les combinaisons (par exemple des rotations rapides avec une visée parfaitement stable). Ce qui est partagé : 20 nombres tous les 20 coups (vitesse et rythme des clics, rotation de la vue, portée, taux de coups, stabilité de la visée...) et si le joueur a été sanctionné, jamais de noms, d'UUID ni d'adresses IP. ai.cloud.share: false télécharge seulement le modèle, ai.cloud.enabled: false le désactive. /ac ai status affiche le modèle global.

Pourquoi l'IA a signalé quelqu'un. Chaque alerte de l'IA dit pourquoi, par exemple combat model 95% cheating: very regular clicks, aim locked on the body : les comportements les plus inhabituels par rapport aux joueurs normaux de ton serveur. Tu le vois dans l'alerte, dans /ac info <player> et dans le replay.

Examiner les suspects (Pro). /ac ai review ouvre la liste des joueurs que l'IA a trouvés suspects dans la dernière heure, même s'ils sont déjà partis. Clic gauche ouvre leurs replays ; clic droit = triche, shift + clic = honnête. Ton verdict entraîne l'IA (sur ton serveur et, avec Cloud AI, partout), elle s'améliore donc plus tu l'utilises.

Les joueurs Bedrock (Geyser) ne sont jamais jugés par l'IA : les commandes tactiles et l'aide à la visée ressembleraient à de la triche.

L'offre Free n'envoie que des alertes au staff : pas de setback, pas de sanctions.

Boutique

Tous les contrôles

Chaque contrôle se configure sous checks.<name> dans config.yml. Le badge indique l'offre la plus basse qui l'inclut ; les offres supérieures incluent tout ce qui est en dessous.

Mouvement

Combat

Crystal PvP

Monde et construction

Paquets et protocole

Inventaire, véhicules et IA

4. Gérer ta licence

Tu peux tout faire depuis l'espace client de ce site ou sur notre serveur Discord :

Mes licences Serveur Discord

Panneau. Dans l'espace client tu vois tes serveurs (en ligne, joueurs, TPS, versions), les alertes, sanctions et replays enregistrés des 30 derniers jours, les joueurs et checks les plus signalés, et une page pour chaque joueur. Il se met à jour toutes les 10 secondes. Nomme tes serveurs avec panel.server-name dans config.yml.

Changement de machine : libère les serveurs de ta clé (sur le site ou avec /license reset), puis utilise mlicense <KEY> sur le nouveau serveur.

Mises à jour : Pro se met à jour tout seul. À chaque redémarrage le serveur télécharge la dernière version. Quand un nouveau Mythras-<version>.jar sort, la console et les admins qui rejoignent le serveur sont prévenus ; télécharge-le depuis l'espace client (il met à jour le loader et le plan Free).

Si notre serveur de licences est injoignable, ton serveur continue de démarrer avec ton offre pendant 72 heures.

5. Commandes

Commande principale : /mythras (alias /ac, /myth).

6. Permissions

7. Configuration

Fichiers dans plugins/Mythras/ :

• config.yml : contient seulement les options de ton plan (Free ou Pro). Après une mise à niveau les nouvelles options sont ajoutées à la fin.
• messages_<code>.yml : tous les textes, couleurs hex et dégradés pris en charge, en 8 langues (en, it, es, pt, de, fr, pl, zh). Choisis avec /ac lang <code> ou language: en.

Options principales

• language : en, it, es, pt, de, fr, pl ou zh (ou change-la en jeu avec /ac lang <code>).
• database.type : file (par défaut), sqlite, mysql, mongodb. Si la connexion échoue, Mythras repasse sur file.
• alerts : alertes dans le chat et la console, cooldown-ms, click-command.
• exemptions (Pro) : liste blanche et exemptions. players (noms ou UUID), worlds et regions WorldGuard où aucun contrôle ne tourne (staff, mini-jeux, launch pads).
• bedrock : contrôles utilisés sur les joueurs Bedrock (Geyser).
• checks.<name> : chaque contrôle a :
  • enabled;
  • buffer : combien de preuves sont nécessaires avant un signalement (plus haut = moins de faux positifs) ;
  • vl-weight et vl-decay-per-second ;
  • punish-vl : VL qui déclenche la sanction, 0 = alertes seulement (Pro) ;
  • punish-commands : commandes de sanction pour ce contrôle seulement (Pro).
• punishments.commands (Pro) : [kick] <message>, [message] <text> ou n'importe quelle commande console, par exemple ban %player% 7d Cheating. Placeholders : %player%, %check%, %vl%, %kick-message%.
• setback (Pro) : ramène le tricheur à sa dernière position valide.
• discord (Pro) : webhook pour les alertes et les sanctions. ai-suspects (Pro) : nouveaux suspects de l'IA (85%+) avec la raison.
• mitigations : (Pro) annule les coups impossibles, divise les dégâts par deux après les flags de combat, filtre de vie ; avec les add-ons, sur tout plan :
  • anti-esp et anti-storage-esp (add-on Anti-ESP, tout plan) : les conteneurs que le joueur ne voit pas sont envoyés comme le bloc d'à côté, donc StorageESP/ChestESP ne montrent rien derrière les murs (blocks = quels conteneurs) ;
  • anti-xray (add-on Anti-XRay, tout plan) : les minerais hors de vue sont envoyés comme de la roche, même ceux ouverts sur les grottes, jusqu'à ce que le joueur puisse les voir (blocks, max-y, max-distance). Il remplace l'anti-xray de Paper, que tu peux laisser désactivé.
  • L'Anti-ESP tourne sur son propre thread, il ne coûte donc presque rien au thread principal. Les murs modifiés par des commandes ou WorldEdit (sans événement de bloc) sont détectés en 3 secondes ; ceux cassés, posés ou détruits par les joueurs immédiatement.
• replay (Pro) : mode: flag enregistre les joueurs signalés, mode: always garde les 25 dernières secondes de tout le monde. Les replays sont gardés 7 jours, puis supprimés.
• ai (Pro) : modèle auto-apprenant ; règle-le et entraîne-le avec les étiquettes du staff (/ac ai label). ai.cloud (Pro) : Mythras Cloud AI, enabled et share (voir Offres).
• checks.freecam (Pro) : les clics sur des blocs cachés derrière les murs (FreeCam, GhostHand) sont refusés avec cancel: true (un coffre derrière un mur reste fermé) et signalés.
• checks.xray (Pro) : min-veins, max-stone-per-vein, window-minutes, ores. Alertes seulement par défaut : regarde le replay du joueur avant de sanctionner. L'anti-xray de Paper (engine-mode: 2 dans paper-world-defaults.yml) fonctionne bien avec.
• network (Pro) : alertes de tous les serveurs derrière BungeeCord/Velocity. Avec MythrasProxy (plus bas) mets network.proxy-plugin: true.
• panel (Pro) : le panneau client sur ce site. server-name : le nom affiché dans le panneau ; enabled: false arrête l'envoi (seuls les noms et UUID des joueurs signalés sont envoyés, avec les alertes).

8. MythrasProxy (Velocity / BungeeCord) Pro

Un plugin compagnon gratuit pour le proxy : télécharge MythrasProxy-<version>.jar et mets-le dans le dossier plugins/ de Velocity ou BungeeCord/Waterfall (le même jar fonctionne sur les deux). Sur chaque serveur Mythras mets :

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

• Alertes réseau : le staff voit les alertes de chaque serveur, sur n'importe quel serveur, avec le nom du serveur ; un clic l'y emmène (/server). Permission sur le proxy : mythras.alerts (ex. avec LuckPerms sur le proxy).
• Bans réseau : une sanction "[netban] 30d Cheating (%check%)" (ou perm) dans punishments.commands ou dans les punish-commands d'un check bannit le joueur de tout le réseau, même s'il se reconnecte à un autre serveur.
• Commandes du proxy (/mythrasproxy, /mpx, permission mythras.proxy.admin) : alerts (activer/désactiver), bans, ban <player> <30d|12h|perm> [reason], unban <player>, reload.
• Réglages et textes dans plugins/mythras-proxy/config.properties (Velocity) ou plugins/MythrasProxy/config.properties (BungeeCord) ; les bans dans bans.json.

9. API développeur et placeholders Pro

• Événements : MythrasFlagEvent (signalement annulable) et MythrasPunishEvent (sanction annulable).
• Méthodes de MythrasAPI.get() :
  • getVl(player, check), getTotalVl(player), getViolations(player);
  • getAiProbability(player), getClient(player), isBedrock(player);
  • exempt(player, millis) : exempte un joueur pendant un moment (par exemple pendant un launch pad personnalisé).
• 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. Nouveautés

• 1.25 : les add-ons Anti-XRay et Anti-ESP (avec Anti-StorageESP) se paient une fois (5,99 €) et restent pour toujours, aussi sur les serveurs Free (une clé Free avec l'add-on).
• 1.24 : deux plans, Free et Pro (19,99 €/mois, tout ce qui était Enterprise, 1 serveur par clé), payés avec PayPal sur mythras.eu. Anti-XRay et Anti-ESP sont devenus des add-ons et s'activent sans redémarrage. Les clés achetées avant (Base, Pro, Enterprise) sont maintenant Pro et gardent leurs serveurs.
• 1.23 : les réponses que tu donnes dans le lien de configuration sur mythras.eu configurent le plugin toutes seules (au prochain redémarrage ou sous 6 heures) ; tes changements ultérieurs en jeu ou dans config.yml restent jusqu'à ce que tu remplisses à nouveau le lien. Une clé peut être liée à l'adresse IP de ton serveur.
• 1.22 : nouvelles détections : Criticals "Jump" (Meteor), ElytraFly "vanilla" avec des fusées, ChestStealers avec délais aléatoires (Meteor steal) ; Blink attrape les rétentions dès 0,4 s.
• 1.21.2 : NoSlow attrape aussi les modules NoSlow pour les toiles, le sable des âmes et les blocs de miel. Plus de faux flags BadBreak, BadPlace, Phase ou FreeCam quand le serveur refuse un cassage ou un placement (protection du spawn, WorldGuard, claims) ; plus de faux flag Jesus en sortant de l'eau sur une berge à la même hauteur.
• 1.21.1 : plus de faux flags Blink quand un client (ex. Lunar) se fige un instant après la connexion.
• 1.21 : config plus simple : seulement bstats: true|false et update-checker.enabled ; les replays sont toujours gardés 7 jours ; les sanctions s'appliquent tout de suite. Les anciennes options sont retirées de config.yml automatiquement.
• 1.20 : Mythras reconstruit le monde tel que le client de chaque joueur le voit : les autres joueurs là où son écran les montre (Reach et KillAura sont plus stricts sur les cibles en mouvement, sans faux flags dus au lag) et la vraie forme des dalles, escaliers, barrières et vitres (Prediction juge maintenant aussi près des murs).
• 1.19 : nouveau check Prediction (Pro) : il rejoue le mouvement vanilla de chaque tick avec les touches pressées par le joueur et signale ce qu'aucune entrée n'explique (speed hacks légers, AirStrafe, BHop "legit"). Alertes seulement au début (checks.prediction.punish-vl: 0) : mets une sanction une fois que tu l'as vu sur ton serveur.
• 1.18 : Anti-ESP, Anti-XRay et Anti-StorageESP aussi sur Folia (Pro).
• 1.17 : MythrasProxy pour Velocity/BungeeCord : alertes et bans sur tout le réseau ([netban]).
• 1.16 : panneau client sur le site : tes serveurs, alertes, sanctions et replays depuis le navigateur.
• 1.15 : l'IA observe 20 comportements au lieu de 12 ; chaque alerte de l'IA dit pourquoi ; /ac ai review (Pro) pour juger les suspects de la dernière heure ; Mythras Cloud AI utilise un réseau de neurones quand il est plus précis. Ton IA garde ce qu'elle a déjà appris.
• 1.14.1 / 1.14.2 : performances : Anti-ESP sur son propre thread, moins de travail par joueur (le temps de Mythras sur le thread principal est environ un tiers d'avant).
• 1.14 : Mythras Cloud AI (Pro) : un modèle global entraîné sur tous les serveurs Pro, actif dès le premier jour.

11. FAQ

Un joueur honnête est signalé.

Utilise /ac info <player> et /ac debug <player>, puis envoie-nous le nom du contrôle, les détails de l'alerte, le client et la version. En attendant, augmente le buffer de ce contrôle ou mets punish-vl: 0.

Un plugin propulse les joueurs (launch pads, recul, élytres personnalisées).

Ajoute le monde ou la région à exemptions, ou appelle MythrasAPI.get().exempt(player, millis) depuis ton plugin.

La console indique « License key refused » (clé refusée).

Le message indique pourquoi :

• the key does not exist : vérifie la clé ;
• revoked (révoquée) ou expired (expirée) ;
• maximum number of servers : une clé Pro fonctionne sur 1 serveur ; libère les serveurs dans l'espace client ou avec /license reset ;
• IP not allowed : la clé est liée à d'autres adresses IP (change-les dans l'espace client).

« License server unreachable » (serveur de licences injoignable)

Le serveur démarre avec la copie enregistrée de ton offre pendant 72 heures au maximum. Vérifie que la machine peut joindre https://license.mythras.eu.

Mythras fait-il laguer le serveur ?

Non : les contrôles tournent sur les threads réseau, l'Anti-ESP et l'IA sur leurs propres threads. Avec 100 joueurs en combat, Mythras utilise environ 0,3 ms des 50 ms d'un tick. /ac perf montre combien de temps Mythras utilise par tick sur ton serveur.

L'IA a signalé un joueur honnête.

Ouvre /ac ai review (Pro) et fais shift + clic sur le joueur : ses combats sont appris à l'IA comme legit. L'alerte dit pourquoi elle a signalé (par exemple very regular clicks) : envoie-la-nous avec le client du joueur si cela continue.

Support

Ouvre un ticket sur notre serveur Discord avec ta clé (seulement la première partie, ex. MYTH-ABCD-…), la version du serveur, la version de Mythras et le journal de la console. Serveur Discord