MarketListing

MarketListing (model/MarketListing.java) to aktywna oferta. Implementuje ConfigurationSerializable i jest rejestrowana w MarketPlace.onEnable przez ConfigurationSerialization.registerClass(MarketListing.class).

Pola

Konstruktor: new MarketListing(id, seller, sellerName, item, price, timestamp, oraxenId, nexoId).

Nie ma pola „aktywna / zarezerwowana”. Rezerwacja podczas zakupu jest w pamięci: MarketManager.reservedListings.

Serializacja do listings.yml

serialize() zapisuje: id, seller (UUID jako string), sellerName, item, price, timestamp. oraxenId / nexoId tylko gdy nie-null.

deserialize(Map) wymaga item przez ItemStackSerializer.parse. Brak itemu:

IllegalArgumentException: Brak przedmiotu w ofercie #<id>

Brak liczby dla id / price / timestamp:

IllegalArgumentException: Brak lub nieprawidłowa wartość dla: <klucz>

StorageManager.parseListing akceptuje też starszy format Map i woła MarketListing.deserialize. Uszkodzony item: log Pominięto oferte #<id> - brak przedmiotu.

Tworzenie

StorageManager.createListing(seller, sellerName, item, price, oraxenId, nexoId):

1. id = nextId++
2. timestamp = System.currentTimeMillis()
3. dodanie do listy w pamięci
4. synchroniczny save() do listings.yml

ID Nexo/Oraxen ustawia MarketManager.sellItem przez CustomItemsHook.getNexoId / getOraxenId przed zdjęciem itemu z ręki.

Odtwarzanie itemu

Przy zakupie, usunięciu i wygaśnięciu item idzie przez CustomItemsHook.recreateItem(listing):

1. klon zapisanego ItemStack (enchanty, PDC, nazwa);
2. przebudowa z ID packa tylko gdy zapisany typ to AIR.

Wygasanie

Oferta wygasa, gdy now - timestamp > listing-expiry-days (domyślnie 7 dni). Timer w MarketPlace: co 30 minut. Zarezerwowana oferta (isListingReserved) jest pomijana.

Powiązane modele