Plugin Blocksy

Cos'è Blocksy?

Blocksy è un plugin per server Minecraft che permette di ricevere automaticamente i reward quando voti per un server su Blocksy.

Quando voti per un server, il plugin rileva automaticamente il tuo voto e esegue i comandi configurati dall'owner del server, permettendoti di ricevere istantaneamente i premi senza dover inserire codici manualmente.

Come Funziona?

1

Vota il Server

Vota il tuo server preferito dalla lista

2

Entra nel Server

Connettiti al server Minecraft

3

Ricevi il Reward

Il plugin esegue automaticamente i comandi configurati

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 sulla Licenza: La licenza del server deve essere la stessa in tutte le modalità dove installi il plugin Blocksy. Usa la stessa license 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 licenza 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 la Licenza

Una volta approvato il server, vai nella sezione Gestione Server del tuo profilo e clicca su "Richiedi Licenza" per il tuo server. Gli admin approveranno la richiesta.

3

Scarica il Plugin

Dopo l'approvazione della licenza, nella sezione Licenze dei Server del tuo profilo troverai il link per scaricare il plugin Blocksy (.jar)

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

Copia la tua license key dalla sezione Licenze dei Server (clicca su "Visualizza" per vederla) e inseriscila nel file di configurazione insieme ai comandi reward:

# plugins/Blocksy/config.yml
license-key: "TUA-LICENZA-QUI"
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 (licenza, 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 licenza 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 della licenza 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 licenza scade o viene disattivata?

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

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 licenza 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.