Minehut.Net
1.0.0
Este proyecto permite una fácil integración a su cuenta/servidor de Minehut. Incluye todas las características de la API backend de Minehut, incluida la capacidad de crear/verificar cuentas.
Este proyecto fue escrito en Visual Basic, pero como es una biblioteca .NET, no hay diferencia si lo usas en C#.
La primera parte que necesitará saber, la mayor parte de esta biblioteca se encuentra en MinehutAPIClient.
La mayoría de las funciones de la API de Minehut requerirán iniciar sesión para poder acceder a sus servidores. Para hacer esto, use el método Login(). Para la mayoría de las funciones contenidas en esta clase, se recomienda importar la clase Minehut.Types.
using Minehut . Types ;Esto autenticará al cliente en la API de Minehut, lo que le permitirá trabajar con sus servidores. DO#
MinehutApiClient Minehut = New MinehutApiClient ( ) ;
Minehut . Login ( "[email protected]" , "SuperSecretPassword" ) ;Con esta función, puede acceder a todos los servidores públicos de Minehut actualmente en ejecución. Estos servidores se devuelven como una IList del tipo de servidor. (Dentro de Minehut.Types)
IList < Server > servers = Minehut . GetServers ( ) ;Esto recupera los ID de sus servidores, estos ID se utilizan para especificar qué servidor desea afectar con otras funciones/métodos.
String [ ] MyServers = Minehut . GetSelfServers ;Esta función recuperará todos los complementos disponibles en minehut.
IList < Plugin > Plugins = Minehut . GetPlugins ( ) ;Esto obtendrá información ampliada sobre el servidor especificado. Requiere una identificación del servidor y devolverá información sobre el servidor.
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
ExtendedServer ExtendedServerInformation = Minehut . GetServerByID ( Server1ID ) ;Esta función devolverá la información guardada como GetServerByID(), pero utiliza el nombre del servidor en lugar de la ID del servidor.
ExtendedServer ExtendedServerInformation = Minehut . GetServerByID ( "Skyblock" ) ;Con esta función, puede recuperar los archivos almacenados como parte de su servidor de Minecraft. Cada archivo se almacena como un objeto ServerFile (en Minehut.Types). Estos objetos contienen:
Debe especificar el ID del servidor y, opcionalmente, también puede especificar la ruta. De forma predeterminada, devolverá archivos almacenados en el directorio raíz del servidor.
Para obtener los archivos del directorio raíz:
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Ilist < ServerFile > RootFiles = Minehut . GetServerFiles ( Server1ID ) ;Para obtener los archivos de la carpeta especificada:
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Ilist < ServerFile > EssentialsConfigFiles = Minehut . GetServerFiles ( Server1ID , "PluginsEssentials" ) ;Esto devolverá todos los complementos instalados del servidor especificado. Regresan como una IList de InstalledPlugin (en Minehut.Types)
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Ilist < InstalledPlugin > InstalledPlugins = Minehut . GetServerPlugins ( Server1ID ) ;Esto devuelve el estado del servidor dado. Útil para ver cuántas personas están en línea, quién está en línea, el estado del servidor, etc. Devuelve como un objeto de estado (en Minehut.Types)
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Status MyServerStatus = Minehut . GetServerStatus ( Server1ID ) ;Esto devuelve un objeto AuthToken (en Minehut.types). Encapsula el ID de sesión y el token de acceso necesarios para autenticarse en la API de minehut. Esto es útil si desea guardar el ID/token de la sesión. Su uso principal es para MinehutEventprovider. Se verán ejemplos de esto más adelante en este documento.
NOTA: Debes haber iniciado sesión en minehut antes de llamar a esta función.
AuthToken Auth = Minehut . GetAuthToken ( ) ;Este método cambia el MOTD del servidor especificado (el mensaje de título que se ve en la lista del servidor de Minecraft)
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Minehut . ChangeServerMOTD ( Server1ID , "Welcome to my epic minecraft server!" ) ;Esto cambia el nombre del servidor y la dirección IP. Generará un error si el nombre ya está en uso, por lo que recomiendo ponerlo en 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!" ) ;
}Con esto, puede cambiar cualquiera de las propiedades del servidor. Al especificar el ID del servidor, la propiedad del servidor (usando la enumeración ServerProperties, almacenada en Minehut.Types) y el nuevo valor de la propiedad, puede cambiar cualquiera de estas propiedades: Permitir vuelo, Permitir Nether, Anunciar logros de jugadores, Dificultad, Habilitar bloques de comando, Fuerza Modo de juego, Modo de juego, Generar estructuras, Configuración del generador, Incondicional, Nombre del nivel, Tipo de nivel, Máximo de jugadores (10 o 20, puede ir más si tienes un servidor pago), PvP, Paquete de recursos (URL de descarga), Spawn Animals y 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 ) ;Esto le permite hacer que el servidor sea Público o Privado. Especifique el ID del servidor y si será público o privado. Verdadero = Público Falso = Privado
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String SuperSecretServersID = MyServers [ 0 ] ;
Minehut . ChangeServerVisibility ( SuperSecretServersID , False ) ;Instala el complemento especificado en un servidor de Minecraft. Para encontrar los ID de los complementos, se recomienda utilizar la función GetPlugins(). Por ejemplo, este es el ID del complemento 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" ) ;Desinstala un complemento de un servidor de Minecraft. Bastante similar a InstallServerPlugin(), pero en lugar de instalar el complemento, lo elimina.
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" ) ;Repara todos los archivos del servidor de Minecraft, utilizado para reparar archivos del servidor de Minecraft rotos o corruptos.
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
Minehut . RepairServer ( Server1ID ) ;Elimina todos los archivos del servidor especificado, restableciéndolos a los valores predeterminados de fábrica y eliminando todos los mundos, complementos, etc.
NOTA: Esto NO SE PUEDE deshacer. Los archivos se perderán permanentemente, por lo que se recomienda hacer una copia de seguridad de los archivos del servidor antes de hacer esto.
Minehut . ResetServer ( ServerID ) ;Esto restablece la configuración del complemento determinado en el servidor determinado. Útil si el archivo de configuración está completamente roto.
Minehut . ResetServerPlugin ( ServerID , PluginID ) ;Esto borra y regenera el mundo del servidor predeterminado. Recuerde, esto borra el servidor, todo se perderá.
Minehut . ResetServerWorld ( ServerID ) ;Guarda el mundo del servidor. Igual que /Guardar.
Minehut . SaveServer ( ServerID ) ;Esto envía el comando especificado al servidor a través de la consola. Todos los comandos se ejecutan como servidor y, por tanto, con privilegios de operador.
minehut . SendCommand ( ServerID , "Op ShimmyMySherbet" )
minehut . SendCommand ( ServerID , "Broadcast Server shutting down in 5 minutes!" )Inicia el servicio y el servidor para el servidor de Minecraft especificado.
Minehut . StartService ( ServerID ) ;Inicia el servidor de Minecraft. NOTA: Utilice esto únicamente si el servicio ya está en línea; normalmente es mejor utilizar StartService().
Minehut . StartServer ( ServerID ) ;Guarda, luego apaga el servidor de Minecraft y su servicio. Úselo si no planea iniciar el servidor nuevamente dentro de los próximos 5 minutos.
Minehut . ShutdownService ( ServerID ) ;Guarda y luego apaga el servidor, pero no el servicio. Para que pueda volver a iniciar rápidamente el servidor. Útil para aplicar cambios de propiedades o cambios de complementos.
Minehut . ShutdownServer ( ServerID ) ;Le permite registrarse para obtener una cuenta minehut. Sin embargo, se recomienda utilizar el sitio web minehut para esto.
Date DateOfBirth = New Date ( 2000 , 9 , 15 ) ;
Minehut . SignUp ( "[email protected]" , DateOfBirth ) ;Esto hará que Minehut envíe el código de verificación al correo electrónico especificado.
Esto le permite confirmar su cuenta minehut utilizando el código de correo electrónico enviado a su dirección de correo electrónico (ver arriba)
Minehut . ConfirmEmail ( "SuperSecretPassword124" , "EmailverificationCode" ) ;
