# ShieldPlay — Anti-Cheat Minecraft con evidenze verificabili > ShieldPlay è una piattaforma anti-cheat evidence-first per server Minecraft compatibili con Paper. Aiuta Owner e staff a raccogliere segnali contestualizzati, analizzare violazioni e prendere decisioni di revisione informate senza trasformare automaticamente ogni flag in un ban. ## Descrizione del prodotto ShieldPlay collega un agente Minecraft Paper a un dashboard centralizzato. L’agente raccoglie eventi e contesto operativo dal server; il backend conserva le violazioni e il dashboard permette allo staff autorizzato di esaminare giocatori, server, evidenze, incidenti, punizioni e webhook. Il prodotto distingue tra raccolta di dati, flag, revisione staff e sanzione. I segnali euristici o con evidenza incompleta restano review-only e non devono essere trattati come prova conclusiva di cheating. ## Funzionalità principali ### Rilevamento comportamentale - Controlli organizzati per movimento, combattimento, reach, hitbox, pacchetti, timer, frequenza pacchetti e X-Ray. - Correlazione di segnali e soglie contestuali invece di decisioni basate su un singolo evento. - Esclusioni per condizioni instabili come ping elevato, TPS ridotto, transizioni di movimento e stati speciali del giocatore quando applicabili. - Configurazione locale dell’agente tramite `config.yml`, con ricarica a caldo per le impostazioni supportate. ### Evidenze e revisione - Violazioni associate a giocatore, UUID, server, controllo, timestamp, confidence e metriche tecniche disponibili. - Contesto operativo per aiutare lo staff a interpretare ping, TPS, stato agente e qualità del campione. - Hitbox geometrica ray-versus-expanded-AABB e pattern X-Ray conservativo, entrambi destinati alla revisione. - Statistiche aggregate dei flag X-Ray per giocatore, minerale e combinazione giocatore-minerale, con distinzione tra dettaglio completo e storico legacy. ### Gestione server e staff - Gestione multi-server da un’unica organizzazione. - API key specifica per server e heartbeat dell’agente. - Roster staff Minecraft configurabile dall’Owner. - Esenzioni esatte per singolo staff member e singolo controllo, senza wildcard. - GUI Minecraft con lingua italiana o inglese configurabile. ### Notifiche e integrazioni - Webhook generici per eventi ShieldPlay. - Notifiche Discord per flag X-Ray con embed, template, colore e cooldown configurabili dall’agente. - Rate limiting persistente lato backend per ridurre notifiche duplicate. - Test del webhook dal dashboard senza dover generare un flag in gioco. ### Operatività e sicurezza - Replay offline scaglionato e backpressure HTTP per gestire temporanei problemi di rete. - Controlli di accesso per organizzazione e ruoli dashboard. - Flussi di unban persistiti e propagati al profilo Paper quando applicabile. - Metriche e log destinati al supporto operativo; non inserire API key, password o URL webhook nei ticket o nei log pubblici. ## Installazione rapida 1. Scaricare l’agente Paper dalla pagina ufficiale di download. 2. Arrestare il server e copiare il JAR nella cartella `plugins`. 3. Avviare il server e configurare `plugins/AntiCheatSaaS/config.yml` con l’API key specifica del server. 4. Verificare connessione e heartbeat dal dashboard. 5. Controllare la configurazione dei controlli e mantenere review-only i segnali che non dispongono di evidenza sufficiente. ## Configurazione X-Ray e Discord Le impostazioni locali supportate sono sotto `notifications.discord.xray` e comprendono `enabled`, `embed.title`, `embed.description`, `embed.color` e `rate-limit.cooldown-seconds`. Dopo aver salvato YAML valido, eseguire `/anticheat reload` con il permesso `anticheat.admin`. Il reload aggiorna template, colore, abilitazione e cooldown degli alert X-Ray successivi. URL del webhook e iscrizione agli eventi sono invece gestiti dal dashboard/backend e non vengono letti dal file YAML locale. Il cooldown effettivo è limitato all’intervallo operativo 15–600 secondi. ## Policy di affidabilità Un flag non equivale automaticamente a un ban. Prima di agire, lo staff deve verificare evidenze, durata del campione, ping, TPS, contesto del server, precedenti eventi e possibili spiegazioni legittime. Non usare Hitbox, X-Ray, Timer, Packet Frequency o altre euristiche review-only come unica base per una sanzione automatica. Le prestazioni, la copertura e l’accuratezza dipendono dalla versione Paper, dalla configurazione, dal contesto del server e dalla qualità dei dati raccolti. ShieldPlay non deve essere descritto come infallibile o come sostituto della revisione umana. ## Risorse ufficiali - [Home ShieldPlay](https://www.shieldplay.it/en) - [Documentazione](https://www.shieldplay.it/en/documentation) - [API HTTP](https://www.shieldplay.it/en/api) - [Download agente Paper](https://www.shieldplay.it/en/download) - [Changelog](https://www.shieldplay.it/en/changelog) - [Stato dei servizi](https://www.shieldplay.it/en/status) - [Contatti e supporto](https://www.shieldplay.it/en/contact) - [Prezzi](https://www.shieldplay.it/en/#pricing) ## Riferimento tecnico - Progetto: ShieldPlay - Ambito corrente: anti-cheat per server Minecraft Paper - Versione agente pubblica: `0.1.0` - Java agente: `21` - Paper API di riferimento: `1.21` - Lingue dashboard: italiano e inglese - Lingue GUI agente: italiano e inglese - Modalità decisionale: review-first; i segnali euristici non sono automaticamente sanzionatori ## Aggiornamento del documento Questo file descrive le capacità pubbliche del progetto alla data di pubblicazione della build corrente. Per dettagli operativi e modifiche recenti consultare la documentazione e il changelog ufficiali.