Mythras: Kundenanleitung

1. Voraussetzungen

• Paper oder Spigot 1.21 oder neuer (Folia: nur Pro-Plan), Java 21+.
• PacketEvents 2.14.0 oder neuer in plugins/.
• Optional: ViaVersion (ältere Clients), Geyser/Floodgate (Bedrock-Spieler), WorldGuard (Regions-Ausnahmen), PlaceholderAPI (Platzhalter, Pro).

2. Installation

1. 1

   Download

   Lade Mythras-<version>.jar herunter (dieselbe Datei für jeden Plan).

2. 2

   In plugins legen

   Lege es zusammen mit PacketEvents in plugins/.

3. 3

   Server starten

   Ohne Schlüssel startet Mythras den Free-Plan (Betatest).

4. 4

   Schlüssel hinzufügen

   Um Pro zu nutzen, tippe in die Serverkonsole:

   mlicense MYTH-XXXX-XXXX-XXXX-XXXX

   Kopieren

   dann starte den Server neu. Die Konsole zeigt License valid: plan PRO..

Der Schlüssel wird in plugins/Mythras/license.yml gespeichert. Kopiere diese Datei nicht auf andere Server: Jeder Server hat seine eigene server-id, und ein Pro-Schlüssel funktioniert auf 1 Server.

3. Pläne

Add-ons (je 5,99 €, eine Zahlung, für immer deins, auf einem Free- oder Pro-Schlüssel)

Kein Plan enthält die Add-ons: Ein Free-Server kann nur Anti-XRay haben, ein Pro-Server Pro + beide und so weiter. Der X-Ray-Check (er erkennt X-Ray-Nutzer an ihrer Art zu graben) gehört zu Pro; das Add-on versteckt die Erze.

Kaufen. Melde dich auf mythras.eu mit Discord an, öffne den Shop und bezahle mit PayPal.

• Pro: Der Schlüssel erscheint in deinem Kundenbereich, sobald PayPal die erste Zahlung bestätigt. Wenn du schon einen Free-Schlüssel (für ein Add-on) hast, kannst du ihn zu Pro machen und seine Add-ons behalten.
• Add-on: Wähle einen deiner Schlüssel, Free oder Pro; ohne Schlüssel bekommst du einen Free-Schlüssel mit dem Add-on (installiere ihn mit mlicense <KEY> wie jeden Schlüssel). Es schaltet sich in wenigen Minuten von selbst ein, ohne Neustart (die Konsole zeigt Add-on Anti-XRay active.).

Verlängerung und Kündigung. Pro verlängert sich jeden Monat von selbst und verschiebt den Ablauf deines Schlüssels (3 Tage Puffer nach jeder Abbuchung). Du kannst jederzeit im Kundenbereich oder bei PayPal kündigen: Der Schlüssel funktioniert bis zum Ende des bezahlten Monats. Add-ons werden einmal bezahlt und laufen nie ab; wenn dein Pro endet, wird der Schlüssel ein Free-Schlüssel und seine Add-ons funktionieren weiter.

KI-Lernen (Pro). Die KI betrachtet alle 20 Treffer 20 Kampfverhalten (Klicks, Drehungen, Zielen, Reichweite, Zielwechsel) und lernt, was auf deinem Server normal ist, von bestraften und sauberen Spielern. Jede Einstellung ist anpassbar, das Team kann sie trainieren (/ac ai label), und sie kann bestrafen.

