SonoNiko
Plugin / DiscordLink / Documentazione

Documentazione DiscordLink

Installazione, comandi, permessi e configurazione.

Requisiti

  • Server Paper 1.21 o superiore, Java 21+
  • LuckPerms (consigliato; con altri plugin dei permessi vedi Configurazione)
  • SonoNiko Tickets nel tuo server Discord con il Premium attivo

Installazione

  1. Aggiungi SonoNiko Tickets al tuo server Discord da tickets.sononiko.it e attiva il premium.
  2. Nella dashboard apri il server → Integrazioni → Crea chiave API. Copiala subito: viene mostrata una volta sola. Se usi già il ReportSystem, puoi usare la stessa chiave.
  3. Copia DiscordLink-1.0.0.jar nella cartella plugins/, avvia il server una volta e fermalo.
  4. In plugins/DiscordLink/config.yml inserisci la chiave di licenza e la chiave API:
license-key: "SN-XXXXX-XXXXX-XXXXX-XXXXX"
api-key: "tb_..."
  1. Riavvia. In console deve comparire Licenza verificata e DiscordLink attivo.
  2. Nella dashboard apri Minecraft, attiva il collegamento e aggiungi i gruppi da sincronizzare.

Licenza

Dopo l'acquisto trovi la chiave in Area clienti → Licenze su sononiko.it. Senza una chiave valida il plugin si disattiva all'avvio. Se cambi hosting usa "Cambia IP / server" nell'area clienti (fino a 3 volte).

Come si collega un account

  1. In game il giocatore scrive /link e riceve un codice di 6 caratteri (valido 10 minuti, cliccabile per copiarlo).
  2. Su Discord scrive /link CODICE. Chi usa Discord in italiano vede il comando come /collega.
  3. Fatto: ruoli e gradi si aggiornano subito o al prossimo giro di sincronizzazione.

Per scollegarsi: /unlink in game oppure /unlink (/scollega) su Discord.

Gruppi e ruoli

Le mappature si impostano in Dashboard → Minecraft:

Direzione Esempio Cosa succede
Minecraft → Discord vip → @VIP Chi ha il gruppo in game riceve il ruolo; lo perde quando perde il gruppo
Discord → Minecraft @Booster → booster Chi ha il ruolo riceve il gruppo in game; lo perde quando perde il ruolo
  • Il plugin toglie solo i gruppi che ha dato lui (li ricorda in plugins/DiscordLink/granted.yml).
  • Il bot può assegnare solo i ruoli che stanno sotto il suo: in Impostazioni server → Ruoli sposta il ruolo del bot sopra @VIP, @Verificato ecc.
  • Nella stessa pagina puoi scegliere un ruolo per chiunque colleghi l'account (es. @Verificato).

Comandi

Comando Descrizione Permesso
/link Ricevi il codice per collegare l'account discordlink.link
/unlink Scollega l'account discordlink.link
/discordlink reload Ricarica il config discordlink.admin
/discordlink sync Sincronizza subito tutti i giocatori online discordlink.admin

/collega e /scollega sono alias di /link e /unlink.

Comandi su Discord

Comando Italiano Descrizione
/link <codice> /collega Collega l'account
/unlink /scollega Scollega l'account
/minecraft @utente /minecraft Mostra l'account Minecraft di un utente (solo staff)

Permessi

Permesso Cosa fa Default
discordlink.link Usare /link e /unlink tutti
discordlink.admin Ricaricare e forzare la sincronizzazione op

Configurazione

  • api-url: lascia https://tickets.sononiko.it.
  • api-key: la chiave creata in Integrazioni.
  • sync-interval-minutes: ogni quanti minuti sincronizzare i giocatori online (1–60, default 5). Chi entra viene sincronizzato subito.
  • groups.add-command / groups.remove-command: comandi per dare e togliere i gruppi. Di default usano LuckPerms; con un altro plugin dei permessi cambiali ({uuid}, {player}, {group}).
  • rewards.enabled e rewards.commands: premi dati una sola volta al primo collegamento ({player}, {uuid}, {discord}).
  • messages: tutti i testi, con codici colore &.

Premio di esempio:

rewards:
  enabled: true
  commands:
    - "give {player} diamond 5"
    - "broadcast {player} ha collegato il suo account Discord!"

Risoluzione problemi

  • "Licenza non valida" all'avvio → verifica la chiave e usa "Cambia IP / server" nell'area clienti.
  • "manca api-key" → crea la chiave in Integrazioni e incollala in api-key, poi /discordlink reload.
  • In console: chiave API non valida o revocata → generane una nuova in Integrazioni.
  • In console: premium non attivo → attiva il premium di SonoNiko Tickets sul server Discord.
  • "Il collegamento con Discord non è attivo" → attivalo in Dashboard → Minecraft.
  • Il ruolo non viene dato su Discord → sposta il ruolo del bot sopra quel ruolo.
  • Il gruppo non viene dato in game → controlla che LuckPerms sia installato e che il gruppo esista (/lp listgroups).