Mythras: guida per i clienti

1. Requisiti

• Paper o Spigot 1.21 o più recente (Folia: solo piano Pro), Java 21+.
• PacketEvents 2.14.0 o più recente in plugins/.
• Facoltativi: ViaVersion (client più vecchi), Geyser/Floodgate (giocatori Bedrock), WorldGuard (esenzioni per regione), PlaceholderAPI (placeholder, Pro).

2. Installazione

1. 1

   Download

   Scarica Mythras-<version>.jar (lo stesso file per tutti i piani).

2. 2

   Mettilo in plugins

   Mettilo in plugins/ insieme a PacketEvents.

3. 3

   Avvia il server

   Senza chiave Mythras avvia il piano Free (beta test).

4. 4

   Aggiungi la chiave

   Per usare Pro, scrivi nella console del server:

   mlicense MYTH-XXXX-XXXX-XXXX-XXXX

   Copia

   poi riavvia il server. La console mostra License valid: plan PRO..

La chiave viene salvata in plugins/Mythras/license.yml. Non copiare questo file su altri server: ogni server ha il suo server-id e una chiave Pro funziona su 1 server.

3. Piani

Add-on (5,99 € ciascuno, un pagamento, tuoi per sempre, su una chiave Free o Pro)

Nessun piano include gli add-on: un server Free può avere solo Anti-XRay, un server Pro Pro + entrambi, e così via. Il check X-Ray (scopre chi usa X-Ray da come scava) fa parte di Pro; l'add-on è ciò che nasconde i minerali.

Acquisto. Su mythras.eu accedi con Discord, apri lo shop e paga con PayPal.

• Pro: la chiave compare nella tua area clienti appena PayPal conferma il primo pagamento. Se hai già una chiave Free (per un add-on), puoi trasformarla in Pro e tenere i suoi add-on.
• Add-on: scegli una delle tue chiavi, Free o Pro; senza chiave ricevi una chiave Free con l'add-on (installala con mlicense <KEY> come qualsiasi chiave). Si accende da solo entro pochi minuti, senza riavvio (la console mostra Add-on Anti-XRay active.).

Rinnovo e disdetta. Pro si rinnova da solo ogni mese e sposta la scadenza della tua chiave (3 giorni di margine dopo ogni addebito). Puoi annullare quando vuoi dall'area clienti o da PayPal: la chiave funziona fino alla fine del mese pagato. Gli add-on si pagano una volta e non scadono mai; se il tuo Pro finisce, la chiave diventa una chiave Free e i suoi add-on continuano a funzionare.

AI learning (Pro). L'AI osserva 20 comportamenti di combattimento ogni 20 colpi (click, rotazioni, mira, reach, cambio bersaglio) e impara cosa è normale sul tuo server, dai giocatori puniti e da quelli puliti. Ogni impostazione è regolabile, lo staff può addestrarla (/ac ai label) e può punire.

Mythras Cloud AI (Pro). Ogni server Pro riceve anche un modello globale, addestrato ogni ora sui dati di combattimento di tutti i server Pro. Protegge un server nuovo dal primo giorno, prima che la tua IA abbia imparato abbastanza; poi i due vengono combinati. Il modello globale è una piccola rete neurale quando è più precisa di un modello semplice, così riconosce anche le combinazioni (per esempio rotazioni veloci insieme a una mira perfettamente ferma). Cosa viene condiviso: 20 numeri ogni 20 colpi (velocità e ritmo dei click, come gira la visuale, reach, percentuale di colpi, stabilità della mira...) e se il giocatore è stato punito, mai nomi, UUID o indirizzi IP. ai.cloud.share: false scarica solo il modello, ai.cloud.enabled: false lo disattiva. /ac ai status mostra il modello globale.

Perché l'IA ha segnalato qualcuno. Ogni alert dell'IA dice il perché, per esempio combat model 95% cheating: very regular clicks, aim locked on the body: i comportamenti più insoliti rispetto ai giocatori normali del tuo server. Lo vedi nell'alert, in /ac info <player> e nel replay.

Revisione dei sospetti (Pro). /ac ai review apre la lista dei giocatori che l'IA ha trovato sospetti nell'ultima ora, anche se sono già usciti. Click sinistro apre i loro replay; click destro = cheat, shift + click = pulito. Il tuo giudizio insegna all'IA (sul tuo server e, con Cloud AI, ovunque), quindi migliora più la usi.

