Serveur minecraft

API JSON – État du serveur Minecraft – Montage d'un serveur MineCraft – Resoudre les problemes d’un serveur MineCraft

Le 6 juillet 2019 - 6 minutes 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 qui souhaitent intégrer l'état des serveurs Minecraft. Si vous ne devez vérifier que l’état d’un serveur, veuillez vous rendre sur la page principale ici.

Notez s'il vous plaît: Trop de demandes pr. minute à l’API, vous serez bloqué, modérez votre nombre de requêtes!

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

Les données sont ré-ajusté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 $ player.
& # 39 ;; ?>

JavaScript (jQuery)

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

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

Répondre quand 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 -     un serveur, pour tous","Voir les statistiques p u00e5 stats.everpvp.dk"],
"Joueurs":
"en ligne": 2,
"max": 100,
"inscription": ["Spirit55555", "sarsum33"] // inclus uniquement lorsqu'il y a des joueurs
,
"version": "1.12", // peut inclure plusieurs versions ou du texte supplémentaire
"protocole": 332, // inclus uniquement lorsque ping est utilisé, voir plus ici: http://wiki.vg/Protocol_version_numbers
"hostname": "server.mymcserver.tld", // inclus uniquement lorsqu'un nom d'hôte est détecté
"icon": "data: image / png; base64, iVBORw0KGgoAAAANSUhEU ... dSk6AAAAAElFTkSuQmCC", // inclus uniquement 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": // inclus uniquement 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épondre 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 de valeur 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 de défaut a été 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 identique à celui sur lequel le serveur Minecraft est en cours d'exécution, 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 doivent contenir uniquement des enregistrements A / AAAA.
animatedmotd Si un plugin AnimatedMOTD a été détecté. Cela modifie la réponse ping de manière inappropriée. L'API va essayer de compenser, mais cela pourrait ne pas être correct.
proxypipe Si ProxyPipe a été détecté. Ils autoriseront le ping uniquement 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 changement
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 est en cours d'exécution dans Minecraft.

Si le serveur est en cours d'exécution, 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.

S'ils donnent le résultat correct, vous avez peut-être trouvé un bogue dans l'API. Merci de le signaler par e-mail ici: [email protected]

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

Commentaires

Laisser un commentaire

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