AzuriomCMS - Plugin Vote

Intégrer DiscordTop dans Azuriom (plugin Vote)

Cette page explique comment connecter un site Azuriom au système de vote DiscordTop afin de :

• vérifier automatiquement les votes,

• attribuer des récompenses in-game (argent, items, permissions…),

• utiliser external_id pour relier un joueur Minecraft au vote DiscordTop.

Cette intégration utilise uniquement l’interface native d’Azuriom → aucun code supplémentaire n’est requis.

---

Ajouter DiscordTop dans Azuriom

Dans votre panel Azuriom :

Plugins → Vote → Sites

Cliquez sur “Ajouter un site”, puis remplissez les champs comme suit :

---

🔧 Paramètres recommandés

Nom :

DISCORDTOP

URL du site :

(Remplacez GUILD_ID par l’ID de votre serveur DiscordTop)

https://discordtop.net/guild/GUILD_ID/vote?external_id={player}

💡 Important : {player} sera automatiquement remplacé par le pseudonyme du joueur Minecraft. Ce champ permettra à DiscordTop de relier le vote au joueur → et à Azuriom d’attendre la validation API côté DTOP.

---

Activer la vérification des votes

Activez l’option :

✔ Activer la vérification des votes

Puis entrez votre clé API DiscordTop :

Clé d’API : VOTRE_CLE_API_DISCORDTOP

Elle est disponible dans votre dashboard DiscordTop (section Développeur → API) - Trouver ma clé API.

---

Configuration du délai entre les votes

Azuriom gère automatiquement l’intervalle minimal :

Délai fixe entre les votes : 60 minutes

Vous pouvez modifier la valeur au besoin, mais il est fortement recommandé de laisser à 60 minutes.

Attention, le délai minimal entre chaque vote est de 60 minutes côté DiscordTop !

---

Activer le site

Terminez en activant la case :

✔ Activer le site

Puis sauvegardez.

---

Attribution des récompenses

Une fois DiscordTop ajouté dans Azuriom, configurez les récompenses :

Plugins → Vote → Récompenses

Vous pouvez attribuer :

• 💰 de la monnaie (money),

• 🎁 des items,

• 🔧 des commandes personnalisées,

• 🎖 des permissions,

• 🎉 n’importe quel script via les commandes console.

Exemple :

give {player} diamond 3
eco give {player} 250
lp user {player} permission set votant true

🔍 Remarque : Azuriom exécutera les récompenses uniquement si DiscordTop renvoie has_voted = true via l’API. La sécurité est garantie côté DTOP → impossible de tricher en spoofant un vote.

---

Comment DiscordTop valide le vote ?

Azuriom appelle :

GET https://api.discordtop.net/v7/check-vote?external_id={player}

DiscordTop répondra :

👉 Cas 1 : Le joueur a voté

{
  "status": 200,
  "has_voted": true
}

→ Azuriom applique la récompense (en fonction de leurs configurations).

---

👉 Cas 2 : Le joueur n’a pas voté

{
  "status": 404,
  "has_voted": false
}

→ On informe que c'est KO.

---

👉 Cas 3 : Trop de demandes

{
  "status": 429,
  "error": "Rate limit exceeded.",
  "retry_after": 60
}

→ Azuriom réessayera automatiquement plus tard.

---

Configuration finale — Résultat attendu

Une fois terminé, votre page Azuriom ressemble à ceci :

🔹 Nom : DISCORDTOP 🔹 URL : https://discordtop.net/guild/{YOUR_DISCORD_GUILD_ID}/vote?external_id={player} 🔹 Vérification des votes : activée 🔹 Clé d’API : VOTRE_CLE 🔹 Délai entre votes : 60 minutes 🔹 Site activé : oui

Et côté joueurs : Ils votent → DiscordTop vérifie → Azuriom applique les récompenses → tout est automatique 🎉

---

FAQ

➡ Le joueur doit-il être connecté à Discord ?

Non. Le lien external_id={player} permet d’associer le vote via son pseudo.

➡ Puis-je personnaliser les récompenses ?

Oui, complètement. Azuriom exécute vos commandes comme sur un serveur classique.

➡ Faut-il installer un plugin Minecraft spécial ?

Non. Azuriom s’occupe de tout.

➡ Faut-il installer un plugin Azuriom spécial ?

Non. le seul plugin obligatoire est le Plugin Vote.