I giocatori Bedrock (Geyser) non vengono mai giudicati dall'IA: i controlli touch e l'aim assist sembrerebbero cheat.

Il piano Free manda solo alert allo staff: niente setback, niente punizioni.

Shop

Tutti i check

Ogni check si configura sotto checks.<name> in config.yml. Il badge mostra il piano più basso che lo include; i piani superiori includono tutto quello dei precedenti.

Movimento

Combattimento

Crystal PvP

Mondo e costruzione

Pacchetti e protocollo

Inventario, veicoli e IA

4. Gestire la licenza

Puoi fare tutto dall'area clienti di questo sito oppure dal nostro server Discord:

Le mie licenze Server Discord

Pannello. Nell'area clienti vedi i tuoi server (online, giocatori, TPS, versioni), gli alert, le punizioni e i replay salvati degli ultimi 30 giorni, i giocatori e i check più segnalati, e una pagina per ogni giocatore. Si aggiorna ogni 10 secondi. Dai un nome ai server con panel.server-name in config.yml.

Cambio di macchina: libera i server della tua chiave (dal sito o con /license reset), poi usa mlicense <KEY> sul nuovo server.

Aggiornamenti: Pro si aggiorna da solo. A ogni riavvio il server scarica l'ultima versione. Quando esce un nuovo Mythras-<version>.jar, lo dicono la console e gli admin che entrano nel server; scaricalo dall'area clienti (aggiorna il loader e il piano Free).

Se il nostro server delle licenze non è raggiungibile, il tuo server continua ad avviarsi con il tuo piano per 72 ore.

5. Comandi

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

6. Permessi

7. Configurazione

File in plugins/Mythras/:

• config.yml: contiene solo le opzioni del tuo piano (Free o Pro). Dopo un upgrade le nuove opzioni vengono aggiunte in fondo.
• messages_<code>.yml: tutti i testi, con colori hex e gradienti, in 8 lingue (en, it, es, pt, de, fr, pl, zh). Scegli con /ac lang <code> o language: en.

Opzioni principali

• language: en, it, es, pt, de, fr, pl o zh (oppure cambiala in gioco con /ac lang <code>).
• database.type: file (predefinito), sqlite, mysql, mongodb. Se la connessione fallisce Mythras passa a file.
• alerts: alert in chat e console, cooldown-ms, click-command.
• exemptions (Pro): whitelist ed esenzioni. players (nomi o UUID), worlds e regions di WorldGuard dove nessun check gira (staff, minigiochi, launch pad).
• bedrock: check usati sui giocatori Bedrock (Geyser).
• checks.<name>: ogni check ha:
  • enabled;
  • buffer: quante prove servono prima di una segnalazione (più alto = meno falsi positivi);
  • vl-weight e vl-decay-per-second;
  • punish-vl: VL che esegue la punizione, 0 = solo alert (Pro);
  • punish-commands: comandi di punizione solo per questo check (Pro).
• punishments.commands (Pro): [kick] <message>, [message] <text> o qualsiasi comando da console, per esempio ban %player% 7d Cheating. Placeholder: %player%, %check%, %vl%, %kick-message%.
• setback (Pro): riporta il cheater all'ultima posizione valida.
• discord (Pro): webhook per alert e punizioni. ai-suspects (Pro): nuovi sospetti dell'AI (85%+) con il motivo.
• mitigations: (Pro) annulla i colpi impossibili, dimezza il danno dopo i flag di combattimento, filtro della vita; con gli add-on, su qualsiasi piano:
  • anti-esp e anti-storage-esp (add-on Anti-ESP, qualsiasi piano): i contenitori che il giocatore non vede vengono inviati come il blocco accanto, così StorageESP/ChestESP non mostrano nulla dietro i muri (blocks = quali contenitori);
  • anti-xray (add-on Anti-XRay, qualsiasi piano): i minerali fuori vista vengono inviati come roccia, anche quelli aperti sulle grotte, finché il giocatore non li vede (blocks, max-y, max-distance). Sostituisce l'anti-xray di Paper, che puoi lasciare spento.
  • L'Anti-ESP lavora sul suo thread, quindi non pesa quasi nulla sul thread principale. I muri cambiati da comandi o WorldEdit (senza evento del blocco) vengono notati entro 3 secondi; quelli rotti, piazzati o fatti esplodere dai giocatori subito.
