Venditori

Un venditore PNG vende merce in cambio di oro, come in ModernUO. Il giocatore apre la finestra del negozio di un venditore, vede cosa vende con il prezzo di un pezzo, sceglie cosa comprare e riceve la merce nello zaino. Ciò che ogni venditore vende è un negozio, convertito dalle classi SBInfo di ModernUO. Il giocatore può anche vendere al venditore, e gli scaffali si riempiono di nuovo con il tempo.

Aprire la finestra

Il giocatore apre la finestra in due modi, da dove il venditore è raggiungibile:

• Cliccare il venditore e scegliere Buy o Sell nel menu contestuale, entro 8 caselle.
• Dire vendor buy o vendor sell entro 4 caselle. Il client trasforma le parole in una parola chiave del parlato in qualsiasi lingua del client, quindi vendor buy funziona anche con un client italiano. Quando più venditori sentono le parole, risponde uno solo.

Un template che eredita basevendor esegue lo script, ma vendono solo quelli con un negozio: il menu di un venditore offre Buy solo quando il suo negozio vende qualcosa e Sell solo quando compra qualcosa, come in ModernUO, e un venditore senza negozio (un carpentiere navale, un allevatore, un maestro di gilda che non ne ha uno in templates/shops) non offre nessuno dei due e non risponde alle parole. Un venditore apre la finestra solo quando ha un negozio con merce disponibile, è nel mondo, dista al massimo 10 caselle, è in vista e il giocatore è vivo. Un assassino in un luogo sorvegliato viene rifiutato dalla voce del venditore (cliloc 501522).

Comprare

La finestra elenca la merce con i prezzi. Il giocatore sceglie un numero di pezzi per ogni riga e conferma. Un acquisto è tutto o niente tra le righe che lo script del venditore ha permesso (vedi Per chi scrive script): quando un controllo fallisce, non viene preso nulla e non viene dato nulla.

• Un acquisto ha da 1 a 100 righe. Una riga scelta due volte si somma. Ogni riga è una riga della finestra e la sua quantità è al massimo la scorta del venditore.
• Il totale è il prezzo di un pezzo per i pezzi di ogni riga; un totale oltre int.MaxValue viene rifiutato. Un game master non paga nulla.
• L’oro viene dallo zaino e dalle borse al suo interno. Quando lo zaino non basta e il totale è 2000 o più, la banca copre la differenza; sotto 2000 il venditore dice thou canst not afford (cliloc 500192) e la banca non viene toccata. La banca paga direttamente dalla sua cassetta, prima le monete e poi gli assegni, senza nessuno dei limiti di un prelievo (il suo massimo, il peso dello zaino, il posto per una nuova pila). Una banca che non può coprire la differenza riceve la risposta cliloc 500191. Il controllo viene prima della creazione di qualsiasi oggetto, quindi un acquisto rifiutato non costa nulla.
• Una riga impilabile dà una pila, ogni altra riga dà un oggetto per ogni pezzo. I serial per tutti sono riservati prima di prendere qualsiasi cosa; un ordine che ne richiede più di quelli pronti sul server viene rifiutato con il cliloc 500187.
• La merce va nello zaino. Quando non ci sta, viene messa a terra ai piedi del giocatore.
• Il giocatore legge il totale pagato: cliloc 1151639, oppure 1151638 quando una parte è uscita dalla banca.

La finestra si chiude dopo ogni risposta, acquisto o rifiuto. Una risposta che non è per la finestra aperta di quel venditore, o che ha più di 100 righe, viene scartata.

Vendere

Sell apre un elenco di ciò che il giocatore porta e che il negozio del venditore compra, con l’oro pagato per un pezzo. L’elenco contiene gli oggetti dello zaino e delle borse al suo interno, al massimo 250. Un oggetto indossato, tenuto sul cursore, non spostabile o un contenitore con qualcosa dentro non viene offerto. Un venditore che non compra nulla di ciò che il giocatore porta dice you have nothing I would be interested in.

Il prezzo di un pezzo è quello del negozio per gli oggetti comuni. Un oggetto più raro è pagato di più: il prezzo è moltiplicato per un numero che dipende dalla rarità dell’oggetto, arrotondato per difetto all’oro intero e mai sotto 1. I valori predefiniti sono 1,25 per uncommon, 1,5 per rare, 2 per epic e 3 per legendary, impostati in [ultima.vendors]. Vale per tutti i venditori e per ogni oggetto con una rarità, e l’elenco e il pagamento usano lo stesso numero.

Il giocatore sceglie gli oggetti e quanti pezzi di ciascuno, e conferma. Una vendita è tutto o niente tra le righe che lo script del venditore ha permesso, come un acquisto:

• La risposta ha meno di 100 righe. Ogni oggetto deve essere uno di quelli offerti e ancora nello zaino, e una riga scelta due volte si somma. Una quantità oltre quella dell’oggetto viene ridotta a essa. Il totale è rifiutato oltre int.MaxValue. Gli oggetti che non sono bottino normale, come gli oggetti iniziali di un nuovo personaggio, non vengono comprati.
• Il venditore deve essere raggiungibile e il giocatore vivo, e un assassino in un luogo sorvegliato viene rifiutato, come per un acquisto.
• L’oro è pagato in pile da 60000 nello zaino, o nella cassetta di banca quando lo zaino non ha posto per esse. Quando nessuno dei due ha posto, non si vende nulla e al giocatore viene detto che lo zaino è pieno.
• I pezzi vengono tolti dagli oggetti, e un oggetto venduto per intero viene eliminato. Il venditore li offre di nuovo, vedi Rivendita.

Scorta

Ogni venditore parte con la quantità di ogni riga del suo negozio. Un acquisto la riduce e la finestra successiva mostra ciò che resta. La scorta è tenuta solo in memoria: un riavvio restituisce a ogni venditore gli scaffali pieni, come in ModernUO.

