Minehut.Net

Minehut.Net

โปรเจ็กต์นี้ช่วยให้สามารถรวมเข้ากับบัญชี/เซิร์ฟเวอร์ minehut ของคุณได้อย่างง่ายดาย ประกอบด้วยฟีเจอร์ทั้งหมดของ minehut backend API รวมถึงความสามารถในการสร้าง/ยืนยันบัญชี

โปรเจ็กต์นี้เขียนด้วย Visual Basic แต่เนื่องจากเป็นไลบรารี .NET จึงไม่ต่างอะไรกับการใช้งานใน C#

เอกสารประกอบ

ส่วนแรกที่คุณจะต้องรู้ก่อนว่าห้องสมุดส่วนใหญ่อยู่ใน MinehutAPIClient

MinehutAPIClient

คุณสมบัติส่วนใหญ่ของ minehut API จะต้องมีการเข้าสู่ระบบ เพื่อให้คุณสามารถเข้าถึงเซิร์ฟเวอร์ของคุณได้ เมื่อต้องการทำเช่นนี้ ให้ใช้เมธอด Login() สำหรับฟังก์ชันส่วนใหญ่ที่อยู่ในคลาสนี้ ขอแนะนำให้นำเข้าคลาส Minehut.Types

 using Minehut . Types ;

เข้าสู่ระบบ

สิ่งนี้จะตรวจสอบสิทธิ์ไคลเอนต์กับ minehut api ทำให้คุณสามารถทำงานกับเซิร์ฟเวอร์ของคุณได้ ค#

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

รับเซิร์ฟเวอร์()

เมื่อใช้ฟังก์ชันนี้ คุณจะสามารถเข้าถึงเซิร์ฟเวอร์ minehut สาธารณะที่กำลังทำงานอยู่ทั้งหมดได้ เซิร์ฟเวอร์เหล่านี้จะถูกส่งกลับเป็น IList ของประเภทเซิร์ฟเวอร์ (ภายใน Minehut.Types)

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

รับเซิร์ฟเวอร์ตัวเอง()

วิธีนี้จะดึง ID ของเซิร์ฟเวอร์ของคุณ ID เหล่านี้ใช้เพื่อระบุเซิร์ฟเวอร์ที่คุณต้องการให้มีผลกับฟังก์ชัน/วิธีการอื่นๆ

 String [ ] MyServers = Minehut . GetSelfServers ;

รับปลั๊กอิน()

ฟังก์ชั่นนี้จะดึงปลั๊กอินทั้งหมดที่มีอยู่ใน minehut

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

GetServerByID()

นี่จะได้รับข้อมูลเพิ่มเติมเกี่ยวกับเซิร์ฟเวอร์ที่ระบุ ต้องมีรหัสเซิร์ฟเวอร์ และจะส่งคืนข้อมูลเกี่ยวกับเซิร์ฟเวอร์

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

ExtendedServer ExtendedServerInformation = Minehut . GetServerByID ( Server1ID ) ;

GetServerByName()

ฟังก์ชันนี้จะส่งคืนข้อมูลการบันทึกเป็น GetServerByID() แต่จะใช้ชื่อเซิร์ฟเวอร์แทนรหัสเซิร์ฟเวอร์

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

รับไฟล์เซิร์ฟเวอร์()

เมื่อใช้ฟังก์ชันนี้ คุณสามารถเรียกค้นไฟล์ที่เก็บไว้เป็นส่วนหนึ่งของเซิร์ฟเวอร์ Minecraft ของคุณได้ แต่ละไฟล์จะถูกจัดเก็บเป็น ServerFile Object (ใน Minehut.Types) วัตถุเหล่านี้ประกอบด้วย:

• ชื่อไฟล์
• หากเป็นไดเร็กทอรี/โฟลเดอร์
• หากไฟล์/โฟลเดอร์ได้รับการป้องกัน

คุณต้องระบุรหัสเซิร์ฟเวอร์ และคุณยังสามารถระบุเส้นทางได้อีกด้วย ตามค่าเริ่มต้น ระบบจะส่งคืนไฟล์ที่จัดเก็บไว้ในไดเร็กทอรีรากของเซิร์ฟเวอร์

หากต้องการรับไฟล์ไดเร็กทอรีราก:

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

รับปลั๊กอินเซิร์ฟเวอร์()

