ホーム>プログラミング関連>VB.NET
ダウンロード

Minehut.Net

このプロジェクトにより、minehut アカウント/サーバーへの簡単な統合が可能になります。これには、アカウントの作成/検証機能を含む、minehut バックエンド API のすべての機能が含まれています。

このプロジェクトは Visual Basic で作成されましたが、.NET ライブラリであるため、C# で使用しても問題はありません。

ドキュメント

最初に知っておく必要がある部分は、このライブラリの大部分は MinehutAPIClient にあります。

MinehutAPIクライアント

Minehut API のほとんどの機能にはログインが必要なので、サーバーにアクセスできます。これを行うには、Login() メソッドを使用します。このクラス内に含まれるほとんどの関数については、Minehut.Types クラスをインポートすることをお勧めします。 

 using Minehut . Types ;

ログイン

これにより、minehut API に対してクライアントが認証され、サーバーを操作できるようになります。 C# 

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

GetServers()

この機能を使用すると、現在実行中のすべての公開 Minehut サーバーにアクセスできます。これらのサーバーは、サーバー タイプの IList として返されます。 (Minehut.Types内) 

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

GetSelfServers()

これによりサーバーの ID が取得されます。これらの ID は、他の関数/メソッドでどのサーバーに影響を与えるかを指定するために使用されます。 

 String [ ] MyServers = Minehut . GetSelfServers ;

Getプラグイン()

この関数は、minehut で利用可能なすべてのプラグインを取得します。 

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

GetServerByID()

これにより、指定したサーバーに関する拡張情報が取得されます。サーバー ID が必要で、サーバーに関する情報が返されます。 

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

ExtendedServer ExtendedServerInformation = Minehut . GetServerByID ( Server1ID ) ;

GetServerByName()

この関数は保存情報を GetServerByID() として返しますが、サーバー ID の代わりにサーバー名が使用されます。 

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

GetServerFiles()

この機能を使用すると、Minecraft サーバーの一部として保存されているファイルを取得できます。各ファイルは ServerFile オブジェクトとして保存されます (Minehut.Types 内)。これらのオブジェクトには次のものが含まれます。

  • ファイル名
  • ディレクトリ/フォルダーの場合
  • ファイル/フォルダーが保護されている場合

サーバー ID を指定する必要があり、オプションでパスも指定できます。デフォルトでは、サーバーのルート ディレクトリに保存されているファイルが返されます。

ルート ディレクトリ ファイルを取得するには: 

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

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

指定したフォルダーのファイルを取得するには: 

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

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

GetServerPlugins()

これにより、指定されたサーバーにインストールされているすべてのプラグインが返されます。これらは、InstalledPlugin の IList として返されます (Minehut.Types 内) 

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

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

GetServerStatus

これは、指定されたサーバーのステータスを返します。オンライン中の人数、オンライン中の人、サーバーの状態などを確認するのに役立ちます。 Status オブジェクトとして返されます (Minehut.Types 内) 

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

Status MyServerStatus = Minehut . GetServerStatus ( Server1ID ) ;

GetAuthToken()

これにより、AuthToken オブジェクト (Minehut.types 内) が返されます。 Minehut API への認証に必要なセッション ID とアクセス トークンをカプセル化します。これは、セッション ID/トークンを保存する場合に便利です。主な用途は MinehutEventprovider です。この例については、このドキュメントで後ほど説明します。

注: この関数を呼び出す前に、minehut にログインしておく必要があります。 

 AuthToken Auth = Minehut . GetAuthToken ( ) ;

ChangeServerMOTD()

このメソッドは、指定されたサーバーの MOTD (Minecraft サーバーのリストに表示されるタイトル メッセージ) を変更します。 

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

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

ChangeServerName()

これにより、サーバーの名前と IP アドレスが変更されます。名前がすでに使用されている場合はエラーがスローされるため、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!" ) ;
}

ChangeServerProperty()

