mirror of
https://github.com/yawaflua/SPWorldsWrapper.git
synced 2025-12-13 17:16:21 +02:00
Compare commits
20 Commits
v1.0.1.3
...
yawaflua-p
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
01cc988f85 | ||
|
|
c84dbecbaf | ||
|
|
8b0043e1ab | ||
|
|
b513e9489d | ||
|
|
46f184d775 | ||
|
|
85c4d5e099 | ||
|
|
1f81fd5cbd | ||
|
|
1201e16caa | ||
|
|
a1862446a6 | ||
|
|
ea79677c2e | ||
|
|
df8bb5ab29 | ||
|
|
d4489ecf05 | ||
|
|
94794821ab | ||
|
|
88a021e2bb | ||
|
|
96237ce63b | ||
|
|
7330479487 | ||
|
|
24d944e1ce | ||
|
|
0b3b224eb1 | ||
|
|
77821e56f4 | ||
|
|
71ec3b5f1b |
7
.github/workflows/nuget.yml
vendored
7
.github/workflows/nuget.yml
vendored
@@ -12,7 +12,7 @@ jobs:
|
|||||||
- name: Setup .NET Core
|
- name: Setup .NET Core
|
||||||
uses: actions/setup-dotnet@v1
|
uses: actions/setup-dotnet@v1
|
||||||
with:
|
with:
|
||||||
dotnet-version: '8.x.x'
|
dotnet-version: '7.x.x'
|
||||||
- name: Set output
|
- name: Set output
|
||||||
id: vars
|
id: vars
|
||||||
run: echo "tag=${GITHUB_REF#refs/*/}" >> $GITHUB_OUTPUT
|
run: echo "tag=${GITHUB_REF#refs/*/}" >> $GITHUB_OUTPUT
|
||||||
@@ -21,5 +21,8 @@ jobs:
|
|||||||
with:
|
with:
|
||||||
PROJECT_FILE_PATH: SPWorldsWrapper/SPWorldsWrapper.csproj
|
PROJECT_FILE_PATH: SPWorldsWrapper/SPWorldsWrapper.csproj
|
||||||
VERSION_STATIC: ${{ steps.vars.outputs.tags }}
|
VERSION_STATIC: ${{ steps.vars.outputs.tags }}
|
||||||
TAG_FORMAT: '*'
|
TAG_COMMIT: true
|
||||||
|
TAG_FORMAT: ${{ steps.meta.outputs.tags }}
|
||||||
NUGET_KEY: ${{secrets.NUGET_API_KEY}}
|
NUGET_KEY: ${{secrets.NUGET_API_KEY}}
|
||||||
|
NUGET_SOURCE: https://api.nuget.org
|
||||||
|
INCLUDE_SYMBOLS: false
|
||||||
|
|||||||
@@ -1,9 +1,9 @@
|
|||||||
# SPWorldsWrapper
|
# SPWorldsWrapper
|
||||||

|

|
||||||
|
|
||||||
Actions pass:
|
Actions pass:
|
||||||
|
|
||||||

|
|
||||||

|

|
||||||
|
|
||||||
Это довольно простой wrapper для работы с сайтом, а не с апи. Он позволяет:
|
Это довольно простой wrapper для работы с сайтом, а не с апи. Он позволяет:
|
||||||
@@ -11,6 +11,11 @@ Actions pass:
|
|||||||
- Добавлять/удалять города на карте(ПРИ НАЛИЧИИ РОЛИ КАРТОГРАФА)
|
- Добавлять/удалять города на карте(ПРИ НАЛИЧИИ РОЛИ КАРТОГРАФА)
|
||||||
- Получать любые данные, используя HttpClient, внутри класса
|
- Получать любые данные, используя HttpClient, внутри класса
|
||||||
|
|
||||||
|
# Установка
|
||||||
|
```cli
|
||||||
|
dotnet add package SPWorldsWrapper
|
||||||
|
```
|
||||||
|
|
||||||
# Добавление функций
|
# Добавление функций
|
||||||
Если вы хотите помочь с разработкой, просьба создать Pull Request, где будет созданы нужные методы и, желательно, комментарии к ним.
|
Если вы хотите помочь с разработкой, просьба создать Pull Request, где будет созданы нужные методы и, желательно, комментарии к ним.
|
||||||
Если вы хотите помочь с расширением этого wrapper`a, просьба создать Issue, где вы подробно изложите, что именно вам надо.
|
Если вы хотите помочь с расширением этого wrapper`a, просьба создать Issue, где вы подробно изложите, что именно вам надо.
|
||||||
|
|||||||
43
SPWorldsWrapper/README.md
Normal file
43
SPWorldsWrapper/README.md
Normal file
@@ -0,0 +1,43 @@
|
|||||||
|
# SPWorldsWrapper
|
||||||
|

