Premi i voti dei tuoi giocatori

Tre modi per collegare CraftRank al tuo server. Scegli quello più adatto al tuo plugin: è anche possibile combinarli tra loro.

1. Votifier (NuVotifier)

Installa NuVotifier sul tuo server (o sul tuo proxy BungeeCord / Velocity), quindi il tuo plugin preferito per i premi. Nel modulo del server, nella sezione “Premi per i voti”:

  • Presentatore : l'indirizzo pubblico del tuo server (senza http://).
  • Porto : La porta di NuVotifier (8192 per impostazione predefinita) deve essere aperta sul tuo host.
  • Token : plugins/Votifier/config.yml → tokens: default: (protocollo v2, consigliato).
  • Oppure chiave pubblica : plugins/Votifier/rsa/public.key per il vecchio Votifier o per un server di inoltro che supporta solo il protocollo v1.

Il protocollo viene selezionato automaticamente: v2 con il token, se il server lo supporta; altrimenti v1 con la chiave pubblica. Il pulsante “Invia un voto di prova” verifica tutto con un solo clic. Ai giocatori Bedrock (Geyser / Floodgate) viene inviato il loro nome utente, punto compreso.

2. API HTTP

Crea una chiave API nel tuo server. Tienila segreta: utilizzala solo dal tuo server, mai in una pagina web. La chiave può essere inviata come parametro "key" o nell'intestazione "Authorization: Bearer".

Hanno votato?

GET https://craftrank.fr/api/v1/vote/check?key=VOTRE_CLE&username=Steve

{ "voted": true, "claimed": false, "voted_at": 1759480000000, "next_vote_at": 1759566400000 }

Concedi la ricompensa una sola volta

Ritorni richiesti: "true" solo una volta per voto: non è possibile premiare lo stesso voto due volte.

GET https://craftrank.fr/api/v1/vote/claim?key=VOTRE_CLE&username=Steve

{ "claimed": true }                              ← dare la ricompensa
{ "claimed": false, "reason": "already_claimed" } ← già premiato
{ "claimed": false, "reason": "no_vote" }         ← Nessun voto nelle ultime 24 ore

Voti più recenti (per un plugin che rileva i voti)

GET https://craftrank.fr/api/v1/votes?key=VOTRE_CLE&since=1759480000000

{ "votes": [ { "username": "Steve", "timestamp": 1759480123000, "claimed": false } ], "now": 1759480200000 }

Esempio di script

command /voterecompense:
  trigger:
    set {_r} to text from "https://craftrank.fr/api/v1/vote/claim?key=VOTRE_CLE&username=%player%"
    if {_r} contains """claimed"":true":
      give player 1 diamond
      send "&aMerci pour ton vote !"
    else if {_r} contains "already_claimed":
      send "&eRécompense déjà récupérée, reviens demain !"
    else:
      send "&cVote sur craftrank.fr puis refais /voterecompense"

Ti serve un add-on per Skript in grado di effettuare richieste HTTP: adatta la riga “set {_r}” alla sintassi del tuo add-on.

Limite: 300 richieste al minuto. Un voto rimane valido per 24 ore, come sul sito.

3. Webhook

Inserisci un URL nel modulo del tuo server: ad ogni voto, CraftRank lo chiama con un POST e questo corpo JSON:

POST https://monserveur.fr/craftrank-vote
Content-Type: application/json
X-CraftRank-Signature: sha256=…

{ "event": "vote", "server": { "id": 12, "slug": "mon-serveur", "name": "Mon serveur" }, "username": "Steve", "timestamp": 1759480123000 }

Controlla la firma per assicurarti che la richiesta provenga da CraftRank: si tratta dell'HMAC-SHA256 del corpo grezzo, con la tua chiave API.

// Node.js
const sig = 'sha256=' + crypto.createHmac('sha256', CLE_API).update(rawBody).digest('hex');
if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(req.get('X-CraftRank-Signature') || ''))) return res.sendStatus(401);

// PHP
$sig = 'sha256=' . hash_hmac('sha256', file_get_contents('php://input'), CLE_API);
if (!hash_equals($sig, $_SERVER['HTTP_X_CRAFTRANK_SIGNATURE'] ?? '')) { http_response_code(401); exit; }

Rispondere con un codice 2xx entro 8 secondi (i reindirizzamenti vengono seguiti). Il voto di prova inserito nel modulo invia anche una richiesta con "event": "test". Il risultato dell'ultima richiesta viene visualizzato sotto il campo webhook.

Mostra i voti in un canale di Discord

Incolla direttamente l'URL del webhook di Discord (Impostazioni canale → Integrazioni → Webhook → Nuovo webhook → Copia URL): CraftRank pubblica un messaggio nel canale per ogni voto, indicando il nome del giocatore e il conteggio dei voti del mese. Non occorre scrivere codice.

Aggiungi il mio server