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