Minehut.Net
1.0.0
Ce projet permet une intégration facile à votre compte/serveur minehut. Il inclut toutes les fonctionnalités de l'API backend de minehut, y compris la possibilité de créer/vérifier des comptes.
Ce projet a été écrit en Visual Basic, mais comme il s'agit d'une bibliothèque .NET, son utilisation en C# ne fait aucune différence.
La première partie que vous devrez connaître, la majeure partie de cette bibliothèque se trouve dans MinehutAPIClient
La plupart des fonctionnalités de l'API minehut nécessiteront une connexion afin que vous puissiez accéder à vos serveurs. Pour ce faire, utilisez la méthode Login(). Pour la plupart des fonctions contenues dans cette classe, il est recommandé d'importer la classe Minehut.Types.
using Minehut . Types ;Cela authentifiera le client auprès de l'API minehut, vous permettant de travailler avec vos serveurs. C#
MinehutApiClient Minehut = New MinehutApiClient ( ) ;
Minehut . Login ( "[email protected]" , "SuperSecretPassword" ) ;En utilisant cette fonction, vous pouvez accéder à tous les serveurs publics Minehut actuellement en cours d'exécution. Ces serveurs sont renvoyés sous forme de IList de type Server. (Dans Minehut.Types)
IList < Server > servers = Minehut . GetServers ( ) ;Ceci récupère les ID de vos serveurs, ces ID sont utilisés pour spécifier quel serveur vous souhaitez affecter avec d'autres fonctions/méthodes.
String [ ] MyServers = Minehut . GetSelfServers ;Cette fonction récupérera tous les plugins disponibles sur minehut.
IList < Plugin > Plugins = Minehut . GetPlugins ( ) ;Cela obtiendra des informations détaillées sur le serveur spécifié. Il nécessite un identifiant de serveur et renverra des informations sur le serveur.
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
ExtendedServer ExtendedServerInformation = Minehut . GetServerByID ( Server1ID ) ;Cette fonction renverra les informations de sauvegarde sous la forme GetServerByID(), mais elle utilise le nom du serveur au lieu de l'ID du serveur.
ExtendedServer ExtendedServerInformation = Minehut . GetServerByID ( "Skyblock" ) ;Grâce à cette fonction, vous pouvez récupérer les fichiers stockés dans le cadre de votre serveur Minecraft. Chaque fichier est stocké en tant qu'objet ServerFile (dans Minehut.Types). Ces objets contiennent :
Vous devez spécifier l'ID du serveur et, éventuellement, vous pouvez également spécifier le chemin. Par défaut, il renverra les fichiers stockés dans le répertoire racine du serveur.
Pour obtenir les fichiers du répertoire racine :
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Ilist < ServerFile > RootFiles = Minehut . GetServerFiles ( Server1ID ) ;Pour récupérer les fichiers du dossier spécifié :
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Ilist < ServerFile > EssentialsConfigFiles = Minehut . GetServerFiles ( Server1ID , "PluginsEssentials" ) ;Cela renverra tous les plugins installés du serveur spécifié. Ils reviennent sous forme d'IList de InstalledPlugin (dans Minehut.Types)
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Ilist < InstalledPlugin > InstalledPlugins = Minehut . GetServerPlugins ( Server1ID ) ;Cela renvoie l'état du serveur donné. Utile pour voir combien de personnes sont en ligne, qui est en ligne, l'état du serveur, ect. Renvoie en tant qu'objet Status (dans Minehut.Types)
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Status MyServerStatus = Minehut . GetServerStatus ( Server1ID ) ;Cela renvoie un objet AuthToken (In Minehut.types). Il encapsule l'ID de session et le jeton d'accès requis pour s'authentifier auprès de l'API minehut. Ceci est utile si vous souhaitez enregistrer l'ID/le jeton de session. Son utilisation principale est pour le fournisseur MinehutEvent. Des exemples en seront vus plus loin dans ce document
REMARQUE : vous devez être connecté à minehut avant d'appeler cette fonction.
AuthToken Auth = Minehut . GetAuthToken ( ) ;Cette méthode modifie le MOTD du serveur spécifié (le message de titre visible sur la liste du serveur Minecraft)
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Minehut . ChangeServerMOTD ( Server1ID , "Welcome to my epic minecraft server!" ) ;Cela modifie le nom et l'adresse IP du serveur. Cela générera une erreur si le nom est déjà pris, je recommande donc de le mettre dans un try catch.
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
try
{
Minehut . ChangeServerName ( Server1ID , "MySky" ) ;
Console . WriteLine ( "Server name changed!" ) ;
}
catch ( ArgumentNullException ex )
{
Console . WriteLine ( "OOPS! that name is already taken!" ) ;
}En utilisant cela, vous pouvez modifier n'importe quelle propriété du serveur. En spécifiant l'ID du serveur, la propriété du serveur (à l'aide de l'énumération ServerProperties, stockée dans Minehut.Types) et la nouvelle valeur de la propriété, vous pouvez modifier l'une de ces propriétés : Autoriser le vol, Autoriser le Nether, Annoncer les réalisations du joueur, Difficulté, Activer les blocs de commande, Forcer. Gamemode, Gamemode, Générer des structures, Paramètres du générateur, Hardcore, Nom du niveau, Type de niveau, Nombre maximum de joueurs (10 ou 20, peut aller plus haut si vous avez un serveur payant), PVP, Pack de ressources (télécharger url), les animaux d'apparition et les monstres d'apparition.
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Minehut . ChangeServerProperty ( Server1ID , Serverproperties . difficulty , "normal" ) ;
Minehut . ChangeServerProperty ( Server1ID , Serverproperties . Level_Name , "world1" ) ;
Minehut . ChangeServerProperty ( Server1ID , Serverproperties . MaxPlayers , 20 ) ;Cela vous permet de rendre le serveur public ou privé. Spécifiez l'ID du serveur et s'il doit être public ou privé. Vrai = Public Faux = Privé
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String SuperSecretServersID = MyServers [ 0 ] ;
Minehut . ChangeServerVisibility ( SuperSecretServersID , False ) ;Installe le plugin spécifié sur un serveur Minecraft. Pour trouver les ID des plugins, il est recommandé d'utiliser la fonction GetPlugins(). Par exemple, voici l'ID du plugin Essentials : 5a42ba4846246d33fa64c625
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
IList < Plugin > PublicPlugins = Minehut . GetPlugins ( ) ;
String RandomPluginID = PublicPlugins [ 50 ] . ID ;
//installs a the random plugin
Minehut . InstallServerPlugin ( Server1ID , RandomPluginID ) ;
//installs a the Essentials plugin
Minehut . InstallServerPlugin ( Server1ID , "5a42ba4846246d33fa64c625" ) ;Désinstalle un plugin d'un serveur Minecraft. Assez similaire à InstallServerPlugin(), mais au lieu d'installer le plugin, il le supprime.
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
IList < InstalledPlugins > MyInstalledPlugins = Minehut . GetServerPlugins ( Server1ID ) ;
String RandomInstalledPluginID = MyInstalledPlugins [ 4 ] . ID ;
//uninstalls a the random plugin
Minehut . RemoveServerPlugin ( Server1ID , RandomPluginID ) ;
//uninstalls a the Essentials plugin
Minehut . RemoveServerPlugin ( Server1ID , "5a42ba4846246d33fa64c625" ) ;Répare tous les fichiers du serveur Minecraft, utilisés pour réparer les fichiers du serveur Minecraft cassés/corrompus.
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Minehut . RepairServer ( Server1ID ) ;Supprime tous les fichiers du serveur spécifié, le réinitialise aux paramètres d'usine et supprime tous les mondes, plugins, etc.
REMARQUE : Cette opération NE PEUT PAS être annulée. Les fichiers seront définitivement perdus, il est donc recommandé de sauvegarder les fichiers du serveur avant de le faire.
Minehut . ResetServer ( ServerID ) ;Cela réinitialise la configuration du plugin donné sur le serveur donné. Utile si le fichier de configuration est complètement cassé.
Minehut . ResetServerPlugin ( ServerID , PluginID ) ;Cela efface et régénère le monde du serveur par défaut. N'oubliez pas que cela efface le serveur, tout sera perdu.
Minehut . ResetServerWorld ( ServerID ) ;Sauve le monde du serveur. Identique à /Enregistrer.
Minehut . SaveServer ( ServerID ) ;Cela envoie la commande spécifiée au serveur via la console. Toutes les commandes s'exécutent en tant que serveur, et donc avec les privilèges d'opérateur.
minehut . SendCommand ( ServerID , "Op ShimmyMySherbet" )
minehut . SendCommand ( ServerID , "Broadcast Server shutting down in 5 minutes!" )Démarre le service et le serveur pour le serveur Minecraft spécifié.
Minehut . StartService ( ServerID ) ;Démarre le serveur Minecraft. REMARQUE : utilisez-le uniquement si le service est déjà en ligne. Il est normalement préférable d'utiliser StartService().
Minehut . StartServer ( ServerID ) ;Enregistre, puis arrête le serveur Minecraft et son service. Utilisez-le si vous ne prévoyez pas de redémarrer le serveur dans les 5 prochaines minutes.
Minehut . ShutdownService ( ServerID ) ;Enregistre, puis arrête le serveur, mais pas le service. Vous pouvez ainsi redémarrer rapidement le serveur. Utile pour appliquer des modifications de propriété ou des modifications de plugin.
Minehut . ShutdownServer ( ServerID ) ;Vous permet de créer un compte minehut. Il est cependant recommandé d'utiliser simplement le site Web de Minehut pour cela.
Date DateOfBirth = New Date ( 2000 , 9 , 15 ) ;
Minehut . SignUp ( "[email protected]" , DateOfBirth ) ;Cela déclenchera minehut pour envoyer le code de vérification à l'e-mail spécifié.
Cela vous permet de confirmer votre compte minehut à l'aide du code email envoyé à votre adresse email (voir ci-dessus)
Minehut . ConfirmEmail ( "SuperSecretPassword124" , "EmailverificationCode" ) ;