Mythras Cloud AI (Pro). Jeder Pro-Server bekommt zusätzlich ein globales Modell, das jede Stunde auf den Kampfdaten aller Pro-Server trainiert wird. Es schützt einen neuen Server ab dem ersten Tag, bevor deine eigene KI genug gelernt hat; danach werden beide kombiniert. Das globale Modell ist ein kleines neuronales Netz, wenn das genauer ist als ein einfaches Modell, so erkennt es auch Kombinationen (zum Beispiel schnelles Drehen zusammen mit perfekt ruhigem Zielen). Was geteilt wird: 20 Zahlen pro 20 Treffer (Klickgeschwindigkeit und -rhythmus, wie sich die Sicht dreht, Reichweite, Trefferquote, Zielruhe...) und ob der Spieler bestraft wurde, niemals Namen, UUIDs oder IP-Adressen. ai.cloud.share: false lädt nur das Modell herunter, ai.cloud.enabled: false schaltet es aus. /ac ai status zeigt das globale Modell.

Warum die KI jemanden markiert hat. Jeder KI-Alarm nennt den Grund, zum Beispiel combat model 95% cheating: very regular clicks, aim locked on the body: die Verhaltensweisen, die im Vergleich zu den normalen Spielern deines Servers am ungewöhnlichsten sind. Du siehst es im Alarm, in /ac info <player> und im Replay.

Verdächtige prüfen (Pro). /ac ai review öffnet die Liste der Spieler, die die KI in der letzten Stunde verdächtig fand, auch wenn sie schon gegangen sind. Linksklick öffnet ihre Replays; Rechtsklick = Cheater, Shift + Klick = ehrlich. Dein Urteil trainiert die KI (auf deinem Server und mit Cloud AI überall), sie wird also besser, je mehr du sie nutzt.

Bedrock-Spieler (Geyser) werden nie von der KI beurteilt: Touch-Steuerung und Zielhilfe würden wie Cheats aussehen.

Der Free-Plan sendet nur Alarme ans Team: keine Setbacks, keine Strafen.

Shop

Alle Checks

Jeder Check wird unter checks.<name> in config.yml eingestellt. Das Abzeichen zeigt den kleinsten Plan, der ihn enthält; höhere Pläne enthalten alles darunter.

Bewegung

Kampf

Crystal PvP

Welt und Bauen

Pakete und Protokoll

Inventar, Fahrzeuge und KI

4. Lizenz verwalten

Du kannst alles im Kundenbereich dieser Website oder auf unserem Discord-Server erledigen:

Meine Lizenzen Discord-Server

Panel. Im Kundenbereich siehst du deine Server (online, Spieler, TPS, Versionen), die Alerts, Strafen und gespeicherten Replays der letzten 30 Tage, die am häufigsten gemeldeten Spieler und Checks und eine Seite für jeden Spieler. Es aktualisiert sich alle 10 Sekunden. Benenne deine Server mit panel.server-name in config.yml.

Umzug auf eine andere Maschine: Setze die Server deines Schlüssels zurück (auf der Website oder mit /license reset), dann nutze mlicense <KEY> auf dem neuen Server.

Updates: Pro aktualisiert sich selbst. Bei jedem Neustart lädt der Server die neueste Version. Wenn ein neues Mythras-<version>.jar erscheint, melden es die Konsole und die Admins beim Betreten des Servers; lade es im Kundenbereich herunter (es aktualisiert den Loader und den Free-Plan).

Ist unser Lizenzserver nicht erreichbar, startet dein Server noch 72 Stunden mit deinem Plan.

5. Befehle

Hauptbefehl: /mythras (Aliase /ac, /myth).

6. Berechtigungen

7. Konfiguration

Dateien in plugins/Mythras/:

• config.yml: enthält nur die Optionen deines Plans (Free oder Pro). Nach einem Upgrade werden die neuen Optionen am Ende hinzugefügt.
• messages_<code>.yml: alle Texte, Hex-Farben und Verläufe werden unterstützt, in 8 Sprachen (en, it, es, pt, de, fr, pl, zh). Auswahl mit /ac lang <code> oder language: en.

Wichtigste Optionen

