Plugin Blocksy

Cos'è Blocksy?

Blocksy è un plugin avanzato per server Minecraft (Spigot/Paper) che automatizza completamente la gestione dei voti. Utilizza un sistema di polling API per recuperare i voti dal sito e si integra con NuVotifier per la massima compatibilità.

Quando un giocatore vota per il tuo server su Blocksy, il plugin:

Rileva automaticamente il voto tramite API (nessuna configurazione porte necessaria)
Crea un evento Votifier standard che tutti i plugin compatibili possono ricevere
Esegue i comandi reward configurati dall'owner del server
Consegna i premi istantaneamente al giocatore (se online) o al prossimo login

Zero configurazione di rete richiesta - funziona ovunque, anche dietro NAT o proxy!

Come Funziona il Sistema?

Architettura del Sistema

Blocksy utilizza un sistema di polling API moderno e affidabile che elimina la necessità di configurare porte o firewall. Il plugin si integra perfettamente con NuVotifier, rendendolo compatibile con tutti i plugin che supportano Votifier.

Vantaggi:

✅ Nessuna configurazione porte o firewall
✅ Funziona dietro NAT e proxy
✅ Compatibile con tutti i plugin Votifier
✅ Sistema affidabile al 100%
✅ Facile da configurare

Flusso del Voto

1

Voti sul Sito

Il voto viene salvato nel database con stato "pendente"

2

Plugin Fa Polling

Ogni 15 secondi il plugin controlla se ci sono nuovi voti tramite API

3

Evento Votifier

Il plugin crea un evento Votifier che viene ricevuto da tutti i plugin compatibili

4

Reward Automatici

I comandi configurati vengono eseguiti e ricevi i premi istantaneamente

Sistema API Key

Ogni server ha una API key univoca di 64 caratteri che il plugin usa per autenticarsi con il sito. Questa chiave sostituisce il vecchio sistema di licenze ed è molto più semplice da gestire.

Nota: Solo gli amministratori del sito possono generare le API keys. Se sei un owner di un server, contatta un admin per richiedere la tua API key.

Integrazione con Votifier

Blocksy si integra nativamente con NuVotifier, il sistema standard per gestire i voti nei server Minecraft. Questo significa che:

Tutti i plugin che supportano Votifier funzioneranno automaticamente
Puoi usare plugin come VotingPlugin, SuperbVote, GAListener insieme a Blocksy
Gli eventi di voto vengono gestiti in modo standard e compatibile
Non serve configurare Votifier direttamente - Blocksy lo fa per te

Server con Più Modalità

Importante: Se il plugin Blocksy è installato su più server o modalità (es. Survival, Skyblock, Creative), i comandi reward verranno eseguiti nel primo server dove entri o dove sei già presente dopo aver votato.

Comandi Personalizzati per Modalità:

Ogni modalità può avere la propria configurazione di comandi reward. Il plugin eseguirà automaticamente i comandi configurati nella modalità specifica dove il giocatore si trova o entra per primo.

Nota sull'API Key: L'API key del server deve essere la stessa in tutte le modalità dove installi il plugin Blocksy. Usa la stessa api-key nel config.yml di ogni modalità.

Esempio:

Hai votato per "MioServer" che ha 3 modalità: Survival, Skyblock e Creative
Tutte e 3 le modalità hanno il plugin Blocksy installato con la stessa API key ma comandi diversi:
- Survival: give %player% diamond 5
- Skyblock: is level add %player% 100
- Creative: eco give %player% 1000
Se sei già connesso a Survival, riceverai 5 diamanti
Se entri prima in Skyblock, riceverai 100 livelli isola
Se entri prima in Creative, riceverai 1000 monete

In questo modo puoi offrire reward personalizzati e bilanciati per ogni modalità del tuo network!

Installazione (Per Owner)

1

Registra il tuo Server

Registrati su Blocksy e aggiungi il tuo server dalla dashboard. Attendi l'approvazione degli amministratori.

2

Richiedi l'API Key

Una volta approvato il server, contatta un amministratore per richiedere l'API key del tuo server. Gli admin la genereranno tramite il pannello di controllo.

3

Scarica il Plugin

Scarica il plugin Blocksy (.jar) direttamente da questa pagina o dal tuo profilo.

4

Installa sul Server

Copia il file Blocksy.jar nella cartella plugins del tuo server Minecraft e riavvia il server per generare il file di configurazione.

