Этот проект позволяет легко интегрировать его в вашу учетную запись/сервер minehut. Он включает в себя все функции API-интерфейса minehut, включая возможность создавать/проверять учетные записи.
Этот проект был написан на Visual Basic, но, поскольку это библиотека .NET, использование ее на C# не имеет никакого значения.
Первую часть вам нужно знать: основная часть этой библиотеки находится в MinehutAPIClient.
Большинство функций API minehut потребуют входа в систему, чтобы вы могли получить доступ к своим серверам. Для этого используйте метод Login(). Для большинства функций, содержащихся в этом классе, рекомендуется импортировать класс Minehut.Types.
using Minehut . Types ;
Это позволит аутентифицировать клиента в API minehut, что позволит вам работать с вашими серверами. С#
MinehutApiClient Minehut = New MinehutApiClient ( ) ;
Minehut . Login ( "[email protected]" , "SuperSecretPassword" ) ;
Используя эту функцию, вы можете получить доступ ко всем работающим в данный момент публичным серверам minehut. Эти серверы возвращаются как IList типа Сервер. (В пределах Minehut.Types)
IList < Server > servers = Minehut . GetServers ( ) ;
При этом извлекаются идентификаторы ваших серверов, эти идентификаторы используются для указания того, на какой сервер вы хотите воздействовать с помощью других функций/методов.
String [ ] MyServers = Minehut . GetSelfServers ;
Эта функция получит все плагины, доступные на minehut.
IList < Plugin > Plugins = Minehut . GetPlugins ( ) ;
Это позволит получить расширенную информацию об указанном сервере. Ему требуется идентификатор сервера, и он вернет информацию о сервере.
String [ ] MyServers = Minehut . GetSelfServers ( ) ;
String Sevrer1ID = MyServers [ 0 ] ;
ExtendedServer ExtendedServerInformation = Minehut . GetServerByID ( Server1ID ) ;
Эта функция вернет информацию о сохранении как GetServerByID(), но вместо идентификатора сервера будет использоваться имя сервера.
ExtendedServer ExtendedServerInformation = Minehut . GetServerByID ( "Skyblock" ) ;
Используя эту функцию, вы можете получить файлы, хранящиеся на вашем сервере 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" ) ;
Это вернет все установленные плагины указанного сервера. Они возвращаются как IList установленного плагина (в 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 (в Minehut.types). Он инкапсулирует идентификатор сеанса и токен доступа, необходимые для аутентификации в API minehut. Это полезно, если вы хотите сохранить идентификатор/токен сеанса. Его основное использование предназначено для поставщика MinehutEventprovider. Примеры этого будут рассмотрены далее в этом документе.
ПРИМЕЧАНИЕ. Перед вызовом этой функции вам необходимо войти в 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-адрес сервера. Если имя уже занято, выдаст ошибку, поэтому я рекомендую добавить его в 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!" ) ;
}
Используя это, вы можете изменить любые свойства сервера. Указав идентификатор сервера, свойство сервера (с помощью перечисления ServerProperties, хранящегося в Minehut.Types) и новое значение свойства, вы можете изменить любое из этих свойств: «Разрешить полет», «Разрешить Пустоту», «Объявить о достижениях игрока», «Сложность», «Включить командные блоки», «Принудительное управление». Режим игры, Режим игры, Генерация структур, Настройки генератора, Хардкор, Название уровня, Тип уровня, Максимальное количество игроков (10 или 20, можно увеличить, если у вас платный сервер), PVP, пакет ресурсов (ссылка для скачивания), спаун животных и спаун мобов.
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" ) ;
Удаляет плагин с сервера 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 ) ;
Запускает сервер Майнкрафт. ПРИМЕЧАНИЕ. Используйте это только в том случае, если служба уже подключена к сети. Обычно лучше всего использовать 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" ) ;