C# SAMPQuery — Библиотека для отправки запросов на сервера SAMP

[Mavi_]

SAMPQuery

SAMPQuery — это библиотека, которая позволяет запрашивать информацию о серверах SAMP и выполнять RCON команды. Включает в себя коррекцию кодировки, поддержка подключении по имен хоста, асинхронные запросы и многое другое.

Установка

Менеджер пакетов

Install-Package SAMPQuery -Version 1.1.0

Терминал

$ dotnet add package SAMPQuery --version 1.1.0

Package Reference

<PackageReference Include="SAMPQuery" Version="1.1.0" />

Клонировать репозиторию

$ git clone https://github.com/justmavi/sampquery.git

Использование

var server = new SampQuery("localhost", 7777);

ServerInfo serverInfo = await server.GetServerInfoAsync();
ServerRules serverRules = await server.GetServerRulesAsync();
IEnumerable<ServerPlayer> serverPlayers = await server.GetServerPlayersAsync();

Console.WriteLine($"Welcome to ${serverInfo.HostName}! Mapname: ${serverRules.MapName}");
Console.WriteLine("Players online:");
serverPlayers.ToList().ForEach(player => Console.WriteLine(player.PlayerName));

Документация

Конструктор

var server = new SampQuery("127.0.0.1", 7777);

Конструктор имеет перегрузки:

SampQuery(IPAddress ip, ushort port)
SampQuery(string ip, ushort port, string password)
SampQuery(IPAddress ip, ushort port, string password)
SampQuery(IPAddress ip) // будет использоваться дефолтный 7777 порт
SampQuery(string ip) // будет использоваться дефолтный 7777 порт. Также здесь поддерживается строка подключения формата "HOST:PORT".

Имя хоста также поддерживается:

var server = new SampQuery("localhost", 7777);

GetServerInfo
Запрашивает основную информацию о сервере

var server = new SampQuery("127.0.0.1", 7777);
ServerInfo data =  server.GetServerInfo();

Console.WriteLine($"Server {data.HostName}. Online: {data.Players}/{data.MaxPlayers}");

GetServerInfoAsync
Асинхронно запрашивает основную информацию о сервере

var server = new SampQuery("127.0.0.1", 7777);
ServerInfo data = await server.GetServerInfoAsync();

Console.WriteLine($"Server {data.HostName}. Online: {data.Players}/{data.MaxPlayers}");

GetServerRules
Запрашивает правила, назначенные сервером

var server = new SampQuery("127.0.0.1", 7777);
ServerInfo data = server.GetServerRules();