• language: en, it, es, pt, de, fr, pl oder zh (oder im Spiel ändern mit /ac lang <code>).
• database.type: file (Standard), sqlite, mysql, mongodb. Schlägt die Verbindung fehl, wechselt Mythras zu file.
• alerts: Alarme in Chat und Konsole, cooldown-ms, click-command.
• exemptions (Pro): Whitelist und Ausnahmen. players (Namen oder UUIDs), worlds und WorldGuard-regions, in denen kein Check läuft (Team, Minispiele, Launchpads).
• bedrock: Checks für Bedrock-Spieler (Geyser).
• checks.<name>: jeder Check hat:
  • enabled;
  • buffer: wie viele Beweise vor einer Markierung nötig sind (höher = weniger Fehlalarme);
  • vl-weight und vl-decay-per-second;
  • punish-vl: VL, bei dem die Strafe ausgeführt wird, 0 = nur Alarme (Pro);
  • punish-commands: Strafbefehle nur für diesen Check (Pro).
• punishments.commands (Pro): [kick] <message>, [message] <text> oder jeder Konsolenbefehl, zum Beispiel ban %player% 7d Cheating. Platzhalter: %player%, %check%, %vl%, %kick-message%.
• setback (Pro): setzt den Cheater auf die letzte gültige Position zurück.
• discord (Pro): Webhook für Alerts und Strafen. ai-suspects (Pro): neue KI-Verdächtige (85%+) mit Begründung.
• mitigations: (Pro) bricht unmögliche Treffer ab, halbiert den Schaden nach Kampf-Flags, Lebensfilter; mit den Add-ons, auf jedem Plan:
  • anti-esp und anti-storage-esp (Add-on Anti-ESP, jeder Plan): Container, die der Spieler nicht sieht, werden als der Block daneben gesendet, sodass StorageESP/ChestESP hinter Wänden nichts zeigen (blocks = welche Container);
  • anti-xray (Add-on Anti-XRay, jeder Plan): Erze außer Sicht werden als Stein gesendet, auch die zu Höhlen offenen, bis der Spieler sie sehen kann (blocks, max-y, max-distance). Es ersetzt das Anti-Xray von Paper, das du ausgeschaltet lassen kannst.
  • Anti-ESP läuft auf einem eigenen Thread und kostet den Main-Thread fast nichts. Wände, die durch Befehle oder WorldEdit geändert werden (ohne Block-Event), werden innerhalb von 3 Sekunden bemerkt; von Spielern abgebaute, platzierte oder gesprengte Wände sofort.
• replay (Pro): mode: flag zeichnet gemeldete Spieler auf, mode: always behält die letzten 25 Sekunden von allen. Replays werden 7 Tage aufbewahrt, dann gelöscht.
• ai (Pro): selbstlernendes Modell; passe es an und trainiere es mit Team-Labels (/ac ai label). ai.cloud (Pro): Mythras Cloud AI, enabled und share (siehe Pläne).
• checks.freecam (Pro): Klicks auf Blöcke hinter Wänden (FreeCam, GhostHand) werden mit cancel: true abgelehnt (eine Truhe hinter einer Wand bleibt zu) und markiert.
• checks.xray (Pro): min-veins, max-stone-per-vein, window-minutes, ores. Standardmäßig nur Alarme: Sieh dir das Replay des Spielers an, bevor du bestrafst. Das Anti-Xray von Paper (engine-mode: 2 in paper-world-defaults.yml) funktioniert gut zusammen damit.
• network (Pro): Alerts aller Server hinter BungeeCord/Velocity. Mit MythrasProxy (unten) setze network.proxy-plugin: true.
• panel (Pro): das Kundenpanel auf dieser Website. server-name: der im Panel angezeigte Name; enabled: false beendet das Senden (es werden nur Namen und UUIDs gemeldeter Spieler mit den Alerts gesendet).

8. MythrasProxy (Velocity / BungeeCord) Pro

Ein kostenloses Begleit-Plugin für den Proxy: Lade MythrasProxy-<version>.jar herunter und lege es in den Ordner plugins/ von Velocity oder BungeeCord/Waterfall (dasselbe Jar funktioniert auf beiden). Setze auf jedem Mythras-Server:

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

