Momencik

Czekaj na odpowiedź servera..

Uwaga

  

Forum Margonem > Dodatki do gry > Zmiany w API

[zamknięty] [Przeszukaj temat] [Dodaj do ulubionych]
Koniec strony Strona: [1]

Clarion

3012936
2886
Zmiana sposobu odpytywania o ekwipunek gracza.

W najbliższy poniedziałek, 1 marca br., zostanie zablokowane odpytywanie serwera o stan ekwipunku konkretnej postaci w grze przy pomocy zapytania getvar_eqcache.
Dodatki używające przestarzałej metody powinny, do tego czasu, przestawić się na nowy sposób odpytywania. Poniżej informacje techniczne:
Przykładowy STARY adres: http://fobos.margonem.pl/engine?t=getvar_eqcache&id=202596
Nowy adres: https://mec.garmory-cdn.cloud/pl/fobos/100/202596.json
Struktura nowego adresu:
https://mec.garmory-cdn.cloud/ - stała część
/pl/ lub /en/ w zależności od tego czy gramy na PL czy na COM
/fobos/ - pisana małymi literami nazwa świata na którym aktualnie gramy
/100/ - katalog, którego numer obliczany za pomocą ID_GRACZA % 128 (reszta z dzielenia przez 128)
202596.json - plik JSON, gdzie podany numer jest numerem ID_GRACZA

UWAGA: Należy dodatkowo uwzględnić obsługę 404 Not Found w logice przetwarzania aby było to traktowane tak, jakby otrzymano pusty obiekt JSON.

W stosunku do poprzedniego mechanizmu nastąpiła różnica w zwracanej informacji. Wcześniej zawsze zwracany był JSON i nawet jeżeli gracz nie istnieje to zwracany był PUSTY obiekt: {}. W przypadku nowego mechanizmu zwracane będą kody odpowiedzi:
200 OK - w przypadku prawidłowej odpowiedzi,
404 Not Found - w przypadku, gdy gracz nie istnieje bądź też nie miał na sobie żadnego ekwipunku.
2021.02.26 14:39:24
Ocena: 11
cytuj | ID:44731596

Clarion

3012936
2886
Otwarta beta styli i skryptu wyświetlania przedmiotów.

W momencie publikacji posta rusza otwarta beta styli i skryptów wyświetlania prawidłowo tipów dla przedmiotów. Taka implementacja w szczególności będzie przydatna przy prowadzeniu serwisu obsługującego przedmioty Margonem wraz z jego statystykami. Korzystając z przygotowanego parsera przedmiotów macie pewność, że po udostępnieniu kolejnej wersji gry, obsługa nowych przedmiotów, czy ich statystyk zawsze będzie poprawnie wspierana.

Na chwilę obecną udostępniamy wersję developerską API (toteż nie wszystkie funkcjonalności mogą działać poprawnie, przed zgłoszeniem błędu należy upewnić się, że błąd nie leży po stronie dewelopera).


Aby poprawnie wyświetlać na stronach tipy przedmiotów należy:
1. Załadować następujące pliki skryptów:
• Skrypt odpowiedzialny za generowanie tipów, ich parsowanie oraz obsługę przez JQuery wyświetlania ich po najechaniu (w przyszłości ulegnie zmianie link do tego pliku).
https://dev-commons.margonem.pl/js/tooltips_packedv2.js
• Skrypt odpowiedzialny za tłumaczenia dla wersji PL.
https://commons.margonem.pl/js/dictionaries/dictionary_pl.js
2. Załadować następujący plik stylu:
• Styl odpowiedzialny za wyświetlanie przedmiotów
https://commons.margonem.pl/css/tipsParser.min.css
3. Zdefiniować globalną zmienną "items" w formie obiektu:
• Przykładowa definicja:
<html>
<head>
<script type="text/javascript">
let items = {};
...
</script>
</head>
...