• replay (Pro): mode: flag registra i giocatori segnalati, mode: always tiene gli ultimi 25 secondi di tutti. I replay restano 7 giorni, poi vengono eliminati.
• ai (Pro): modello che impara da solo; regolalo e addestralo con le etichette dello staff (/ac ai label). ai.cloud (Pro): Mythras Cloud AI, enabled e share (vedi Piani).
• checks.freecam (Pro): i click su blocchi nascosti dietro i muri (FreeCam, GhostHand) vengono rifiutati con cancel: true (una cassa dietro un muro resta chiusa) e segnalati.
• checks.xray (Pro): min-veins, max-stone-per-vein, window-minutes, ores. Di base solo alert: guarda il replay del giocatore prima di punire. L'anti-xray di Paper (engine-mode: 2 in paper-world-defaults.yml) funziona bene insieme.
• network (Pro): alert di tutti i server dietro BungeeCord/Velocity. Con MythrasProxy (sotto) imposta network.proxy-plugin: true.
• panel (Pro): il pannello clienti su questo sito. server-name: il nome mostrato nel pannello; enabled: false smette di inviare (vengono inviati solo nomi e UUID dei giocatori segnalati, con gli alert).

8. MythrasProxy (Velocity / BungeeCord) Pro

Un plugin gratuito per il proxy: scarica MythrasProxy-<version>.jar e mettilo nella cartella plugins/ di Velocity o BungeeCord/Waterfall (lo stesso jar funziona su entrambi). Su ogni server Mythras imposta:

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

• Alert di rete: lo staff vede gli alert di ogni server, su qualsiasi server si trovi, con il nome del server; cliccandone uno ci va (/server). Permesso sul proxy: mythras.alerts (es. con LuckPerms sul proxy).
• Ban di rete: una punizione "[netban] 30d Cheating (%check%)" (o perm) in punishments.commands o nei punish-commands di un check banna il giocatore da tutto il network, anche se si riconnette a un altro server.
• Comandi del proxy (/mythrasproxy, /mpx, permesso mythras.proxy.admin): alerts (attiva/disattiva), bans, ban <player> <30d|12h|perm> [reason], unban <player>, reload.
• Impostazioni e testi in plugins/mythras-proxy/config.properties (Velocity) o plugins/MythrasProxy/config.properties (BungeeCord); i ban in bans.json.

9. API per sviluppatori e placeholder Pro

• Eventi: MythrasFlagEvent (segnalazione annullabile) e MythrasPunishEvent (punizione annullabile).
• Metodi di MythrasAPI.get():
  • getVl(player, check), getTotalVl(player), getViolations(player);
  • getAiProbability(player), getClient(player), isBedrock(player);
  • exempt(player, millis): esenta un giocatore per un po' (per esempio durante un launch pad personalizzato).
• 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. Novità