นี่จะส่งคืนปลั๊กอินที่ติดตั้งทั้งหมดของเซิร์ฟเวอร์ที่ระบุ พวกเขากลับมาเป็น IList ของ InstalledPlugin (ใน Minehut.Types)

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

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

รับสถานะเซิร์ฟเวอร์

สิ่งนี้จะส่งคืนสถานะของเซิร์ฟเวอร์ที่กำหนด มีประโยชน์ในการดูว่ามีกี่คนที่ออนไลน์ ใครออนไลน์อยู่ สถานะของเซิร์ฟเวอร์ ฯลฯ ส่งกลับเป็นวัตถุสถานะ (ใน Minehut.Types)

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

Status MyServerStatus = Minehut . GetServerStatus ( Server1ID ) ;

รับAuthToken()

สิ่งนี้ส่งคืนวัตถุ AuthToken (ใน Minehut.types) โดยสรุปรหัสเซสชันและโทเค็นการเข้าถึงที่จำเป็นในการตรวจสอบสิทธิ์กับ minehut API สิ่งนี้มีประโยชน์หากคุณต้องการบันทึก ID/โทเค็นเซสชัน การใช้งานหลักคือสำหรับ MinehutEventprovider ตัวอย่างของสิ่งนี้จะเห็นได้ในภายหลังในเอกสารนี้

หมายเหตุ: คุณต้องเข้าสู่ระบบ minehut ก่อนที่จะเรียกใช้ฟังก์ชันนี้

 AuthToken Auth = Minehut . GetAuthToken ( ) ;

เปลี่ยนเซิร์ฟเวอร์MOTD()

วิธีการนี้จะเปลี่ยน MOTD ของเซิร์ฟเวอร์ที่ระบุ (ข้อความชื่อที่เห็นในรายการเซิร์ฟเวอร์ Minecraft)

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

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

เปลี่ยนชื่อเซิร์ฟเวอร์()

สิ่งนี้จะเปลี่ยนชื่อเซิร์ฟเวอร์และที่อยู่ IP มันจะเกิดข้อผิดพลาดหากชื่อนั้นถูกใช้ไปแล้ว ดังนั้นฉันแนะนำให้ลองจับดู

 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 เซิร์ฟเวอร์ คุณสมบัติเซิร์ฟเวอร์ (โดยใช้ ServerProperties Enum ที่จัดเก็บไว้ใน Minehut.Types) และค่าคุณสมบัติใหม่ คุณสามารถเปลี่ยนคุณสมบัติเหล่านี้ได้: Allow Flight, Allow Nether, ประกาศความสำเร็จของผู้เล่น, ความยาก, เปิดใช้งาน Command Blocks, Force โหมดเกม, โหมดเกม, สร้างโครงสร้าง, การตั้งค่าตัวสร้าง, ฮาร์ดคอร์, ชื่อเลเวล, ประเภทเลเวล, ผู้เล่นสูงสุด (10 หรือ 20 สามารถไปสูงกว่านี้ได้หากคุณมีเซิร์ฟเวอร์แบบชำระเงิน), PVP, Resource Pack (ดาวน์โหลด url) สัตว์วางไข่ และม็อบวางไข่

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

เปลี่ยนการมองเห็นเซิร์ฟเวอร์()

สิ่งนี้ทำให้คุณสามารถกำหนดให้เซิร์ฟเวอร์เป็นสาธารณะหรือส่วนตัวได้ ระบุ ID เซิร์ฟเวอร์และระบุว่าเป็นสาธารณะหรือส่วนตัว จริง = สาธารณะ เท็จ = ส่วนตัว

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

Minehut . ChangeServerVisibility ( SuperSecretServersID , False ) ;

ติดตั้งปลั๊กอินเซิร์ฟเวอร์()

ติดตั้งปลั๊กอินที่ระบุไปยังเซิร์ฟเวอร์ Minecraft สำหรับการค้นหา ID ปลั๊กอิน ขอแนะนำให้ใช้ฟังก์ชัน GetPlugins() ตัวอย่างเช่น นี่คือรหัสสำหรับปลั๊กอิน 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" ) ;

ลบเซิร์ฟเวอร์ปลั๊กอิน()

ถอนการติดตั้งปลั๊กอินจากเซิร์ฟเวอร์ 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" ) ;

เซิร์ฟเวอร์ซ่อมแซม()