Całość wykonywana jest dla wszystkich obiektów, które posiadają atrybut "tip" oraz posiadają ustawioną wartość "margonem_item" dla atrybutu class dla bieżącego elementu. W atrybucie "tip" powinien znaleźć się JSON, który zawiera informacje o przedmiocie.

Przykładowy kod przedstawiający sposób wyświetlania przedmiotów:
<div class="itemborder">
<img alt="" src="https://micc.garmory-cdn.cloud/obrazki/itemy/kon/sur33.gif"
class="margonem_item margonem_pl_item item_1417394591"
tip='{"id":"539865508","hid":"1417394591","tpl":"178","name":"Du\u017ce mi\u0119so","icon":"kon\/sur33.gif","cl":"16","pr":"210","prc":"zl","stat":"leczy=36;opis=Po\u017cywne mi\u0119so."}'
ctip="item">
</div>


W przypadku znalezienia błędu prosimy o zgłoszenie go na podany adres: clarion@margonem.pl wraz z szczegółowym opisem błędu.
2021.07.06 12:17:10
Ocena: 3
cytuj | ID:45022223

Clarion

3012936
2886
Zmiana statystyki odpowiedzialnej za rzadkość przedmiotu

Wraz z najbliższą wersją gry pojawi się duża zmiana w rzadkościach przedmiotu. Od teraz rzadkość przedmiotu będzie wyznaczana nową statystyką o nazwie rarity, która będzie przyjmowała w wartości typ rzadkości przedmiotu. Możliwe rzadkości prezentują się następująco:
- common - typ pospolity, brak odpowiednika.
- unique - typ unikatowy, odpowiednik obecnej statystyki "unique",
- heroic - typ heroiczny, odpowiednik obecnej statystyki "heroic",
- upgraded - typ ulepszony, odpowiednik obecnej statystyki "upgraded",
- legendary - typ legendarny, odpowiednik obecnej statystyki "legendary",
- artefact - typ artefakt, odpowiednik obecnej statystyki "artefact".

Stary format zapisu dla przedmiotu unikatowego
{
"cl": 24
"icon": "bag/torba12.gif"
"loc": "g"
"name": "Torba podróżna"
"pr": 8
"prc": "zl"
"st": 20
"stat": "bag=42;permbound;soulbound;unique"
"tpl": 1456
}

Nowy format zapisu dla przedmiotu unikatowego
{
"cl": 24
"icon": "bag/torba12.gif"
"loc": "g"
"name": "Torba podróżna"
"pr": 8
"prc": "zl"
"st": 20
"stat": "bag=42;permbound;soulbound;rarity=unique"
"tpl": 1456
}
2021.09.03 10:48:58
Ocena: 3
cytuj | ID:45106713

Clarion

3012936
2886
W dniu 04.10.2021 r. zostanie wyłączony serwis odpowiedzialny za przetrzymywanie grafik gry dostępny pod adresem:
https://img.margonem.pl
W związku z tym wszystkie odnośniki kierujące do grafik znajdujących się pod tym adresem przestaną działać. Bardzo prosimy o korzystanie z nowego serwisu dostępnego pod adresem:
https://micc.garmory-cdn.cloud
2021.09.06 12:15:38
cytuj | ID:45109996

Clarion

3012936
2886
Aukcjoner - zmiana formatu komunikacji

Wraz z wprowadzeniem wersji 31.0.0. zostanie zmieniony sposób komunikacji z serwerem gry w module aukcji. Założeniem zmiany, było ujednolicenie oraz zwiększenie wydajności działania, m.in. poprzez paginację zakładek.

