Minehut.Net
1.0.0
Dieses Projekt ermöglicht eine einfache Integration in Ihr Minehut-Konto/Server. Es umfasst alle Funktionen der Minehut-Backend-API, einschließlich der Möglichkeit, Konten zu erstellen/zu überprüfen.
Dieses Projekt wurde in Visual Basic geschrieben, aber da es sich um eine .NET-Bibliothek handelt, macht es keinen Unterschied zur Verwendung in C#.
Der erste Teil, den Sie wissen müssen, ist, dass sich der Großteil dieser Bibliothek im MinehutAPIClient befindet
Für die meisten Funktionen der Minehut-API ist eine Anmeldung erforderlich, damit Sie auf Ihre Server zugreifen können. Verwenden Sie dazu die Methode Login(). Für die meisten in dieser Klasse enthaltenen Funktionen wird empfohlen, die Klasse Minehut.Types zu importieren.
using Minehut . Types ;Dadurch wird der Client gegenüber der Minehut-API authentifiziert, sodass Sie mit Ihren Servern arbeiten können. C#
MinehutApiClient Minehut = New MinehutApiClient ( ) ;
Minehut . Login ( "[email protected]" , "SuperSecretPassword" ) ;Mit dieser Funktion können Sie auf alle aktuell laufenden öffentlichen Minehut-Server zugreifen. Diese Server werden als IList vom Typ Server zurückgegeben. (Innerhalb von Minehut.Types)
IList < Server > servers = Minehut . GetServers ( ) ;Dadurch werden die IDs Ihrer Server abgerufen. Diese IDs werden verwendet, um anzugeben, welchen Server Sie mit anderen Funktionen/Methoden beeinflussen möchten.
String [ ] MyServers = Minehut . GetSelfServers ;Diese Funktion ruft alle auf Minehut verfügbaren Plugins ab.
IList < Plugin > Plugins = Minehut . GetPlugins ( ) ;Dadurch werden erweiterte Informationen über den angegebenen Server abgerufen. Es erfordert eine Server-ID und gibt Informationen über den Server zurück.
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
ExtendedServer ExtendedServerInformation = Minehut . GetServerByID ( Server1ID ) ;Diese Funktion gibt die Speicherinformationen als GetServerByID() zurück, verwendet jedoch den Servernamen anstelle der Server-ID.
ExtendedServer ExtendedServerInformation = Minehut . GetServerByID ( "Skyblock" ) ;Mit dieser Funktion können Sie die auf Ihrem Minecraft-Server gespeicherten Dateien abrufen. Jede Datei wird als ServerFile-Objekt (in Minehut.Types) gespeichert. Diese Objekte enthalten:
Sie müssen die Server-ID angeben, optional können Sie auch den Pfad angeben. Standardmäßig werden Dateien zurückgegeben, die im Stammverzeichnis des Servers gespeichert sind.
So rufen Sie die Stammverzeichnisdateien ab:
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Ilist < ServerFile > RootFiles = Minehut . GetServerFiles ( Server1ID ) ;So rufen Sie die Dateien des angegebenen Ordners ab:
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Ilist < ServerFile > EssentialsConfigFiles = Minehut . GetServerFiles ( Server1ID , "PluginsEssentials" ) ;Dadurch werden alle installierten Plugins des angegebenen Servers zurückgegeben. Sie kehren als IList of InstalledPlugin (In Minehut.Types) zurück.
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Ilist < InstalledPlugin > InstalledPlugins = Minehut . GetServerPlugins ( Server1ID ) ;Dies gibt den Status des angegebenen Servers zurück. Nützlich, um zu sehen, wie viele Personen online sind, wer online ist, den Status des Servers usw. Gibt als Statusobjekt zurück (in Minehut.Types)
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Status MyServerStatus = Minehut . GetServerStatus ( Server1ID ) ;Dies gibt ein AuthToken-Objekt zurück (in Minehut.types). Es kapselt die Sitzungs-ID und das Zugriffstoken, die für die Authentifizierung bei der Minehut-API erforderlich sind. Dies ist nützlich, wenn Sie die Sitzungs-ID/das Sitzungs-Token speichern möchten. Es wird hauptsächlich für den MinehutEventprovider verwendet. Beispiele hierfür finden Sie später in diesem Dokument
HINWEIS: Sie müssen sich bei Minehut angemeldet haben, bevor Sie diese Funktion aufrufen können.
AuthToken Auth = Minehut . GetAuthToken ( ) ;Diese Methode ändert die MOTD des angegebenen Servers (die Titelmeldung, die in der Liste des Minecraft-Servers angezeigt wird).
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Minehut . ChangeServerMOTD ( Server1ID , "Welcome to my epic minecraft server!" ) ;Dadurch ändern sich der Name und die IP-Adresse des Servers. Es wird ein Fehler ausgegeben, wenn der Name bereits vergeben ist. Ich empfehle daher, ihn in einen Try-Catch zu setzen.
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!" ) ;
}Damit können Sie beliebige Eigenschaften des Servers ändern. Durch Angabe der Server-ID, der Servereigenschaft (unter Verwendung der ServerProperties-Enumeration, gespeichert in Minehut.Types) und des neuen Eigenschaftswerts können Sie jede dieser Eigenschaften ändern: Flug zulassen, Nether zulassen, Spielererfolge ankündigen, Schwierigkeit, Befehlsblöcke aktivieren, Kraft Spielmodus, Spielmodus, Strukturen generieren, Generatoreinstellungen, Hardcore, Levelname, Leveltyp, maximale Spielerzahl (10 oder 20, kann höher sein, wenn Sie einen kostenpflichtigen Server haben), PVP, Ressourcenpaket (Download-URL), Spawn Animals und Spawn Mobs.
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 ) ;Dadurch können Sie den Server öffentlich oder privat machen. Geben Sie die Server-ID an und ob sie öffentlich oder privat sein soll. Wahr = Öffentlich Falsch = Privat
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String SuperSecretServersID = MyServers [ 0 ] ;
Minehut . ChangeServerVisibility ( SuperSecretServersID , False ) ;Installiert das angegebene Plugin auf einem Minecraft-Server. Zum Finden der Plugin-IDs empfiehlt sich die Verwendung der Funktion GetPlugins(). Dies ist beispielsweise die ID für das Essentials-Plugin: 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" ) ;Deinstalliert ein Plugin von einem Minecraft-Server. Ziemlich ähnlich wie InstallServerPlugin(), aber statt das Plugin zu installieren, wird es entfernt.
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" ) ;Repariert alle Minecraft-Serverdateien und wird verwendet, um defekte/beschädigte Minecraft-Serverdateien zu reparieren.
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Minehut . RepairServer ( Server1ID ) ;Löscht alle Serverdateien des angegebenen Servers, setzt ihn auf die Werkseinstellungen zurück und löscht alle Welten, Plugins usw.
HINWEIS: Dies kann NICHT rückgängig gemacht werden. Die Dateien gehen dauerhaft verloren, daher wird empfohlen, vorher die Serverdateien zu sichern.
Minehut . ResetServer ( ServerID ) ;Dadurch wird die Konfiguration für das angegebene Plugin auf dem angegebenen Server zurückgesetzt. Nützlich, wenn die Konfigurationsdatei vollständig beschädigt ist.
Minehut . ResetServerPlugin ( ServerID , PluginID ) ;Dadurch wird die Standardserverwelt gelöscht und neu generiert. Denken Sie daran, dass dadurch der Server gelöscht wird und alles verloren geht.
Minehut . ResetServerWorld ( ServerID ) ;Rettet die Welt des Servers. Identisch mit /Speichern.
Minehut . SaveServer ( ServerID ) ;Dadurch wird der angegebene Befehl über die Konsole an den Server gesendet. Alle Befehle laufen als Server und daher mit Bedienerrechten.
minehut . SendCommand ( ServerID , "Op ShimmyMySherbet" )
minehut . SendCommand ( ServerID , "Broadcast Server shutting down in 5 minutes!" )Startet den Dienst und Server für den angegebenen Minecraft-Server.
Minehut . StartService ( ServerID ) ;Startet den Minecraft-Server. HINWEIS: Verwenden Sie dies nur, wenn der Dienst bereits online ist. Normalerweise ist es am besten, einfach StartService() zu verwenden.
Minehut . StartServer ( ServerID ) ;Speichert und fährt dann den Minecraft-Server und seinen Dienst herunter. Verwenden Sie diese Option, wenn Sie nicht vorhaben, den Server innerhalb der nächsten 5 Minuten erneut zu starten.
Minehut . ShutdownService ( ServerID ) ;Speichert und fährt dann den Server herunter, aber nicht den Dienst. So können Sie den Server schnell wieder hochfahren. Nützlich zum Anwenden von Eigenschaftsänderungen oder Plugin-Änderungen.
Minehut . ShutdownServer ( ServerID ) ;Ermöglicht Ihnen, sich für ein Minehut-Konto anzumelden. Es wird jedoch empfohlen, hierfür einfach die Minehut-Website zu nutzen.
Date DateOfBirth = New Date ( 2000 , 9 , 15 ) ;
Minehut . SignUp ( "[email protected]" , DateOfBirth ) ;Dadurch wird Minehut veranlasst, den Bestätigungscode an die angegebene E-Mail-Adresse zu senden.
Dadurch können Sie Ihr Minehut-Konto mit dem E-Mail-Code bestätigen, der an Ihre E-Mail-Adresse gesendet wurde (siehe oben).
Minehut . ConfirmEmail ( "SuperSecretPassword124" , "EmailverificationCode" ) ;