Console.WriteLine($"Lagcomp {(data.Lagcomp ? "On" : "Off")}. Map: {data.MapName}. SAMPCAC: {data.SAMPCAC_Version ?? "Isn't required"}");

GetServerRulesAsync
Асинхронно запрашивает правила, назначенные сервером

var server = new SampQuery("127.0.0.1", 7777);
ServerInfo data = await server.GetServerRulesAsync();

Console.WriteLine($"Lagcomp {(data.Lagcomp ? "On" : "Off")}. Map: {data.MapName}. SAMPCAC: {data.SAMPCAC_Version ?? "Isn't required"}");

GetServerPlayers
Запрашивает игроков в онлайне с детальной информацией (работает до 100 игроков, лимит SA-MP)

 var server = new SampQuery("127.0.0.1", 7777);
 IEnumerable<ServerPlayer> players = server.GetServerPlayers();

 Console.WriteLine("ID | Nick | Score | Ping\n");

 foreach(ServerPlayer player in players)
 {
     Console.WriteLine($"{player.PlayerId} | {player.PlayerName} | {player.PlayerScore} | {player.PlayerPing}");
 }

Максимальное значение ID игрока 255. Двухбайтовые идентификаторы не поддерживаются (ограничение SA-MP).

GetServerPlayersAsync
Асинхронно запрашивает игроков в онлайне с детальной информацией (работает до 100 игроков, лимит SA-MP)

 var server = new SampQuery("127.0.0.1", 7777);
 IEnumerable<ServerPlayer> players = await server.GetServerPlayersAsync();

 Console.WriteLine("ID | Nick | Score | Ping\n");

 foreach(ServerPlayer player in players)
 {
     Console.WriteLine($"{player.PlayerId} | {player.PlayerName} | {player.PlayerScore} | {player.PlayerPing}");
 }

Максимальное значение ID игрока 255. Двухбайтовые идентификаторы не поддерживаются (ограничение SA-MP).

SendRconCommand
Исполняет команду RCON

 var server = new SampQuery("127.0.0.1", 7777, "helloworld");
string answer = sampQuery.SendRconCommand("varlist");

Console.WriteLine($"Server says: {answer}");

SendRconCommandAsync
Асинхронно исполняет команду RCON

var server = new SampQuery("127.0.0.1", 7777, "helloworld");
string answer = await sampQuery.SendRconCommandAsync("varlist");

Console.WriteLine($"Server says: {answer}");

ServerInfo
Класс, представляющий информацию о сервере. Свойства:

• HostName
• GameMode
• Language
• Players
• MaxPlayers
• Password
• ServerPing

ServerRules
Класс, представляющий правила сервера. Свойства:

• Lagcomp
• MapName
• Version
• SAMPCAC_Version
• Weather
• Weburl
• WorldTime
• Gravity

ServerPlayer
Класс, представляющий информацию об игроке. Свойства:

• PlayerId
• PlayerName
• PlayerScore
• PlayerPing

Благодарность

• Отдельная благодарность @continue98 за помощь.

Оставайся на связи

• Автор — justmavi

 

[MrCreepTon]

Тоже неплохой вариант

SA-MP RCON Class

Hey guys, friend of mine, named "NanoCat" (also known as [G-Moder]NanoCat on steam), wanted to release his own recoded SA-MP RCON class on U...

www.unknowncheats.me

 

[Mavi_]

Тоже неплохой вариант

SA-MP RCON Class

Hey guys, friend of mine, named "NanoCat" (also known as [G-Moder]NanoCat on steam), wanted to release his own recoded SA-MP RCON class on U...

www.unknowncheats.me

Да, видел уже. Этот вариант тоже унаследован от вики, но баг с чтением данных там опять же, не исправлен (можете сами посмотреть). Да и разницы между моим и этим вариантом достаточно много, как минимум, проще в использовании (изначальная цель была только это).

Реализацию IDisposable и асинхронные методы добавлю в следующей версии, как руки дойдут ))

 

[odelyaZ]

Жалко такой темы для JS нету :(

 

[MrCreepTon]

Жалко такой темы для JS нету :(

эм

GitHub - ufteers/samp-query-info: 💾 NodeJS script for obtaining public information about SA-MP server.

💾 NodeJS script for obtaining public information about SA-MP server. - ufteers/samp-query-info

github.com

GitHub - frapsy/samp-query-api

Contribute to frapsy/samp-query-api development by creating an account on GitHub.

github.com

 

[odelyaZ]

эм

GitHub - ufteers/samp-query-info: 💾 NodeJS script for obtaining public information about SA-MP server.

💾 NodeJS script for obtaining public information about SA-MP server. - ufteers/samp-query-info

github.com

GitHub - frapsy/samp-query-api

Contribute to frapsy/samp-query-api development by creating an account on GitHub.

github.com

Они отличаются, в этих не так много функций как хотелось бы. Я говорил конкретно про аналог для JS

 

[Mavi_]

v1.0.1 is live

- Добавлены асинхронные аналоги для всего ранее доступного функционала
- Добавлена возможность подключиться к серверу по hostname
- Добавлена поддержка .net5, убрана поддержка .net2
- Добавлена документация
- Изменились названия классов и пространства имён (посмотрите readme в github)
- Общий рефакторинг кода. Исправлено большое количество ошибок

Прошлая версия несовместима с текущей!

Доступно на NuGet для скачивания.
Для более подробного изучения - GitHub.

#Kudos некому kolya112 за то, что заставил меня взяться за дело, а то сам я бы вряд ли.

v1.0.2
- Исправлена ошибка при подключении к локальному серверу по hostname в дистрибютивах Linux. (#4)

 

[Mavi_]

v1.1.0

- Исправлена критическая ошибка, из-за которой библиотека не работала на старых версиях фреймворка.
Протестил под .net7.0, .net6.0, .net5.0 и .netcoreapp3.1 - работает как надо.
- Добавлено 2 новых перегрузок конструктора

var sampquery = new SampQuery("localhost"); // будет использоваться дефолтный порт 7777. Такая же перегрузка и для типа IPAddress
var sampquery = new SampQuery("localhost:6666"); // Такой вариант так же теперь будет работать
var sampquery = new SampQuery("localhost:7777", 6666); // такой вариант работать НЕ будет. Либо то, либо то, иначе никак.

- Добавлена поддержка .NET 7.0.

Доступно на NuGet для скачивания.
Для более подробного изучения - GitHub.