これを使用すると、サーバーのプロパティを変更できます。サーバー ID、サーバー プロパティ (Minehut.Types に保存されている ServerProperties Enum を使用)、および新しいプロパティ値を指定すると、次のプロパティのいずれかを変更できます: 飛行を許可、ネザーを許可、プレイヤーの実績を発表、難易度、コマンド ブロックを有効にする、強制ゲームモード、ゲームモード、構造の生成、ジェネレーター設定、ハードコア、レベル名、レベルのタイプ、最大プレイヤー数 (10 または 20、有料サーバーを使用している場合はさらに多くなる可能性があります)、 PVP、リソース パック (ダウンロード URL)、スポーン動物、およびスポーン Mob。 

 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()

これにより、サーバーをパブリックまたはプライベートにすることができます。サーバー ID を指定し、それをパブリックにするかプライベートにするかを指定します。 True = パブリック False = プライベート

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

Minehut . ChangeServerVisibility ( SuperSecretServersID , False ) ;

InstallServerPlugin()

指定されたプラグインを Minecraft サーバーにインストールします。プラグイン ID を検索するには、GetPlugins() 関数を使用することをお勧めします。たとえば、これは Essentials プラグインの ID です: 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" ) ;

RemoveServerPlugin()

Minecraft サーバーからプラグインをアンインストールします。 InstallServerPlugin() とよく似ていますが、プラグインをインストールする代わりに削除します。 

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

RepairServer()

すべての Minecraft サーバー ファイルを修復します。壊れた/破損した Minecraft サーバー ファイルを修正するために使用されます。 

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

Minehut . RepairServer ( Server1ID ) ;

ResetServer()

指定されたサーバーのすべてのサーバー ファイルを削除し、工場出荷時のデフォルトにリセットし、すべてのワールド、プラグインなどを削除します。

注: これを元に戻すことはできません。ファイルは永久に失われるため、これを行う前にサーバー ファイルをバックアップすることをお勧めします。 

 Minehut . ResetServer ( ServerID ) ;

ResetServerPlugin()

これにより、指定されたサーバー上の指定されたプラグインの構成がリセットされます。構成ファイルが完全に壊れている場合に役立ちます。 

 Minehut . ResetServerPlugin ( ServerID , PluginID ) ;

ResetServerWorld()

これにより、デフォルトのサーバーワールドが消去され、再生成されます。これによりサーバーが消去され、すべてが失われることに注意してください。 

 Minehut . ResetServerWorld ( ServerID ) ;

SaveServer()

サーバーの世界を救います。 /保存と同じ。 

 Minehut . SaveServer ( ServerID ) ;

コマンドの送信

これにより、指定されたコマンドがコンソール経由でサーバーに送信されます。すべてのコマンドはサーバーとして実行されるため、オペレーター権限が必要になります。 

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

StartService()

指定された Minecraft サーバーのサービスとサーバーを開始します。 

 Minehut . StartService ( ServerID ) ;

StartServer()

Minecraftサーバーを起動します。注: これは、サービスがすでにオンラインである場合にのみ使用してください。通常は、StartService() を使用するのが最善です。 

 Minehut . StartServer ( ServerID ) ;

シャットダウンサービス()

保存して、Minecraft サーバーとそのサービスをシャットダウンします。次の 5 分以内にサーバーを再起動する予定がない場合は、これを使用します。 

 Minehut . ShutdownService ( ServerID ) ;

シャットダウンサーバー()

保存してサーバーをシャットダウンしますが、サービスはシャットダウンしません。したがって、サーバーをすぐに再起動してバックアップできます。プロパティの変更やプラグインの変更を適用する場合に便利です。 

 Minehut . ShutdownServer ( ServerID ) ;

サインアップ

Minehut アカウントにサインアップできます。ただし、これにはminehut Webサイトを使用することをお勧めします。 

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

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

これにより、minehut が指定された電子メールに確認コードを送信するようになります。

Eメール確認

これにより、電子メール アドレスに送信された電子メール コードを使用して Minehut アカウントを確認できます (上記を参照) 

 Minehut . ConfirmEmail ( "SuperSecretPassword124" , "EmailverificationCode" ) ;
拡大する
追加情報
関連アプリ
おすすめ
関連情報 すべて