Serveur minecraft

API JSON – État du serveur Minecraft – Monter un serveur MineCraft

Le 3 mai 2019 - 1 minute de lecture

Bienvenue dans l'API JSON de Minecraft Server Status. Cette API combine les protocoles Ping et Query en une seule sortie JSON.

Notez s'il vous plaît: Cette page est destinée aux développeurs souhaitant intégrer l’état des serveurs Minecraft. Si vous avez seulement besoin de vérifier l’état d’un serveur, veuillez vous rendre à la page principale ici.

Notez s'il vous plaît: Trop de demandes pr. minute à l'API vous obtiendrez bloqué, modérez donc votre nombre de demandes!

Utiliser l'API

Utilisez le noeud final suivant pour obtenir le statut d'un serveur: https: /api.mcsrvstat.us/2/

Les données sont ré-accordées comme application / json et est actuellement mis en cache pendant 30 secondes.

Si une adresse fonctionne dans Minecraft, elle fonctionne avec cette API. Si vous ne spécifiez pas de port, l'API le trouvera. Les enregistrements SRV sont également pris en charge.

Exemples

PHP

version;

// Afficher une liste de joueurs
foreach ($ status-> players-> list as $ player) 
echo $ joueur.
'; ?>

JavaScript (jQuery)

// Obtenir le statut
$ .getJSON ('https://api.mcsrvstat.us/2/domain.tld', fonction (statut) 
// Afficher la version
console.log (status.version);

// Afficher une liste de joueurs
$ .each (status.players.list, fonction (index, lecteur) 
console.log (lecteur);
);
);

Réponse lorsque le serveur est en ligne


"online": vrai,
"ip": "127.0.0.1",
"port": 25567,
"debug": // Voir la section ci-dessous pour plus d'informations sur les valeurs
"ping": vrai,
"query": true,
"srv": true,
"querymismatch": false,
"ipinsrv": false,
"animatedmotd": false,
"proxypipe": false,
"cachetime": 1518553220
,
"motd": 
"brut": ["u00a7cEveru00a7ru00a79PvP u00a7ru00a77- u00a7ru00a72u00c9n server, for alle", "u00a7ru00a7fSe dine stats pu00e5 u00a7ru00a76stats.everpvp.dku00a7r"],
"nettoyer": ["EverPvP - u00c9n server, for alle", "Se dine stats pu00e5 stats.everpvp.dk"],
"html":["["["["DéjàPvP -  u00c9n serveur, pour tous","Voir les statistiques p  u00e5 stats.everpvp.dk"],
"joueurs": 
"en ligne": 2,
"max": 100,
"liste": ["Spirit55555", "sarsum33"] // inclus uniquement lorsqu'il y a des joueurs
,
"version": "1.12", // Peut inclure plusieurs versions ou du texte supplémentaire
"protocole": 332, // Uniquement inclus lorsque ping est utilisé, voir plus ici: http://wiki.vg/Protocol_version_numbers
"hostname": "server.mymcserver.tld", // Uniquement inclus lorsqu'un nom d'hôte est détecté
"icon": "data: image  / png; base64, iVBORw0KGgoAAAANSUhEU ... dSk6AAAAAElFTkSuQmCC", // Uniquement inclus lorsqu'une icône est détectée
"logiciel": "BungeeCord", // inclus uniquement lorsque le logiciel est détecté
"map": "MyMcWorld", // inclus uniquement lorsque la valeur n'est pas "world"
"plugins": // Uniquement lorsque des plugins sont détectés
"des noms": ["WordEdit", "WorldGuard"],
"brut": ["WordEdit 6.1.5", "WorldGuard 6.2"]
	,
"mods": // Uniquement inclus lorsque des mods sont détectés
"des noms": ["BiomesOPlenty", "MoreFurnaces"],
"brut": ["BiomesOPlenty 2.1.0", "MoreFurnaces 1.3.9"]
	,
"info": // Uniquement inclus pour détecter que les échantillons du lecteur sont utilisés à titre d'information
"brut": ["u00a77u00bb u00a7cKitPvP u00a77:: u00a7f1 u00a77online", "u00a77u00bb u00a7bSurvivalGames u00a77:: u00a7f0 u00a77online"],
"nettoyer": ["u00bb KitPvP :: 1 online", "u00bb SurvivalGames :: 0 online"],
"html":["["["[" u00bb KitPvP :: 1 en ligne"," u00bb Jeux de survie :: 0 en ligne"]

Réponse lorsque le serveur est hors ligne


"en ligne": faux,
"ip": "127.0.0.1", // Peut être vide
"port": 25567, // pourrait être vide
"debug": // Voir la section ci-dessous pour plus d'informations sur les valeurs
"srv": true,
"ipinsrv": false,
"cachetime": 1518553220
,
"hostname": "non-working.mymcserver.tld" // Uniquement inclus lorsqu'un nom d'hôte est détecté

Informations sur les valeurs de débogage

prénom La description
ping Si le protocole SLP (Server List Ping) a été utilisé. Ajouté dans la version 1.7 et ne peut pas être désactivé.
question Si le protocole de requête a été utilisé. La valeur par défaut est désactivée.
srv Si un enregistrement de service (SRV) a été détecté et utilisé. Ils utilisent le format suivant: _minecraft._tcp.domain.tld
requêtemismatch Si le port de jeu renvoyé par le protocole de requête n'est pas le même que celui sur lequel le serveur Minecraft est exécuté, l'API suppose que la requête provient d'un autre serveur.
Vous devez toujours définir le même port de requête que le serveur Minecraft.
ipinsrv Si une adresse IP a été détectée dans l'enregistrement SRV. Les enregistrements SRV ne doivent contenir que des enregistrements A / AAAA.
animatedmotd Si un plugin AnimatedMOTD a été détecté. Cela modifie la réponse du ping de manière inappropriée. L'API essaiera de compenser, mais cela pourrait ne pas être correct.
proxypipe Si ProxyPipe a été détecté. Ils n'autoriseront le ping que sur le nom d'hôte, ce qui ralentira un peu le temps de recherche.
cachetime Horodatage UNIX de l'heure à laquelle le résultat a été mis en cache. Renvoie 0 lorsque le résultat n'est pas mis en cache.

Changelog

Version Changements
2 hors ligne: true a été retiré de la réponse hors ligne et remplacé par en ligne: faux
en ligne: vrai est maintenant renvoyé lorsque le serveur est en ligne.
1 Version initiale.

Problèmes?

Si l'API ne donne pas le résultat correct, ou peut-être aucun résultat, veuillez d'abord vérifier si le serveur fonctionne dans Minecraft.

Si le serveur fonctionne, essayez les points de terminaison de débogage suivants pour ping et requête:

Notez s'il vous plaît: Utilisez ces terminaux uniquement à des fins de débogage. Utilisez l'API principale pour une utilisation quotidienne normale.

  • https: /api.mcsrvstat.us/ping/
  • https: /api.mcsrvstat.us/query/

S'ils donnent la sortie correcte, vous avez peut-être trouvé un bogue dans l'API. S'il vous plaît le signaler par e-mail ici: [email protected]


Droits d'auteur © 2019 Anders G. Jørgensen – spirit55555.dk – API-MCSRVSTATUS-60862ac

mcsrvstat.us

Commentaires

Laisser un commentaire

Votre commentaire sera révisé par les administrateurs si besoin.