Rifornimento

Un venditore si rifornisce quando un giocatore apre la sua finestra ed è passata più di un’ora dall’ultimo rifornimento; un venditore visto per la prima volta fa solo partire l’orologio. Ogni riga viene poi riempita fino al suo massimo, che cambia in base a come la riga si è venduta:

• Una riga esaurita ha il doppio del massimo, fino a 999.
• Una riga che ha venduto al massimo la metà del suo massimo lo vede ridotto alla metà, e 999 viene ridotto a 640. Un massimo di 20 o meno non viene mai ridotto.
• Una riga che ha venduto più della metà del suo massimo lo mantiene.

Rivendita

Ciò che un giocatore ha venduto a un venditore viene offerto di nuovo nella sua finestra, dopo la merce del negozio, a 1,9 volte il prezzo del negozio per un pezzo (arrotondato a oro intero). Un oggetto più raro, pagato di più, viene rivenduto dallo stesso prezzo del negozio e non da quello che ha fruttato. Il venditore lo tiene per un’ora dall’ultima volta che la stessa merce gli è stata venduta, oppure finché si esaurisce. La merce torna come nuovi oggetti dello stesso template e colore, mostrati con il nome del client per il grafico: ciò che l’oggetto aveva addosso, come un nome, delle cariche o una rarità, non viene conservato: una gemma prende la rarità che il template estrae per lei. Un venditore ricorda al massimo 250 tipi di merce. Come la scorta, lo scaffale della rivendita è tenuto solo in memoria.

Cosa riceve il client

La finestra è quella del client, guidata da questi pacchetti: 0x2E mette due contenitori virtuali sul venditore (i layer ShopBuy e ShopResale, di cui il client ha bisogno o va in crash), 0x3C riempie il primo con un oggetto virtuale per ogni riga, 0x74 dà il prezzo e il nome di ogni riga, e 0x24 apre la finestra con il gump 0x30. L’acquisto torna in 0x3B, e il server risponde con un 0x3B che chiude la finestra. I serial degli oggetti virtuali scendono da Serial.MaxVirtual e non significano nulla fuori dalla finestra aperta. L’elenco di vendita esce in 0x9E e la scelta del giocatore torna in 0x9F; i suoi oggetti sono del giocatore, con i loro serial reali. Vedi Pacchetti.

Per chi scrive script

I template dei venditori che ereditano basevendor eseguono scripts/mobiles/shopkeeper.lua, che offre Buy e Sell nel menu contestuale ai venditori per cui valgono vendor.sells(npc) e vendor.buys(npc), e ascolta vendor buy. Lo script si chiama shopkeeper perché vendor è il nome del modulo Lua che apre la finestra:

vendor.open_buy(npc, player)

Le altre funzioni del modulo vendor: vendor.open_sell(npc, player) offre l’elenco di ciò che il giocatore porta e il venditore compra; vendor.open_buy_once(npc, speaker) e vendor.open_sell_once(npc, speaker) servono per le parole dette dal giocatore: non fanno nulla quando un altro venditore ha aperto una finestra per quel giocatore nella mezza secondo precedente, così più venditori affiancati non rispondono tutti.

Lo script di un NPC venditore può anche prendere parte a una transazione, con quattro funzioni facoltative, tutte (serial, actor, item, amount, price), dove item è l’id template della merce e price l’oro dell’intera riga: can_buy e can_sell vengono interpellate per ogni riga, prima che si muova oro o merce, e false rifiuta quella riga; on_bought e on_sold vengono avvisate dopo che la riga è stata eseguita. Una riga rifiutata non spende nulla e non sposta nulla: il venditore dice I will not sell you that. o I do not want that. una volta sola, e le altre righe proseguono; quando non ne resta nessuna la finestra si chiude. Uno script che vuole parole sue le dice dall’hook. Le funzioni vengono interpellate per i soli venditori NPC, e solo quando lo script le definisce. Un game master non paga nulla, e il price di una riga è comunque quanto costerebbe. Le funzioni sono in Hook degli script.

can_buy e can_sell vengono interpellate mentre la finestra è aperta e prima della transazione: non devono aprire né chiudere una finestra di un venditore, spostare o consumare merce, né spostare il giocatore. Il server ricontrolla dopo: un acquisto la cui finestra è stata sostituita da un hook viene scartato, lasciando la nuova finestra, e una vendita la cui merce è cambiata o il cui giocatore è uscito dalla portata non paga nulla.

-- scripts/mobiles/fussy_baker.lua: a script of your own, the script_id of a baker's template
-- (the shipped shopkeeper.lua defines none of these four functions)
fussy_baker = {}

function fussy_baker.can_buy(serial, actor, item, amount, price)
    if item == "sword" and not npc.get_prop(serial, "knows_" .. actor) then
        return false
    end
end

Lo script di un venditore che ne ha uno proprio, come banker.lua o healer.lua, può chiamarla a sua volta: i guaritori tengono un negozio in questo modo, tramite scripts/common/shop.lua, che contiene le voci Buy e Sell e le parole per qualsiasi script. Vedi Moduli Lua.

Insegnare

I venditori insegnano anche le abilità che hanno: vedi Istruttori. I gioiellieri incidono anelli e fedi nuziali con un testo: vedi Anelli incisi.

Limiti

• Animali in vendita, ordini di lavorazione, il moltiplicatore dei prezzi delle città, venditori dei giocatori e l’oro che un venditore possiede non sono realizzati.
• I negozi forniti con il server contengono le righe di ModernUO che hanno un template oggetto. Il convertitore segnala le altre: qualche merce non ha ancora un template, quindi alcuni venditori vendono meno che in ModernUO.