• 1.25: gli add-on Anti-XRay e Anti-ESP (con Anti-StorageESP) si pagano una volta (5,99 €) e restano per sempre, anche sui server Free (una chiave Free con l'add-on).
• 1.24: due piani, Free e Pro (19,99 €/mese, tutto ciò che era Enterprise, 1 server per chiave), pagati con PayPal su mythras.eu. Anti-XRay e Anti-ESP sono diventati add-on e si accendono senza riavvio. Le chiavi comprate prima (Base, Pro, Enterprise) ora sono Pro e tengono i loro server.
• 1.23: le risposte che dai nel link di setup su mythras.eu configurano il plugin da sole (al prossimo riavvio o entro 6 ore); le tue modifiche successive in gioco o in config.yml restano finché non compili di nuovo il link. Una chiave può essere bloccata sull'indirizzo IP del tuo server.
• 1.22: nuovi rilevamenti: Criticals "Jump" (Meteor), ElytraFly "vanilla" usando i razzi, ChestStealer con ritardi casuali (Meteor steal); Blink becca le trattenute da 0,4 s.
• 1.21.2: NoSlow ora becca anche i moduli NoSlow per ragnatele, sabbia delle anime e blocchi di miele. Niente più falsi flag di BadBreak, BadPlace, Phase o FreeCam quando il server rifiuta una rottura o un piazzamento (protezione dello spawn, WorldGuard, claim); niente più falso flag di Jesus uscendo dall'acqua su una riva alla stessa altezza.
• 1.21.1: niente più falsi flag di Blink quando un client (es. Lunar) si blocca un attimo dopo l'ingresso.
• 1.21: config più semplice: solo bstats: true|false e update-checker.enabled; i replay sono sempre conservati 7 giorni; le punizioni partono subito. Le vecchie opzioni vengono tolte da config.yml in automatico.
• 1.20: Mythras ricostruisce il mondo come lo vede il client di ogni giocatore: gli altri giocatori dove li mostra il suo schermo (Reach e KillAura sono più severi sui bersagli in movimento, senza falsi flag per il lag) e la forma reale di lastre, scale, recinzioni e pannelli (Prediction ora giudica anche vicino ai muri).
• 1.19: nuovo check Prediction (Pro): rifà il movimento vanilla di ogni tick con i tasti che il giocatore sta premendo e segnala ciò che nessun input spiega (speed hack leggeri, AirStrafe, BHop "legit"). All'inizio solo alert (checks.prediction.punish-vl: 0): imposta una punizione dopo averlo visto sul tuo server.
• 1.18: Anti-ESP, Anti-XRay e Anti-StorageESP anche su Folia (Pro).
• 1.17: MythrasProxy per Velocity/BungeeCord: alert e ban su tutto il network ([netban]).
• 1.16: pannello clienti sul sito: i tuoi server, alert, punizioni e replay dal browser.
• 1.15: l'IA osserva 20 comportamenti invece di 12; ogni alert dell'IA dice il perché; /ac ai review (Pro) per giudicare i sospetti dell'ultima ora; Mythras Cloud AI usa una rete neurale quando è più precisa. La tua IA mantiene quello che ha già imparato.
• 1.14.1 / 1.14.2: prestazioni: Anti-ESP sul suo thread, meno lavoro per giocatore (il tempo di Mythras sul thread principale è circa un terzo di prima).
• 1.14: Mythras Cloud AI (Pro): un modello globale addestrato su tutti i server Pro, attivo dal primo giorno.

11. Domande frequenti

Un giocatore pulito viene segnalato.

Usa /ac info <player> e /ac debug <player>, poi mandaci il nome del check, i dettagli dell'alert, il client e la versione. Nel frattempo alza il buffer di quel check o metti punish-vl: 0.

Un plugin lancia i giocatori (launch pad, knockback, elytra personalizzate).

Aggiungi il mondo o la regione a exemptions, oppure chiama MythrasAPI.get().exempt(player, millis) dal tuo plugin.

La console dice "License key refused" (chiave rifiutata).

Il messaggio dice il motivo:

• the key does not exist: controlla la chiave;
• revoked (revocata) o expired (scaduta);
• maximum number of servers: una chiave Pro funziona su 1 server; libera i server dall'area clienti o con /license reset;
• IP not allowed: la chiave è bloccata su altri indirizzi IP (cambiali nell'area clienti).

"License server unreachable" (server delle licenze irraggiungibile)

Il server parte con la copia salvata del tuo piano fino a 72 ore. Controlla che la macchina raggiunga https://license.mythras.eu.

Mythras fa laggare il server?

No: i check girano sui thread di rete, Anti-ESP e IA sui loro thread. Con 100 giocatori che combattono, Mythras usa circa 0,3 ms dei 50 ms di un tick. /ac perf mostra quanto tempo usa Mythras per tick sul tuo server.

L'IA ha segnalato un giocatore pulito.

Apri /ac ai review (Pro) e fai shift + click sul giocatore: i suoi combattimenti vengono insegnati all'AI come legit. L'alert dice perché ha segnalato (per esempio very regular clicks): mandacelo con il client del giocatore se continua a succedere.

Supporto

Apri un ticket sul nostro server Discord con la tua chiave (solo la prima parte, per esempio MYTH-ABCD-…), la versione del server, la versione di Mythras e il log della console. Server Discord