1. Interakcja w module
Przełączanie między zakładkami, a także interakcja z danymi odbywa się przy wykorzystaniu następującego żądania:
t=ah&cat=0&filter=||||||||||&sort=1|0'
Gdzie:
cat - to jedna z dostępnych kategorii przedmiotów (1 - 16, 18, 21, 22, 23, 24, 27). Dla wartości "0" zwracane są wszystkie przedmioty.
filter - to konkretny filtr oznaczony kolejno: lvlMin|lvlMax|prof|minRarity|priceMin|priceMax|buyType|tabType|mode|page|name
- minRarity: jedna z dostępnych rzadkości itemów
- prof: profesja (jeden znak z: b, h, m, p, t, w)
- buyType: None = 0, OnlyBuyNow = 1, OnlyBids = 2,
- tabType (wymagany): zakładka MySells = 1, MyBids = 2, MyObserved = 3, All = 4,
- mode: Normal = 0, Events = 1,
- page (wymagany): numer strony
- name: nazwa przedmiotu
sort - sposób sortowania wyników, dostępne sposoby:
- type: EndTs = 1, Price = 2, Buyout = 3, Level = 4, Name = 5,
- order: Ascending = 0, Descending = 1,


2. Wystawienie przedmiotu
Wystawienie przedmiotu odbywa się przy wykorzystaniu następującego żądania:
t=ah&action=sell&item=?&price=?&buy_out=?&time=?&is_featured=?
Gdzie:
item - to numer identyfikacyjny przedmiotu (nie mylić z ukrytym identyfikatorem przedmiotu, HID),
price - cena startowa licytacji,
buy_out - cena kup teraz,
time - czas (jednostki godzinowe),
is_featured - czy aukcja ma być wyróżniona,

3. Usunięcie wystawionego przedmiotu
Usunięcie odbywa się poprzez następujące żądanie:
t=ah&action=end&item=?
Gdzie:
item - to numer identyfikacyjny przedmiotu.

4. Wykupienie przedmiotu
Wykupienie odbywa się poprzez następujące żądanie:
t=ah&action=buyout&item=?
Gdzie:
item - to numer identyfikacyjny przedmiotu

5. Licytowanie przedmiotu
Aby zalicytować przedmiot należy skonstruować następujące żądanie:
t=ah&action=bid&item=?&price=?
Gdzie:
item - to numer identyfikacyjny przedmiotu,
price - nowa cena licytacji,

6. Dodanie/usunięcie do/z obserwowanych przedmiotów (nowość)
Dodanie:
t=ah&action=observation_add&item=?
Gdzie:
item - to numer identyfikacyjny przedmiotu,

Usunięcie:
t=ah&action=observation_remove&item=?&cat=0&filter=|||||||||
Gdzie:
item - to numer identyfikacyjny przedmiotu,
cat i filter: aktualnie ustawiony filtr (na zakładce MyObserved odpowiedzią będzie usunięcie aukcji z listy, na pozostałych będzie odpowiedź odświeżenia aukcji),

7. Zmiana czasu trwającej/-ych aukcji (nowość)
Zmiana dla konkretnej aukcji:
t=ah&action=change_time&item=?&time=?
Gdzie:
item - to numer identyfikacyjny przedmiotu,
time - to nowy czas trwania aukcji,

Zmiana dla wszystkich trwających aukcji:
t=ah&action=change_time_all&time=?cat=?&filter=?&sort=?
Gdzie:
time - to nowy czas trwania aukcji,
cat, filter i sort - aktualnie ustawiony filtr i sort.
2021.11.02 20:18:05
Ocena: 3 :: Oceń wypowiedź:
cytuj | ID:45170074
Początek strony Strona: [1]

Temat zamknięty, nie można w nim pisać postów

Forum Margonem > Dodatki do gry > Zmiany w API

Podaj powód dlaczego oceniasz post na

Pozostało ważnych głosów na dziś: 0, po przekroczeniu limitu
Twój głos pokaże się przy wiadomości, ale nie doliczy się do reputacji gracza.


* pole nieobowiązkoweLimit znaków 0/50

Zgłoszenie postu do moderacji.
Poniżej możesz podać powód Twojego zgłoszenia.

Pamiętaj, że za bezsensowny komentarz możesz otrzymać knebla i stracić swoją reputację.

Limit znaków 0/150

-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -
AND grp=0