5

Configura il Plugin

Ricevi l'API key dall'amministratore e inseriscila nel file di configurazione insieme ai comandi reward:

# plugins/Blocksy/config.yml
api-key: "TUA-API-KEY-QUI"
check-interval: 15
commands:
  - "give %player% diamond 5"
  - "eco give %player% 1000"
  - "broadcast %player% ha votato per il server!"

6

Riavvia e Testa

Riavvia il server Minecraft per applicare le modifiche. Il plugin è ora attivo e pronto a distribuire reward automaticamente!

Vantaggi

Automatico

Nessun codice da inserire manualmente

Sicuro

Sistema verificato e protetto

Istantaneo

Reward ricevuti immediatamente

Personalizzabile

Configura i comandi come preferisci

Comandi Plugin

Il plugin Blocksy include i seguenti comandi per gli amministratori del server:

# Comandi disponibili (solo per OP/Admin)
/blocksy help                  - Mostra l'elenco dei comandi disponibili
/blocksy debug                 - Mostra informazioni di debug (API key, endpoint, stato)
/blocksy reload                - Ricarica la configurazione del plugin
/blocksy interval <secondi>    - Imposta l'intervallo di controllo voti (10-3600 secondi)

# Alias disponibili
/bl                            - Alias breve per /blocksy
/blocksyadmin                  - Alias alternativo per /blocksy

Nota: I comandi sono disponibili solo per gli operatori del server o utenti con i permessi blocksy.admin, blocksy.debug, blocksy.reload o blocksy.interval.

Sistema Automatico: Il plugin controlla automaticamente i voti pendenti e distribuisce le ricompense senza bisogno di comandi manuali. I comandi sono utili solo per configurazione e debug.

Domande Frequenti

Il plugin è gratuito?

Sì, il plugin Blocksy è gratuito per tutti i server registrati su Blocksy.

Funziona con Spigot/Paper/Purpur?

Sì, il plugin è compatibile con tutte le versioni moderne di Spigot, Paper, Purpur e derivati.

Quali versioni di Minecraft sono supportate?

Il plugin supporta Minecraft dalla versione 1.16 in poi. Consigliamo di usare sempre l'ultima versione stabile del server.

Posso personalizzare i reward?

Assolutamente! Puoi configurare qualsiasi comando nel file di configurazione del plugin. Puoi dare item, soldi, permessi, eseguire script personalizzati e molto altro.

Cosa succede se il giocatore è offline?

Il reward viene salvato e consegnato automaticamente quando il giocatore si connette al server. Non si perde nulla!

Devo installare il plugin su tutte le modalità del mio network?

Sì, se vuoi che i reward vengano consegnati su tutte le modalità. Ricorda di usare la stessa API key ma puoi configurare comandi diversi per ogni modalità.

Il plugin funziona con BungeeCord/Velocity?

Sì! Il plugin funziona perfettamente con network BungeeCord e Velocity. Installa il plugin su ogni server del network dove vuoi consegnare reward.

Come faccio a sapere se il plugin funziona?

Dopo l'installazione, controlla la console del server per messaggi di conferma. Puoi anche usare il comando /blocksy debug per verificare lo stato dell'API key e la configurazione.

Il plugin rallenta il server?

No, Blocksy è ottimizzato per avere un impatto minimo sulle performance. Usa chiamate API asincrone e non blocca il thread principale del server.

Posso usare placeholder nei comandi?

Sì! Puoi usare %player% per il nome del giocatore. Se hai PlaceholderAPI installato, puoi usare anche tutti i suoi placeholder.

Cosa succede se la mia API key viene disattivata?

Il plugin smetterà di funzionare e i reward non verranno più consegnati. Contatta gli amministratori di Blocksy per risolvere eventuali problemi con l'API key.

Posso vedere quanti reward sono stati consegnati?

Il plugin registra automaticamente tutte le consegne nei log del server. Puoi monitorare l'attività controllando i log della console o usando il comando /blocksy debug per vedere informazioni sul sistema.

Il plugin supporta più server con lo stesso IP ma porte diverse?

Sì, ogni server registrato su Blocksy ha la sua API key univoca, indipendentemente dall'IP o dalla porta.

Dove posso trovare supporto se ho problemi?

Contatta gli amministratori di Blocksy tramite il forum o i canali di supporto ufficiali. Fornisci sempre i log del server per una diagnosi più rapida.