Vérification de vote

Nous mettons à votre disposition 3 méthodes différentes qui permettent de vérifier si un joueur a voté pour votre serveur Minecraft. À vous de choisir la méthode la plus adaptée à vos besoins.

 

URL DE VOTE


Pour voter, envoyez vos joueurs sur: https://www.liste-serveurs-minecraft.org/vote/?idc={id du serveur}

Exemple avec pseudo du joueur (facultatif): https://www.liste-serveurs-minecraft.org/vote/?idc=192455&nickname=Jean

 

API GET


En interrogeant notre API vous pouvez vérifier si un joueur a voté pour votre serveur avec son adresse IP. Dans l’exemple ci-dessous nous allons vérifier si le joueur avec l’ip 127.0.0.1 a voté pour le serveur 195050 durant les 180 dernières minutes. Le server_id est visible dans la barre de recherche de votre navigateur lorsque vous éditez votre fiche serveur (eid=?).

Réponse de l’API Définition
0 Le joueur n’a pas voté
1 Le joueur à voté

Ex: https://api.liste-serveurs-minecraft.org/vote/vote_verification.php?server_id=195050&ip=127.0.0.1&duration=180

Si vous ne spécifiez pas l’argument « duration » sa valeur par défaut sera appliquée: 5. Valeur maximale de « duration »: 1440.

<?php
//EXEMPLE AVEC PHP
$vote_verif = file_get_contents('https://api.liste-serveurs-minecraft.org/vote/vote_verification.php?server_id=195050&ip=127.0.0.1&duration=180');

if($vote_verif == 1) {
    echo "Le joueur a voté pour le serveur durant les 180 dernières minutes";
} else if($vote_verif == 0) { 
    echo "Le joueur n'a pas voté pour le serveur durant les 180 dernières minutes"; 
}
?>

 

Votifier


Votifier est un plugin Minecraft qui va détecter et récompenser automatiquement les joueurs qui votent pour votre serveur. Lorsqu’un joueur vote sur votre fiche, liste-serveurs-minecraft.org envoie une requête sécurisée contenant le pseudo et l’ip du joueur. Votifier réceptionne la requête et récompense le joueur.

 

Installation et configuration de Votifier:

 

1) Ouvrez le port 8192

Pour que Votifier puisse réceptionner les requêtes de liste-serveurs-minecraft.org vous devez ouvrir le port 8192 sur la machine où est hébergé votre serveur Minecraft.

 

2) Téléchargez la dernière version du plugin

Si la version de votre serveur le permet téléchargez NuVotifier sur Spigot, sinon téléchargez l’ancien  Votifier sur Bukkit.

Glissez-posez le fichier .jar dans le dossier plugins de votre serveur et redémarrez votre serveur.

 

3) Renseignez la clef publique ou le token

Éditez votre fiche serveur sur liste-serveurs-minecraft.org, renseignez les informations suivantes et enregistrez:

  • Clef publique Votifier: A renseigner uniquement si vous utilisez l’ancien plugin Votifier ou le protocole V1 de NuVotifier (Vous la trouverez dans le fichier plugins/Votifier/rsa/public.key)
  • Token Votifier: A renseigner uniquement si vous utilisez NuVotifier avec le protocole V2 (Vous le trouverez dans le fichier plugins/Votifier/config.yml)
  • Adresse IP Votifier: Il s’agit de l’adresse IP ou du nom de domaine de votre serveur Minecraft (sans le port)
  • Port Votifier: Il s’agit du port utilisé par Votifier visible dans le fichier plugins/Votifier/config.yml (par défaut: 8192)

Si vous avez correctement rempli ces informations vous remarquerez que lorsque vous votez pour le serveur une boîte de dialogue vous informe que vous devez saisir votre pseudo Minecraft et vous indique la marche à suivre.

A ce moment-là le vote est tout de même compatibilité sur votre fiche donc vous ne pouvez plus voter durant les 3 prochaines heures mais si vous avez enregistré votre pseudo dans votre compte, lors de votre prochain vote une requête sera envoyée sur votre serveur et vous recevrez la récompense en jeu.

4) Testez la liaison avec liste-serveurs-minecraft.org

Si vous utilisez l’ancien Votifier, les requêtes seront visibles depuis la console.

Si vous utilisez NuVotifier, ouvrez le fichier plugins/Votifier/config.yml et mettez debug: true

 

5) Installer un plugin de récompense

Téléchargez et installez le plugin Give Anything ListenerCe plugin communiquera avec Votifier dès son installation, vous n’avez aucune manipulation à effectuer. Configurez simplement les commandes et les messages de récompense.

 

Vote_response.php


Le fichier vote_response.php sera hébergé sur votre site web. Lorsqu’un joueur valide son vote sur votre fiche serveur, liste-serveurs-minecraft.org envoie une requête http avec l’ip du joueur et son pseudo.

 

Étapes d’installation:

 

1) Créez le fichier vote_response.php

Copiez-collez le code ci-dessous dans un fichier php avec un éditeur comme notepad++ et renseignez le numéro ID de votre fiche serveur.
Le ID (eid=) est visible dans la barre de recherche de votre navigateur lorsque vous éditez votre fiche.

Ex: http://www.liste-serveurs-minecraft.org/ajout-serveur/?eid=191904

<?php
define("SERVER_ID", 96); //Saisissez le ID de votre fiche serveur
define("DEBUG", 1); //Mettre 1 pour activer le debug ou 0 pour désactiver
define("LOG_FILE", "_postback.log"); //Si debug est sur 1, un fichier log sera créé

//On vérifie si la requête vient de Liste-serveurs-minecraft.org
$lsm_ip = file_get_contents('http://www.liste-serveurs-minecraft.org/get_ip.php');

if($_SERVER['REMOTE_ADDR'] == $lsm_ip) {

    //On vérifie l'ID du serveur
    if($_GET['server_id'] == SERVER_ID) {

        //On récupère les infos du vote
        $player = $_GET['player'];
        $user_ip = $_GET['user_ip'];

        if(DEBUG == true) {
         error_log(date('[Y-m-d H:i] ')."[VOTE OK] [player]=$player [ip]=$user_ip".PHP_EOL, 3, LOG_FILE);
        }

        //AJOUTEZ VOTRE CODE ICI
        //Vous pouvez par exemple contrôler si ce joueur existe dans votre base de données
        //Vérifier si le joueur a déjà voté durant les 3 dernières heures
        //Interroger la base de données depuis votre serveur et récompenser le joueur

    } else {
        if(DEBUG == true) {
         error_log(date('[Y-m-d H:i] ')."[ID INVALIDE] L'ID du serveur ne correspond pas".PHP_EOL, 3, LOG_FILE);
        }
    }

} else {
    if(DEBUG == true) {
     error_log(date('[Y-m-d H:i] ')."[IP INVALIDE] La requête ne vient pas de Liste-serveurs-minecraft.org".PHP_EOL, 3, LOG_FILE);
    }
}

?>

2) Enregistrez le fichier vote_response.php et placez-le dans un dossier de votre site web

Ex: http://www.votre-site.fr/vote/vote_response.php

 

3) Renseignez le champ « Url de vérification des votes »

Vous trouverez ce champ dans le formulaire de modification de votre fiche serveur dans « Détails ». Indiquez-y l’adresse URL complète de « vote_response.php ».