ซ่อมแซมไฟล์เซิร์ฟเวอร์ Minecraft ทั้งหมด ใช้เพื่อแก้ไขไฟล์เซิร์ฟเวอร์ Minecraft ที่เสียหาย/เสียหาย

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

Minehut . RepairServer ( Server1ID ) ;

รีเซ็ตเซิร์ฟเวอร์()

ลบไฟล์เซิร์ฟเวอร์ทั้งหมดของเซิร์ฟเวอร์ที่ระบุ รีเซ็ตกลับเป็นค่าเริ่มต้นจากโรงงาน และลบโลกทั้งหมด ปลั๊กอิน ฯลฯ

หมายเหตุ: การดำเนินการนี้ไม่สามารถยกเลิกได้ ไฟล์ต่างๆ จะหายไปอย่างถาวร ดังนั้นจึงแนะนำให้สำรองไฟล์เซิร์ฟเวอร์ก่อนดำเนินการนี้

 Minehut . ResetServer ( ServerID ) ;

รีเซ็ตเซิร์ฟเวอร์ปลั๊กอิน()

สิ่งนี้จะรีเซ็ตการกำหนดค่าสำหรับปลั๊กอินที่กำหนดบนเซิร์ฟเวอร์ที่กำหนด มีประโยชน์หากไฟล์ปรับแต่งเสียหายโดยสิ้นเชิง

 Minehut . ResetServerPlugin ( ServerID , PluginID ) ;

รีเซ็ตเซิร์ฟเวอร์โลก()

วิธีนี้จะล้างและสร้างโลกเซิร์ฟเวอร์เริ่มต้นใหม่ จำไว้ว่านี่เป็นการล้างเซิร์ฟเวอร์ ทุกอย่างจะหายไป

 Minehut . ResetServerWorld ( ServerID ) ;

บันทึกเซิร์ฟเวอร์()

กอบกู้โลกของเซิร์ฟเวอร์ เช่นเดียวกับ /บันทึก

 Minehut . SaveServer ( ServerID ) ;

ส่งคำสั่ง

สิ่งนี้จะส่งคำสั่งที่ระบุไปยังเซิร์ฟเวอร์ผ่านคอนโซล คำสั่งทั้งหมดทำงานเป็นเซิร์ฟเวอร์ ดังนั้นจึงมีสิทธิ์ของผู้ปฏิบัติงาน

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

เริ่มบริการ()

เริ่มบริการและเซิร์ฟเวอร์สำหรับเซิร์ฟเวอร์ Minecraft ที่ระบุ

 Minehut . StartService ( ServerID ) ;

สตาร์ทเซิร์ฟเวอร์()

เริ่มเซิร์ฟเวอร์ Minecraft หมายเหตุ: ใช้สิ่งนี้เฉพาะในกรณีที่บริการออนไลน์อยู่แล้ว โดยปกติวิธีที่ดีที่สุดคือใช้ StartService()

 Minehut . StartServer ( ServerID ) ;

บริการปิดเครื่อง()

บันทึก จากนั้นปิดเซิร์ฟเวอร์ Minecraft และบริการของมัน ใช้สิ่งนี้หากคุณไม่ได้วางแผนที่จะเริ่มเซิร์ฟเวอร์อีกครั้งภายใน 5 นาทีข้างหน้า

 Minehut . ShutdownService ( ServerID ) ;

เซิร์ฟเวอร์ปิดระบบ()

บันทึก จากนั้นปิดเซิร์ฟเวอร์ แต่ไม่ใช่บริการ คุณจึงสามารถเริ่มต้นการสำรองข้อมูลเซิร์ฟเวอร์อีกครั้งได้อย่างรวดเร็ว มีประโยชน์สำหรับการใช้การเปลี่ยนแปลงคุณสมบัติหรือการเปลี่ยนแปลงปลั๊กอิน

 Minehut . ShutdownServer ( ServerID ) ;

สมัครสมาชิก

ช่วยให้คุณสามารถสมัครบัญชี minehut ได้ ขอแนะนำให้ใช้เพียงเว็บไซต์ minehut สำหรับสิ่งนี้

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

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

นี่จะทำให้ minehut ส่งรหัสยืนยันไปยังอีเมลที่ระบุ

ยืนยันอีเมล

สิ่งนี้ช่วยให้คุณยืนยันบัญชี minehut ของคุณโดยใช้รหัสอีเมลที่ส่งไปยังที่อยู่อีเมลของคุณ (ดูด้านบน)

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