Download Minehut.Net - Download do código-fonte Minehut.Net

Minehut.Net

Este projeto permite fácil integração à sua conta/servidor minehut. Inclui todos os recursos da API backend do minehut, incluindo a capacidade de criar/verificar contas.

Este projeto foi escrito em Visual Basic, mas por se tratar de uma biblioteca .NET não faz diferença utilizá-la em C#.

Documentação

A primeira parte que você precisa saber, a maior parte desta biblioteca está no MinehutAPIClient

MinehutAPIClient

A maioria dos recursos da API minehut exigirá login para que você possa acessar seus servidores. Para fazer isso, use o método Login(). Para a maioria das funções contidas nesta classe, é recomendado importar a classe Minehut.Types.

 using Minehut . Types ;

Conecte-se

Isso autenticará o cliente na API do Minehut, permitindo que você trabalhe com seus servidores. C#

 MinehutApiClient Minehut = New MinehutApiClient ( ) ;
Minehut . Login ( "[email protected]" , "SuperSecretPassword" ) ;

GetServers()

Usando esta função, você pode acessar todos os servidores minehut públicos atualmente em execução. Esses servidores são retornados como uma IList do tipo Server. (Dentro de Minehut.Types)

 IList < Server > servers = Minehut . GetServers ( ) ;

GetSelfServers()

Isso recupera os IDs de seus servidores, esses IDs são usados para especificar qual servidor você deseja afetar com outras funções/métodos.

 String [ ] MyServers = Minehut . GetSelfServers ;

ObterPlugins()

Esta função irá recuperar todos os plugins disponíveis no minehut.

 IList < Plugin > Plugins = Minehut . GetPlugins ( ) ;

GetServerByID()

Isso obterá informações estendidas sobre o servidor especificado. Requer um ID de servidor e retornará informações sobre o servidor.

 String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;

ExtendedServer ExtendedServerInformation = Minehut . GetServerByID ( Server1ID ) ;

GetServerByName()

Esta função retornará as informações salvas como GetServerByID(), mas usa o nome do servidor em vez do ID do servidor.

 ExtendedServer ExtendedServerInformation = Minehut . GetServerByID ( "Skyblock" ) ;

GetServerFiles()

Usando esta função, você pode recuperar os arquivos armazenados como parte do seu servidor Minecraft. Cada arquivo é armazenado como um objeto ServerFile (em Minehut.Types). Esses objetos contêm:

Nome do arquivo
Se for um diretório/pasta
Se o arquivo/pasta estiver protegido

Você precisa especificar o ID do servidor e, opcionalmente, também pode especificar o caminho. Por padrão, ele retornará arquivos armazenados no diretório raiz do servidor.

Para obter os arquivos do diretório raiz:

 String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;

Ilist < ServerFile > RootFiles = Minehut . GetServerFiles ( Server1ID ) ;

Para obter os arquivos da pasta especificada:

 String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;

Ilist < ServerFile > EssentialsConfigFiles = Minehut . GetServerFiles ( Server1ID , "PluginsEssentials" ) ;

GetServerPlugins()

Isso retornará todos os plug-ins instalados no servidor especificado. Eles retornam como um IList de InstalledPlugin (em Minehut.Types)

 String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;

Ilist < InstalledPlugin > InstalledPlugins = Minehut . GetServerPlugins ( Server1ID ) ;

GetServerStatus

Isso retorna o status do servidor fornecido. Útil para ver quantas pessoas estão online, quem está online, o estado do servidor, etc. Retorna como um objeto Status (em Minehut.Types)

 String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;

Status MyServerStatus = Minehut . GetServerStatus ( Server1ID ) ;

ObterAuthToken()

Isso retorna um objeto AuthToken (em Minehut.types). Ele encapsula o ID da sessão e o token de acesso necessários para autenticar na API minehut. Isso é útil se você deseja salvar o ID/token da sessão. Seu principal uso é para o MinehutEventprovider. Exemplos disso serão vistos mais adiante neste documento

NOTA: Você precisa estar logado no minehut antes de chamar esta função.

 AuthToken Auth = Minehut . GetAuthToken ( ) ;

AlterarServidorMOTD()

Este método altera o MOTD do servidor especificado (a mensagem de título vista na lista de servidores do Minecraft)

 String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;

Minehut . ChangeServerMOTD ( Server1ID , "Welcome to my epic minecraft server!" ) ;

AlterarNomeServidor()

Isso altera o nome e o endereço IP do servidor. Irá gerar um erro se o nome já estiver em uso, então recomendo colocá-lo em um 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!" ) ;
}

