Cos'è

PunisherX è un plugin di moderazione avanzato per Minecraft che combina la potenza dei comandi di LiteBans con una dashboard web moderna per gestire ban, mute, warn e kick in tempo reale.

📘 PunisherX - Documentazione Ufficiale

🧾 Introduzione

PunisherX è un plugin professionale per server Minecraft che replica in modo completo tutti i comandi e funzionalità di LiteBans, integrando inoltre una dashboard web reattiva per la moderazione da browser.

✔️ Supporta MySQL o SQLite ✔️ Compatibile con LuckPerms e Discord ✔️ Tutti i comandi asincroni ✔️ Design moderno per la dashboard ✔️ Completamente personalizzabile

⚙️ Installazione

  1. Inserisci PunisherX.jar nella cartella /plugins

  2. Avvia il server una prima volta

  3. Configura config.yml e database.yml

  4. Visita la dashboard tramite l’URL configurato

  5. Assegna i permessi ai moderatori (vedi sezione "Permessi")

💬 Comandi Disponibili

Ecco la lista estesa di tutti i comandi supportati da PunisherX:

🔨 Comandi di Moderazione

Comando
Descrizione

/ban <utente> [tempo] [motivo]

Banna un utente permanentemente o temporaneamente

/unban <utente>

Rimuove un ban

/tempban <utente> <tempo> [motivo]

Alias di /ban con durata obbligatoria

/ipban <ip> [tempo] [motivo]

Banna un indirizzo IP

/unipban <ip>

Rimuove un ban IP

/mute <utente> [tempo] [motivo]

Muta un utente in chat

/unmute <utente>

Rimuove un mute

/tempmute <utente> <tempo> [motivo]

Alias di /mute con durata obbligatoria

/kick <utente> [motivo]

Espelle un giocatore dal server

/warn <utente> [motivo]

Invia un avvertimento

/unwarn <utente> [ID WARN]

leva l'avvertimento all'utente

🔎 Comandi di Controllo

Comando
Descrizione

/history <utente>

Mostra tutte le punizioni ricevute da un utente

/checkban <utente>

Controlla se un utente è bannato

/checkmute <utente>

Controlla se un utente è mutato

/checkip <ip>

Controlla se un IP è bannato

/punishments <utente>

Alias alternativo di /history

/alts <utente>

Mostra account alternativi basati su IP

/staffhistory <staff>

Mostra cronologia delle azioni di un moderatore

🛠️ Comandi Plugin/Admin

Comando
Descrizione

/punisherx reload

Ricarica tutta la configurazione

/punisherx help

Mostra tutti i comandi del plugin

/punisherx info

Mostra versione e stato del plugin

/punisherx resetdb

Resetta il database (solo in ambienti di test!)

🛡️ Permission Nodes

Tutti i comandi sono protetti da permission nodes compatibili con LuckPerms:

punisherx.ban
punisherx.unban
punisherx.tempban
punisherx.ipban
punisherx.unipban
punisherx.mute
punisherx.unmute
punisherx.tempmute
punisherx.kick
punisherx.warn
punisherx.unwarn
punisherx.history
punisherx.check
punisherx.checkip
punisherx.reload
punisherx.help
punisherx.info
punisherx.dashboard.access
punisherx.admin.*
punisherx.*

🌐 Dashboard Web

Una delle principali funzionalità di PunisherX è la dashboard moderna per la gestione via browser.

✅ Funzionalità:

  • Live log eventi

  • Sistema di login staff

  • Schede utente con cronologia completa

  • Interfaccia rapida per bannare/mutare

  • Filtri per tipo, motivo, staff

  • Accessi e ruoli configurabili

  • Supporto mobile

🔗 Integrazione Discord:

Puoi configurare webhooks.yml per notificare Discord:

discord:
  enabled: true
  ban-webhook: "https://discord.com/api/webhooks/..."
  mute-webhook: "https://discord.com/api/webhooks/..."
  warn-webhook: "https://discord.com/api/webhooks/..."

🧪 Esempi di Uso

/ban Notch 7d Linguaggio inappropriato
/kick Griefer77 Grief in spawn
/warn Steve Spam in chat
/tempban Alex 1h Flood
/unban Steve
/history Alex

🔗 Compatibilità

  • Minecraft: 1.8.x – 1.20.x

  • Server: Spigot, Paper, Purpur, Folia

  • Database: MySQL 5.7+, MariaDB, SQLite

📦 Funzionalità in Arrivo

  • ✅ Integrazione con Velocity proxy

  • ✅ Interfaccia mobile migliorata

  • ✅ Sistema di appelli automatici

  • ✅ API pubblica per sviluppatori

  • ✅ Supporto multilanguage in dashboard

PreviousLinks

Last updated