Minehut.Net

Minehut.Net

يسمح هذا المشروع بالتكامل السهل مع حساب/خادم minehut الخاص بك. وهو يتضمن جميع ميزات واجهة برمجة تطبيقات الواجهة الخلفية لـ minehut، بما في ذلك القدرة على إنشاء/التحقق من الحسابات.

تمت كتابة هذا المشروع باستخدام Visual Basic، ولكن نظرًا لأنه مكتبة .NET، فلا يوجد فرق في استخدامه في C#.

التوثيق

الجزء الأول الذي ستحتاج إلى معرفته، الجزء الأكبر من هذه المكتبة موجود في MinehutAPIClient

MinehutAPIClient

ستتطلب معظم ميزات واجهة برمجة تطبيقات minehut تسجيل الدخول، حتى تتمكن من الوصول إلى خوادمك. للقيام بذلك، استخدم أسلوب تسجيل الدخول (). بالنسبة لمعظم الوظائف الموجودة ضمن هذه الفئة، يوصى باستيراد فئة Minehut.Types.

 using Minehut . Types ;

تسجيل الدخول

سيؤدي هذا إلى مصادقة العميل على واجهة برمجة تطبيقات minehut، مما يسمح لك بالعمل مع خوادمك. ج#

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

GetServers ()

باستخدام هذه الوظيفة، يمكنك الوصول إلى كافة خوادم minehut العامة العاملة حاليًا. يتم إرجاع هذه الخوادم كقائمة Ilist من نوع الخادم. (ضمن أنواع مينيهوت)

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

جيتسيلفسيرفرز ()

يؤدي ذلك إلى استرداد معرفات الخوادم الخاصة بك، ويتم استخدام هذه المعرفات لتحديد الخادم الذي تريد التأثير عليه بوظائف/طرق أخرى.

 String [ ] MyServers = Minehut . GetSelfServers ;

GetPlugins()

ستقوم هذه الوظيفة باسترداد جميع المكونات الإضافية المتوفرة على 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" ) ;

GetServerFiles()

باستخدام هذه الوظيفة، يمكنك استرداد الملفات المخزنة كجزء من خادم Minecraft الخاص بك. يتم تخزين كل ملف ككائن ServerFile (في 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" ) ;

GetServerPlugins ()

سيؤدي هذا إلى إرجاع كافة المكونات الإضافية المثبتة للخادم المحدد. يعودون كقائمة Ilist لـ InstalledPlugin (في Minehut.Types)

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

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

GetServerStatus

يؤدي هذا إلى إرجاع حالة الخادم المحدد. من المفيد معرفة عدد الأشخاص المتصلين بالإنترنت، ومن هم متصلون بالإنترنت، وحالة الخادم، وما إلى ذلك. يُرجع ككائن حالة (في Minehut.Types)

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

Status MyServerStatus = Minehut . GetServerStatus ( Server1ID ) ;

جيتاوثتوكين ()

يؤدي هذا إلى إرجاع كائن AuthToken (في Minehut.types). فهو يحتوي على معرف الجلسة ورمز الوصول المطلوب للمصادقة على واجهة برمجة تطبيقات minehut. يعد هذا مفيدًا إذا كنت تريد حفظ معرف/رمز الجلسة. الاستخدام الرئيسي هو لموفر MinehutEvent. سيتم رؤية أمثلة على ذلك لاحقًا في هذه الوثيقة

ملحوظة: يجب عليك تسجيل الدخول إلى minehut قبل استدعاء هذه الوظيفة.

 AuthToken Auth = Minehut . GetAuthToken ( ) ;

تشانجسيرفيرموتد()

تعمل هذه الطريقة على تغيير 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!" ) ;
}

تشانجسيرفيربروبيرتي ()

باستخدام هذا، يمكنك تغيير أي من خصائص الخادم. من خلال تحديد معرف الخادم وخاصية الخادم (باستخدام ServerProperties Enum، المخزن في Minehut.Types) وقيمة الخاصية الجديدة، يمكنك تغيير أي من هذه الخصائص: السماح بالطيران، والسماح بالشبكة، والإعلان عن إنجازات اللاعب، والصعوبة، وتمكين كتل الأوامر، والقوة وضع اللعب، وضع اللعب، إنشاء الهياكل، إعدادات المولد، المتشددين، اسم المستوى، نوع المستوى، الحد الأقصى للاعبين (10 أو 20، يمكن أن يرتفعوا إذا كان لديك خادم مدفوع الأجر)، PVP، وResource Pack (عنوان url للتنزيل)، وSpawn Animals، و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 ) ;

تشانجسيرفيرفيسيبيليتي ()

يتيح لك هذا جعل الخادم عامًا أو خاصًا. حدد معرف الخادم وما إذا كان عامًا أم خاصًا. صحيح = خطأ عام = خاص

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

Minehut . ChangeServerVisibility ( SuperSecretServersID , False ) ;

إنستالسيرفيربلوجين ()

يقوم بتثبيت البرنامج المساعد المحدد على خادم Minecraft. للعثور على معرفات المكونات الإضافية، يوصى باستخدام وظيفة 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" ) ;

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

خادم الإصلاح ()

إصلاح جميع ملفات خادم 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 وخدمته. استخدم هذا إذا كنت لا تخطط لبدء تشغيل الخادم مرة أخرى خلال الدقائق الخمس التالية.

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