|
||||||
|
|
||||||
|
Actions pass:
|
||||||
|
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Это довольно простой wrapper для работы с сайтом, а не с апи. Он позволяет:
|
||||||
|
- Находить более расширные данные о пользователь от сайта, нежели стандартные апи.
|
||||||
|
- Добавлять/удалять города на карте(ПРИ НАЛИЧИИ РОЛИ КАРТОГРАФА)
|
||||||
|
- Получать любые данные, используя HttpClient, внутри класса
|
||||||
|
|
||||||
|
# Установка
|
||||||
|
```cli
|
||||||
|
dotnet add package SPWorldsWrapper
|
||||||
|
```
|
||||||
|
|
||||||
|
# Добавление функций
|
||||||
|
Если вы хотите помочь с разработкой, просьба создать Pull Request, где будет созданы нужные методы и, желательно, комментарии к ним.
|
||||||
|
Если вы хотите помочь с расширением этого wrapper`a, просьба создать Issue, где вы подробно изложите, что именно вам надо.
|
||||||
|
|
||||||
|
# Использование
|
||||||
|
## Перевод игроку, имея только никнейм
|
||||||
|
Ниже есть пример использования. В ходе этого примера мы переводим игроку 1 АР, получая карту по никнейму, а потом переводя на нее ары(через [библиотеку](https://github.com/Mih4n/spworlds-csharp-library)).
|
||||||
|
```cs
|
||||||
|
using SPWorldsWrapper;
|
||||||
|
using SPWorlds;
|
||||||
|
|
||||||
|
// инициилизация конструктора
|
||||||
|
// Токен надо получать на сайте, либо через cookies, либо через проверку request
|
||||||
|
SPWrapper wrapper = new SPWrapper ("AaBbCcDd:123123123");
|
||||||
|
// использование сторонней библиотеки от Mih4n
|
||||||
|
//! ТОКЕНЫ ДЛЯ SPWorlds и SPWrapper РАЗНЫЕ !
|
||||||
|
SPWorlds sp = new SPworlds("[ваш айди]","[ваш токен]");
|
||||||
|
|
||||||
|
// Пример, перевод на карту игрока по никнейму:
|
||||||
|
SPUser user = await wrapper.getUserData("yawaflua");
|
||||||
|
sp.CreateTransaction(user.CardsOwned.First().number, 1, "Привет от yawaflua")
|
||||||
|
```
|
||||||
|
# FAQ
|
||||||
|
- Где получить токен для использования? - [тут](https://github.com/yawaflua/SPWorldsWrapper/blob/master/GETTOKEN.md)
|
||||||
|
- Как сделать так, чтобы токен не слетал? - Надо использовать впн, с выходной точкой в виде вашего сервера. Я использую [tailscale](https://tailscale.com/), но в России его больше нельзя скачать. Можно попробовать настроить OpenVPN или иные сервисы. [Тут](https://habr.com/ru/companies/ruvds/articles/726718/) например описано, как можно легко поднять с помощью сервиса RuVDS, где вы получите и VPN, и VDS. Я бы не советовал исполользовать RuVDS из-за большой стоимость и ужасного качества поддержки и серверов, но это выбор каждого.
|
||||||
@@ -1,10 +1,17 @@
|
|||||||
|
|
||||||
<Project Sdk="Microsoft.NET.Sdk">
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
<PropertyGroup>
|
<PropertyGroup>
|
||||||
<TargetFramework>net8.0</TargetFramework>
|
<TargetFramework>net7.0</TargetFramework>
|
||||||
<ImplicitUsings>enable</ImplicitUsings>
|
<ImplicitUsings>enable</ImplicitUsings>
|
||||||
<Nullable>enable</Nullable>
|
<Nullable>enable</Nullable>
|
||||||
<Version>1.0.1</Version>
|
<PackageId>SPWorldsWrapper</PackageId>
|
||||||
|
<Description>Библиотека для работы с сайтом spworlds.ru</Description>
|
||||||
|
<PackageLicenseExpression>MIT</PackageLicenseExpression>
|
||||||
|
<Version>1.0.5</Version>
|
||||||
|
<Authors>yawaflua</Authors>
|
||||||
|
<Company>yawaflua</Company>
|
||||||
|
<RepositoryUrl>https://github.com/yawaflua/SPWorldsWrapper</RepositoryUrl>
|
||||||
|
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
|
|
||||||
<ItemGroup>
|
<ItemGroup>
|
||||||
|
|||||||
@@ -2,13 +2,22 @@
|
|||||||
using SPWorldsWrapper.Types;
|
using SPWorldsWrapper.Types;
|
||||||
using System.Net;
|
using System.Net;
|
||||||
using System.Net.Http.Json;
|
using System.Net.Http.Json;
|
||||||
|
using System.Reflection.Metadata.Ecma335;
|
||||||
using System.Text.Json.Nodes;
|
using System.Text.Json.Nodes;
|
||||||
|
|
||||||
namespace SPWorldsWrapper
|
namespace SPWorldsWrapper
|
||||||
{
|
{
|
||||||
|
public class AuthentificationError : Exception
|
||||||
|
{
|
||||||
|
public AuthentificationError(string? message, Exception? innerException) : base(message, innerException) { }
|
||||||
|
public AuthentificationError() : base() { }
|
||||||
|
public AuthentificationError(string? message) : base(message) { }
|
||||||
|
}
|
||||||
public class SPWrapper
|
public class SPWrapper
|
||||||
{
|
{
|
||||||
public readonly HttpClient client;
|
public readonly HttpClient client;
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Асинхронный wrapper для работы напрямую с сайтом, а не с API SPWorlds.ru
|
/// Асинхронный wrapper для работы напрямую с сайтом, а не с API SPWorlds.ru
|
||||||
@@ -21,7 +30,11 @@ namespace SPWorldsWrapper
|
|||||||
client = new(handler);
|
client = new(handler);
|
||||||
client.BaseAddress = new Uri("https://spworlds.ru/api/");
|
client.BaseAddress = new Uri("https://spworlds.ru/api/");
|
||||||
cookieContainer.Add(client.BaseAddress, new Cookie("jeff", token));
|
cookieContainer.Add(client.BaseAddress, new Cookie("jeff", token));
|
||||||
spwLogin();
|
var spwLoginMethod = spwLogin();
|
||||||
|
if (!spwLoginMethod.Result)
|
||||||
|
{
|
||||||
|
throw new AuthentificationError("Ошибка парсинга данных от сайта. Проверьте токен, IP сервера и статус сайта SPWORLDS.RU");
|
||||||
|
}
|
||||||
|
|
||||||
}
|
}
|
||||||
/// <summary>
|
/// <summary>
|
||||||
@@ -30,11 +43,24 @@ namespace SPWorldsWrapper
|
|||||||
/// Если иное - токен слетел!
|
/// Если иное - токен слетел!
|
||||||
/// </summary>
|
/// </summary>
|
||||||
/// <returns>Ничего</returns>
|
/// <returns>Ничего</returns>
|
||||||
public async Task spwLogin()
|
public async Task<bool> spwLogin()
|
||||||
{
|
{
|
||||||
var content = new StringContent(@"{}");
|
var content = new StringContent(@"{}");
|
||||||
var responseMessage = await client.PostAsync("auth/refresh_token", content);
|
var responseMessage = await client.PostAsync("auth/refresh_token", content);
|
||||||
await Console.Out.WriteLineAsync(await responseMessage.Content.ReadAsStringAsync());
|
var bodyFromSPW = await responseMessage.Content.ReadAsStringAsync();
|
||||||
|
var serializedBody = JsonNode.Parse(bodyFromSPW);
|
||||||
|
if (serializedBody == null)
|
||||||
|
{
|
||||||
|
Console.Error.WriteLine("error: Some error returned from site.");
|
||||||
|
Console.WriteLine("debug: please, check your authorization token");
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
Console.WriteLine(await responseMessage.Content.ReadAsStringAsync());
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
return serializedBody != null;
|
||||||
}
|
}
|
||||||
/// <summary>
|
/// <summary>
|
||||||
/// Получение данных пользователя по юзернейму.
|
/// Получение данных пользователя по юзернейму.
|
||||||
@@ -54,12 +80,11 @@ namespace SPWorldsWrapper
|
|||||||
/// </summary>
|
/// </summary>
|
||||||
/// <param name="userName">Никнейм пользователя(из майнкрафта)</param>
|
/// <param name="userName">Никнейм пользователя(из майнкрафта)</param>
|
||||||
/// <example> var a = "a";</example>
|
/// <example> var a = "a";</example>
|
||||||
/// <returns><see cref="SPUser" /> пользователь от сайта, или ошибку.</returns>
|
/// <returns><see cref="SPUser" /> пользователь от сайта, или null.</returns>
|
||||||
public async Task<SPUser> getUserData(string userName)
|
public async Task<SPUser?> getUserData(string userName)
|
||||||
{
|
{
|
||||||
var request = await client.GetAsync($"pl/accounts/{userName}");
|
var request = await client.GetAsync($"pl/accounts/{userName}");
|
||||||
await Console.Out.WriteLineAsync(request.Content.ReadAsStringAsync().Result);
|
SPUser? response = JsonConvert.DeserializeObject<SPUser>(request.Content.ReadAsStringAsync().Result.ToString());
|
||||||
SPUser response = JsonConvert.DeserializeObject<SPUser>(request.Content.ReadAsStringAsync().Result.ToString());
|
|
||||||
return response;
|
return response;
|
||||||
}
|
}
|
||||||
/// <summary>
|
/// <summary>
|
||||||
|
|||||||
Reference in New Issue
Block a user