• Netzwerk-Alerts: Das Team sieht die Alerts aller Server, auf jedem Server, mit dem Servernamen; ein Klick bringt es dorthin (/server). Berechtigung auf dem Proxy: mythras.alerts (z. B. mit LuckPerms auf dem Proxy).
• Netzwerk-Banns: Eine Strafe "[netban] 30d Cheating (%check%)" (oder perm) in punishments.commands oder in den punish-commands eines Checks bannt den Spieler aus dem ganzen Netzwerk, auch wenn er sich mit einem anderen Server verbindet.
• Proxy-Befehle (/mythrasproxy, /mpx, Berechtigung mythras.proxy.admin): alerts (an/aus), bans, ban <player> <30d|12h|perm> [reason], unban <player>, reload.
• Einstellungen und Texte in plugins/mythras-proxy/config.properties (Velocity) oder plugins/MythrasProxy/config.properties (BungeeCord); Banns in bans.json.

9. Entwickler-API und Platzhalter Pro

• Events: MythrasFlagEvent (abbrechbare Markierung) und MythrasPunishEvent (abbrechbare Strafe).
• Methoden von MythrasAPI.get():
  • getVl(player, check), getTotalVl(player), getViolations(player);
  • getAiProbability(player), getClient(player), isBedrock(player);
  • exempt(player, millis): nimmt einen Spieler eine Zeit lang aus (z. B. während eines eigenen Launchpads).
• 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. Neuigkeiten

• 1.25: Die Add-ons Anti-XRay und Anti-ESP (mit Anti-StorageESP) werden einmal bezahlt (5,99 €) und bleiben für immer, auch auf Free-Servern (ein Free-Schlüssel mit dem Add-on).
• 1.24: zwei Pläne, Free und Pro (19,99 €/Monat, alles, was Enterprise war, 1 Server pro Schlüssel), bezahlt mit PayPal auf mythras.eu. Anti-XRay und Anti-ESP sind Add-ons geworden und schalten sich ohne Neustart ein. Früher gekaufte Schlüssel (Base, Pro, Enterprise) sind jetzt Pro und behalten ihre Server.
• 1.23: Deine Antworten im Setup-Link auf mythras.eu konfigurieren das Plugin von selbst (beim nächsten Neustart oder innerhalb von 6 Stunden); deine späteren Änderungen im Spiel oder in config.yml bleiben, bis du den Link erneut ausfüllst. Ein Schlüssel kann an die IP-Adresse deines Servers gebunden werden.
• 1.22: neue Erkennungen: Criticals "Jump" (Meteor), ElytraFly "vanilla" mit Raketen, ChestStealer mit zufälligen Verzögerungen (Meteor steal); Blink erkennt Zurückhalten ab 0,4 s.
• 1.21.2: NoSlow erkennt jetzt auch NoSlow-Module für Spinnweben, Seelensand und Honigblöcke. Keine BadBreak-, BadPlace-, Phase- oder FreeCam-Fehlalarme mehr, wenn der Server einen Abbau oder eine Platzierung ablehnt (Spawnschutz, WorldGuard, Claims); kein Jesus-Fehlalarm mehr beim Verlassen des Wassers auf ein gleich hohes Ufer.
• 1.21.1: keine Blink-Fehlalarme mehr, wenn ein Client (z. B. Lunar) nach dem Beitritt kurz einfriert.
• 1.21: einfachere Config: nur bstats: true|false und update-checker.enabled; Replays werden immer 7 Tage aufbewahrt; Strafen laufen sofort. Alte Optionen werden automatisch aus config.yml entfernt.
• 1.20: Mythras baut die Welt so nach, wie der Client jedes Spielers sie sieht: andere Spieler dort, wo sein Bildschirm sie zeigt (Reach und KillAura sind bei bewegten Zielen strenger, ohne Fehlalarme durch Lag), und die echte Form von Stufen, Treppen, Zäunen und Scheiben (Prediction urteilt jetzt auch an Wänden).
• 1.19: neuer Prediction-Check (Pro): Er spielt die Vanilla-Bewegung jedes Ticks mit den gedrückten Tasten nach und meldet, was keine Eingabe erklärt (leichte Speed-Hacks, AirStrafe, "legit" BHop). Anfangs nur Alerts (checks.prediction.punish-vl: 0): Setze eine Strafe, wenn du ihn auf deinem Server gesehen hast.
• 1.18: Anti-ESP, Anti-XRay und Anti-StorageESP auch auf Folia (Pro).
• 1.17: MythrasProxy für Velocity/BungeeCord: netzwerkweite Alerts und Banns ([netban]).
• 1.16: Kundenpanel auf der Website: deine Server, Alerts, Strafen und Replays im Browser.
• 1.15: Die KI betrachtet 20 statt 12 Verhaltensweisen; jeder KI-Alarm nennt den Grund; /ac ai review (Pro) zum Beurteilen der Verdächtigen der letzten Stunde; Mythras Cloud AI nutzt ein neuronales Netz, wenn es genauer ist. Deine KI behält, was sie schon gelernt hat.
• 1.14.1 / 1.14.2: Leistung: Anti-ESP auf eigenem Thread, weniger Arbeit pro Spieler (die Main-Thread-Zeit von Mythras ist etwa ein Drittel von vorher).
• 1.14: Mythras Cloud AI (Pro): ein globales Modell, trainiert auf allen Pro-Servern, aktiv ab dem ersten Tag.