AlterarPropriedadeServidor()

Usando isso, você pode alterar qualquer uma das propriedades do servidor. Especificando o ID do servidor, Propriedade do Servidor (usando o ServerProperties Enum, armazenado em Minehut.Types) e o novo valor da propriedade, você pode alterar qualquer uma destas propriedades: Permitir Voo, Permitir Nether, Anunciar Conquistas do Jogador, Dificuldade, Habilitar Blocos de Comando, Forçar Modo de jogo, Modo de jogo, Gerar estruturas, Configurações do gerador, Hardcore, Nome do nível, Tipo de nível, Máximo de jogadores (10 ou 20, podem ir mais alto se você tiver um servidor pago), PVP, Pacote de recursos (url de download), Spawn Animals e 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 ) ;

ChangeServerVisibility()

Isso permite que você torne o servidor Público ou Privado. Especifique o ID do servidor e se será público ou privado. Verdadeiro = Público Falso = Privado

 String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String SuperSecretServersID = MyServers [ 0 ] ;

Minehut . ChangeServerVisibility ( SuperSecretServersID , False ) ;

InstalarServerPlugin()

Instala o plugin especificado em um servidor Minecraft. Para encontrar os IDs dos plugins, é recomendado usar a função GetPlugins(). Por exemplo, este é o ID do 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" ) ;

RemoverServerPlugin()

Desinstala um plugin de um servidor Minecraft. Muito semelhante ao InstallServerPlugin(), mas em vez de instalar o plugin, ele o remove.

 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" ) ;

Servidor de reparo()

Repara todos os arquivos do servidor Minecraft, usados para consertar arquivos quebrados/corrompidos do servidor Minecraft.

 String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;

Minehut . RepairServer ( Server1ID ) ;

ResetServidor()

Exclui todos os arquivos do servidor especificado, redefinindo-o para os padrões de fábrica e excluindo todos os mundos, plug-ins, etc.

NOTA: Isso NÃO PODE ser desfeito. Os arquivos serão perdidos permanentemente, por isso é recomendável fazer backup dos arquivos do servidor antes de fazer isso.

 Minehut . ResetServer ( ServerID ) ;

ResetServerPlugin()

Isso redefine a configuração do plugin fornecido no servidor fornecido. Útil se o arquivo de configuração estiver completamente corrompido.

 Minehut . ResetServerPlugin ( ServerID , PluginID ) ;

ResetServerWorld()

Isso limpa e regenera o mundo do servidor padrão. Lembre-se, isso apaga o servidor, tudo será perdido.

 Minehut . ResetServerWorld ( ServerID ) ;

SalvarServidor()

Salva o mundo do servidor. O mesmo que /Salvar.

 Minehut . SaveServer ( ServerID ) ;

EnviarComando

Isso envia o comando especificado ao servidor via console. Todos os comandos são executados como servidor e, portanto, com privilégios de operador.

 minehut . SendCommand ( ServerID , "Op ShimmyMySherbet" )
minehut . SendCommand ( ServerID , "Broadcast Server shutting down in 5 minutes!" )

IniciarServiço()

Inicia o serviço e o servidor do servidor Minecraft especificado.

 Minehut . StartService ( ServerID ) ;

IniciarServidor()

Inicia o servidor Minecraft. NOTA: Use isto somente se o serviço já estiver online, normalmente é melhor usar StartService().

 Minehut . StartServer ( ServerID ) ;

Serviço de desligamento()

Salva e desliga o servidor do Minecraft e seu serviço. Use isto se você não planeja reiniciar o servidor nos próximos 5 minutos.

 Minehut . ShutdownService ( ServerID ) ;

DesligarServidor()

Salva e desliga o servidor, mas não o serviço. Assim, você pode reiniciar rapidamente o servidor. Útil para aplicar alterações de propriedades ou alterações de plugins.

 Minehut . ShutdownServer ( ServerID ) ;

Inscrever-se

Permite que você se inscreva em uma conta Minehut. No entanto, é recomendado apenas usar o site do Minehut para isso.

 Date DateOfBirth = New Date ( 2000 , 9 , 15 ) ;

Minehut . SignUp ( "[email protected]" , DateOfBirth ) ;

Isso fará com que o Minehut envie o código de verificação para o e-mail especificado.

Confirmar e-mail

Isso permite que você confirme sua conta minehut usando o código de e-mail enviado para seu endereço de e-mail (veja acima)

 Minehut . ConfirmEmail ( "SuperSecretPassword124" , "EmailverificationCode" ) ;

Expandir