11. FAQ

Ein ehrlicher Spieler wird markiert.

Nutze /ac info <player> und /ac debug <player> und schick uns dann den Check-Namen, die Details des Alarms, den Client und die Version. Erhöhe in der Zwischenzeit den buffer dieses Checks oder setze punish-vl: 0.

Ein Plugin schleudert Spieler (Launchpads, Rückstoß, eigene Elytren).

Füge die Welt oder Region zu exemptions hinzu oder rufe MythrasAPI.get().exempt(player, millis) aus deinem Plugin auf.

Die Konsole meldet "License key refused" (Schlüssel abgelehnt).

Die Meldung nennt den Grund:

• the key does not exist: Prüfe den Schlüssel;
• revoked (widerrufen) oder expired (abgelaufen);
• maximum number of servers: Ein Pro-Schlüssel funktioniert auf 1 Server; setze die Server im Kundenbereich oder mit /license reset zurück;
• IP not allowed: Der Schlüssel ist an andere IP-Adressen gebunden (ändere sie im Kundenbereich).

"License server unreachable" (Lizenzserver nicht erreichbar)

Der Server startet bis zu 72 Stunden mit der gespeicherten Kopie deines Plans. Prüfe, ob die Maschine https://license.mythras.eu erreicht.

Verursacht Mythras Lag?

Nein: Die Checks laufen auf den Netzwerk-Threads, Anti-ESP und KI auf eigenen Threads. Bei 100 kämpfenden Spielern braucht Mythras etwa 0,3 ms der 50 ms eines Ticks. /ac perf zeigt, wie viel Zeit Mythras pro Tick auf deinem Server braucht.

Die KI hat einen ehrlichen Spieler markiert.

Öffne /ac ai review (Pro) und klicke mit Shift auf den Spieler: Seine Kämpfe werden der KI als legit beigebracht. Der Alert sagt, warum geflaggt wurde (zum Beispiel very regular clicks): Schick ihn uns mit dem Client des Spielers, wenn es weiter passiert.

Support

Öffne ein Ticket auf unserem Discord-Server mit deinem Schlüssel (nur der erste Teil, z. B. MYTH-ABCD-…), Serverversion, Mythras-Version und dem Konsolen-Log. Discord-Server