Package com.planet_ink.coffee_mud.Libraries

Class CoffeeShops

java.lang.Object

com.planet_ink.coffee_mud.Libraries.StdLibrary

com.planet_ink.coffee_mud.Libraries.CoffeeShops

All Implemented Interfaces:

CMObject, Tickable, CMLibrary, ShoppingLibrary, java.lang.Cloneable, java.lang.Comparable<CMObject>

public class CoffeeShops
extends StdLibrary
implements ShoppingLibrary

Field Summary

Fields inherited from interface com.planet_ink.coffee_mud.core.interfaces.CMObject

idConverter

Fields inherited from class com.planet_ink.coffee_mud.Libraries.StdLibrary

isDebugging, name, serviceClient, tickStatus

Fields inherited from interface com.planet_ink.coffee_mud.core.interfaces.Tickable

STATUS_AFFECT, STATUS_ALIVE, STATUS_BEHAVIOR, STATUS_CLASS, STATUS_DEAD, STATUS_END, STATUS_FIGHT, STATUS_MISC, STATUS_MISC2, STATUS_MISC3, STATUS_MISC4, STATUS_MISC5, STATUS_MISC6, STATUS_MISC7, STATUS_NOT, STATUS_OTHER, STATUS_RACE, STATUS_REBIRTH, STATUS_SCRIPT, STATUS_START, STATUS_WEATHER, TICKID_AREA, TICKID_BALLISTICK, TICKID_CLAN, TICKID_CLANITEM, TICKID_DEADBODY_DECAY, TICKID_ELECTRONICS, TICKID_EMAIL, TICKID_EVENT, TICKID_EXIT_BEHAVIOR, TICKID_EXIT_REOPEN, TICKID_ITEM_BEHAVIOR, TICKID_ITEM_BOUNCEBACK, TICKID_LIGHT_FLICKERS, TICKID_LIVEAUCTION, TICKID_LONGERMASK, TICKID_MISCELLANEOUS, TICKID_MOB, TICKID_PROPERTY_SPECIAL, TICKID_QUEST, TICKID_READYTOSTOP, TICKID_ROOM_BEHAVIOR, TICKID_ROOM_ITEM_REJUV, TICKID_SHORTERMASK, TICKID_SOLITARYMASK, TICKID_SPECIALCOMBAT, TICKID_SPECIALMANEUVER, TICKID_SPELL_AFFECT, TICKID_SUPPORT, TICKID_TIMEAUCTION, TICKID_TRAP_DESTRUCTION, TICKID_TRAP_RESET

Constructor Summary

Constructors

Constructor	Description
CoffeeShops()

Method Summary

Modifier and Type	Method	Description
java.util.List<Environmental>	addRealEstateTitles(java.util.List<Environmental> productsV, MOB buyer, CoffeeShop shop, Room myRoom)	Adjusts the given inventory of a shopkeepers shop by adding external inventory, which might include new real estate titles, or existing titles to real estate, ships, and the like.
protected Pair<java.lang.Double,java.lang.String>[]	alternateParseItemPricingAdjustments(java.lang.String factors)
void	auctionNotify(MOB M, java.lang.String resp, java.lang.String regardingItem)	Sends a notification to the given stakeholder in an auction for the given item.
java.lang.String[]	bid(MOB mob, double bid, java.lang.String bidCurrency, AuctionData auctionData, Item I, java.util.List<java.lang.String> auctionAnnounces)	Submits a new bid for an item by the given mob, of the given amount of the given currency to the given auction for the given item.
void	cancelAuction(java.lang.String auctionHouse, AuctionData data)	Cancels the given auction.
boolean	doISellThis(Environmental thisThang, ShopKeeper shop)	Returns whether the given shopkeeper shop sells the given thing normally.
AuctionData	fetchAuctionByItemName(java.lang.String named, java.lang.String auctionHouse)	Returns auction data for the auction for an item of the given name in the given auction house.
java.lang.String	findInnRoom(InnKey key, java.lang.String addThis, Room R)	Given an inn key, and a starting room, this will return the directions to follow to reach the room.
java.util.List<Environmental>	getAllShopkeepers(Room here, MOB notMOB)	Returns all the shopkeeper hosts accessible by anyone in the given room.
java.lang.String	getAuctionInventory(MOB seller, MOB buyer, Auctioneer auction, java.lang.String itemName)	Returns the formal auction listing of all items for the given auctioneer's auction house.
java.util.Enumeration<AuctionData>	getAuctions(java.lang.Object ofLike, java.lang.String auctionHouse)	Returns an enumeration of all active auctions in the given auction house, of the given name
java.lang.String	getListForMask(java.lang.String targetMessage)	Checks a BUY message for an english embedded 'FOR' message, which can affect the assignment of purchased private property.
java.lang.String	getListInventory(MOB seller, MOB buyer, java.util.List<? extends Environmental> rawInventory, int limit, ShopKeeper shop, java.lang.String mask)	Formats and returns a displayable inventory for a shopkeeper.
protected double	getProductCount(Environmental product)
double	getSalesTax(Room homeRoom, MOB seller)	Returns the applicable sales tax percentage for the given seller from the given room.
protected java.lang.String	getSellableElectronicsName(MOB viewerM, Electronics E)
ShopKeeper	getShopKeeper(Environmental E)	Given a potential shopkeeper host, this will return the shopkeeper shop itself.
protected double	getStockSizeDevaluation(ShopKeeper shop, Environmental product, double number)
protected Ability	getTrainableAbility(MOB teacher, Ability A)
java.lang.String	getViewDescription(MOB viewerM, Environmental E, java.util.Set<ShopKeeper.ViewType> flags)	Returns the official view message for the given item and viewer mob.
java.lang.String	ID()	The CoffeeMud Java Class ID shared by all instances of this object.
boolean	ignoreIfNecessary(MOB mob, java.lang.String ignoreMask, MOB whoIgnores)	Returns whether the given ignorer (usually a shopkeeper mob) is ignoring the given mob for most purposes.
protected boolean	isLotTooLarge(ShopKeeper shop, Environmental product)
protected double	itemPriceFactor(Environmental product, Room R, java.lang.String[] priceFactors, boolean pawnTo)
Pair<java.lang.Long,TimeClock.TimePeriod>	parseBudget(java.lang.String budget)	Parses the given budget string into a data structure showing the amount of base currency, and how often that amount is reset for the purpose of making purchases.
MOB	parseBuyingFor(MOB buyer, java.lang.String message)	Given a BUY message string, will look for the FOR syntax and return the mob in the same room as the agent buyer with that name, or null.
double[]	parseDevalueRate(java.lang.String factors)	Parses a rate of devaluation for each purchase, preceded optionally by a special rate just for raw resources.
java.lang.String[]	parseItemPricingAdjustments(java.lang.String factors)	Parses the given list of factors into a set of factors.
protected java.lang.String[]	parsePrejudiceFactors(java.lang.String factors)
boolean	pawnEvaluation(MOB buyerShopM, MOB sellerCustM, Environmental product, ShopKeeper shop, double maxToPay, double maxEverPaid, boolean sellNotValue)	Evaluates a proposed sale of an item to a shopkeeper by a player/mob Returns whether the sale can go forth.
ShopKeeper.ShopPrice	pawningPrice(MOB buyerShopM, MOB sellerCustM, Environmental product, ShopKeeper shopKeeper, CoffeeShop shop)	Gives the value of an item that might be sold to a shopkeeper by a player/mob.
protected int	plus(int range, int hash)
protected int	plusOrMinus(int range, int hash, boolean lieBool)
protected double	prejudiceFactor(MOB customer, java.lang.String factors, boolean pawnTo)
protected double	prejudiceValueFromPart(MOB customer, boolean pawnTo, java.lang.String part)
void	purchaseAbility(Ability A, MOB seller, ShopKeeper shop, MOB mobFor)	Completes the purchase of the given ability from the given seller to the given buyer mob.
boolean	purchaseItems(Item baseProduct, java.util.List<Environmental> products, MOB seller, MOB mobFor)	Completes the purchase of the given item from the given seller to the given buyer mob.
boolean	purchaseMOB(MOB product, MOB seller, ShopKeeper shop, MOB mobFor)	Completes the purchase of the given follower mob from the given seller to the given buyer mob.
double	rawSpecificGoldPrice(Environmental product, CoffeeShop shop)
void	returnMoney(MOB to, java.lang.String currency, double amt)	A manipulator of the given players money.
void	saveAuction(AuctionData data, java.lang.String auctionHouse, boolean updateOnly)	Update the given AuctionData (an auction) for the given auctionHouse.
boolean	sellEvaluation(MOB sellerShopM, MOB buyerCustM, Environmental product, ShopKeeper shop, boolean buyNotView)	Evaluates a potential sale of an item from a shopkeeper to a player/npc.
ShopKeeper.ShopPrice	sellingPrice(MOB sellerShopM, MOB buyerCustM, Environmental product, ShopKeeper shopKeeper, CoffeeShop shop, boolean includeSalesTax)	Gives the price of an item that might be sold to a player/mob by a shopkeeper.
protected boolean	shopKeeperItemTypeCheck(Environmental E, int dealCode, ShopKeeper shopKeeper)
protected boolean	shownInInventory(MOB seller, MOB buyer, Environmental product, ShopKeeper shopKeeper)
java.lang.String	storeKeeperString(CoffeeShop shop, ShopKeeper keeper)	Returns a brief plain ordinary camel-cased description of what kind of shopkeeper this is: Miscellaneous Magic Items, General Items, etc.
void	transactMoneyOnly(MOB sellerM, MOB buyerM, ShopKeeper shop, Environmental product, boolean sellerGetsPaid)	Part of a shopkeeper selling an item to a player/mob is the transaction of the price.
double	transactPawn(MOB shopkeeper, MOB pawner, ShopKeeper shop, Environmental product)	Does the transaction where a player/mob sells an item to a shopkeeper.

Methods inherited from interface com.planet_ink.coffee_mud.Libraries.interfaces.CMLibrary

activate, getServiceClient, L, propertiesLoaded, shutdown

Methods inherited from interface com.planet_ink.coffee_mud.core.interfaces.CMObject

copyOf, initializeClass, name, newInstance

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from class com.planet_ink.coffee_mud.Libraries.StdLibrary

activate, checkDatabase, compareTo, copyOf, getServiceClient, getTickStatus, initializeClass, L, name, newInstance, propertiesLoaded, setThreadStatus, shutdown, tick

Constructor Detail

CoffeeShops

public CoffeeShops()

Method Detail

ID

public java.lang.String ID()

Description copied from interface: CMObject

The CoffeeMud Java Class ID shared by all instances of this object. Unlike the Java Class name, this method does not include package information. However, it must return a String value unique to its class category in the ClassLoader. Class categories include Libraries, Common, Areas, Abilities, Behaviors, CharClasses, Commands, Exits Locales, MOBS, Races, WebMacros, Basic Items, Armor, Weapons, ClanItems, Tech. The name is typically identical to the class name.

Specified by:

ID in interface CMObject

Overrides:

ID in class StdLibrary

Returns:

the name of this class

getShopKeeper

public ShopKeeper getShopKeeper(Environmental E)

Description copied from interface: ShoppingLibrary

Given a potential shopkeeper host, this will return the shopkeeper shop itself. Sometimes they are the same, sometimes not.

Specified by:

getShopKeeper in interface ShoppingLibrary

Parameters:

E - the potential shopkeeper host

Returns:

null, or the shopkeeper shop

getAllShopkeepers

public java.util.List<Environmental> getAllShopkeepers(Room here,
                                                       MOB notMOB)

Description copied from interface: ShoppingLibrary

Returns all the shopkeeper hosts accessible by anyone in the given room.

Specified by:

getAllShopkeepers in interface ShoppingLibrary

Parameters:

here - the room to find shopkeeper

notMOB - an exception, or null for no exceptions

Returns:

the list of all shopkeeper hosts

getSellableElectronicsName

protected java.lang.String getSellableElectronicsName(MOB viewerM,
                                                      Electronics E)

plusOrMinus

protected int plusOrMinus(int range,
                          int hash,
                          boolean lieBool)

plus

protected int plus(int range,
                   int hash)

getViewDescription

public java.lang.String getViewDescription(MOB viewerM,
                                           Environmental E,
                                           java.util.Set<ShopKeeper.ViewType> flags)

Description copied from interface: ShoppingLibrary

Returns the official view message for the given item and viewer mob.

Specified by:

getViewDescription in interface ShoppingLibrary

Parameters:

viewerM - the mob viewing the irem

E - the item being viewed

flags - the level of information returned

Returns:

the official 'view' of an item

See Also:

ShopKeeper.ViewType

getTrainableAbility

protected Ability getTrainableAbility(MOB teacher,
                                      Ability A)

shownInInventory

protected boolean shownInInventory(MOB seller,
                                   MOB buyer,
                                   Environmental product,
                                   ShopKeeper shopKeeper)

rawSpecificGoldPrice

public double rawSpecificGoldPrice(Environmental product,
                                   CoffeeShop shop)

prejudiceValueFromPart

protected double prejudiceValueFromPart(MOB customer,
                                        boolean pawnTo,
                                        java.lang.String part)

prejudiceFactor

protected double prejudiceFactor(MOB customer,
                                 java.lang.String factors,
                                 boolean pawnTo)

itemPriceFactor

protected double itemPriceFactor(Environmental product,
                                 Room R,
                                 java.lang.String[] priceFactors,
                                 boolean pawnTo)

sellingPrice

public ShopKeeper.ShopPrice sellingPrice(MOB sellerShopM,
                                         MOB buyerCustM,
                                         Environmental product,
                                         ShopKeeper shopKeeper,
                                         CoffeeShop shop,
                                         boolean includeSalesTax)

Description copied from interface: ShoppingLibrary

Gives the price of an item that might be sold to a player/mob by a shopkeeper.

Specified by:

sellingPrice in interface ShoppingLibrary

Parameters:

sellerShopM - the shopkeeper mob

buyerCustM - the player buyer mob

product - the proposed produce to sell to the shop

shopKeeper - the shop itself

shop - the inventory object of the shop

includeSalesTax - true to include sales tax in the price, false otherwise

Returns:

the selling price that this shopkeeper will put on the item

See Also:

ShoppingLibrary.transactMoneyOnly(MOB, MOB, ShopKeeper, Environmental, boolean), ShoppingLibrary.sellEvaluation(MOB, MOB, Environmental, ShopKeeper, boolean), ShoppingLibrary.getSalesTax(Room, MOB)

parseItemPricingAdjustments

public java.lang.String[] parseItemPricingAdjustments(java.lang.String factors)

Description copied from interface: ShoppingLibrary

Parses the given list of factors into a set of factors. Each factor is a mask followed by a decimal percentage to adjust prices by.

Specified by:

parseItemPricingAdjustments in interface ShoppingLibrary

Parameters:

factors - the raw factors string

Returns:

the parsed list of factors

See Also:

ShoppingLibrary.parseDevalueRate(String), ShoppingLibrary.parseBudget(String)

parsePrejudiceFactors

protected java.lang.String[] parsePrejudiceFactors(java.lang.String factors)

alternateParseItemPricingAdjustments

protected Pair<java.lang.Double,java.lang.String>[] alternateParseItemPricingAdjustments(java.lang.String factors)

parseBudget

public Pair<java.lang.Long,TimeClock.TimePeriod> parseBudget(java.lang.String budget)

Description copied from interface: ShoppingLibrary

Parses the given budget string into a data structure showing the amount of base currency, and how often that amount is reset for the purpose of making purchases.

Specified by:

parseBudget in interface ShoppingLibrary

Parameters:

budget - the encoded budget string (amount time period)

Returns:

the parsed budget object

See Also:

ShoppingLibrary.parseDevalueRate(String), ShoppingLibrary.parseItemPricingAdjustments(String)

parseDevalueRate

public double[] parseDevalueRate(java.lang.String factors)

Description copied from interface: ShoppingLibrary

Parses a rate of devaluation for each purchase, preceded optionally by a special rate just for raw resources. Each numbe is a percentage like 30%.

Specified by:

parseDevalueRate in interface ShoppingLibrary

Parameters:

factors - the rate of devaluation(s)

Returns:

the raw material followed by normal devalue rate 0-1

See Also:

ShoppingLibrary.parseItemPricingAdjustments(String), ShoppingLibrary.parseBudget(String)

getStockSizeDevaluation

protected double getStockSizeDevaluation(ShopKeeper shop,
                                         Environmental product,
                                         double number)

isLotTooLarge

protected boolean isLotTooLarge(ShopKeeper shop,
                                Environmental product)

getProductCount

protected double getProductCount(Environmental product)

pawningPrice

public ShopKeeper.ShopPrice pawningPrice(MOB buyerShopM,
                                         MOB sellerCustM,
                                         Environmental product,
                                         ShopKeeper shopKeeper,
                                         CoffeeShop shop)

Description copied from interface: ShoppingLibrary

Gives the value of an item that might be sold to a shopkeeper by a player/mob. Takes current stock into account.

Specified by:

pawningPrice in interface ShoppingLibrary

Parameters:

buyerShopM - the shopkeeper mob

sellerCustM - the player seller mob

product - the proposed produce to sell to the shop

shopKeeper - the shop itself

shop - the inventory object of the shop

Returns:

the valuation that this shopkeeper will put on the item

See Also:

ShoppingLibrary.transactPawn(MOB, MOB, ShopKeeper, Environmental), ShoppingLibrary.pawnEvaluation(MOB, MOB, Environmental, ShopKeeper, double, double, boolean)

getSalesTax

public double getSalesTax(Room homeRoom,
                          MOB seller)

Description copied from interface: ShoppingLibrary

Returns the applicable sales tax percentage for the given seller from the given room.

Specified by:

getSalesTax in interface ShoppingLibrary

Parameters:

homeRoom - the room the shopkeeper is originally from

seller - the seller him or herself

Returns:

a value from 0-1.

See Also:

ShoppingLibrary.transactMoneyOnly(MOB, MOB, ShopKeeper, Environmental, boolean), ShoppingLibrary.sellEvaluation(MOB, MOB, Environmental, ShopKeeper, boolean), ShoppingLibrary.sellingPrice(MOB, MOB, Environmental, ShopKeeper, CoffeeShop, boolean)

pawnEvaluation

public boolean pawnEvaluation(MOB buyerShopM,
                              MOB sellerCustM,
                              Environmental product,
                              ShopKeeper shop,
                              double maxToPay,
                              double maxEverPaid,
                              boolean sellNotValue)

Description copied from interface: ShoppingLibrary

Evaluates a proposed sale of an item to a shopkeeper by a player/mob Returns whether the sale can go forth. This also handles proposed VALUE commands.

Specified by:

pawnEvaluation in interface ShoppingLibrary

Parameters:

buyerShopM - the shopkeeper mob

sellerCustM - the player seller mob

product - the proposed produce to sell to the shop

shop - the shop itself

maxToPay - money the shopkeeper has remaining

maxEverPaid - the overall budget of the shopkeeper

sellNotValue - true if a sale is proposed, and false for a valuation

Returns:

true if the sale should go through, false otherwise

See Also:

ShoppingLibrary.transactPawn(MOB, MOB, ShopKeeper, Environmental), ShoppingLibrary.pawningPrice(MOB, MOB, Environmental, ShopKeeper, CoffeeShop)

sellEvaluation

public boolean sellEvaluation(MOB sellerShopM,
                              MOB buyerCustM,
                              Environmental product,
                              ShopKeeper shop,
                              boolean buyNotView)

Description copied from interface: ShoppingLibrary

Evaluates a potential sale of an item from a shopkeeper to a player/npc. Returns whether the sale can go forth. This also handles proposed VIEW commands.

Specified by:

sellEvaluation in interface ShoppingLibrary

Parameters:

sellerShopM - the mob doing the selling

buyerCustM - the player or mob doing the buying

product - the product to potentiall sell to the buyer

shop - the actual shop

buyNotView - true if a buy is requested, false for a view

Returns:

true if the buy or view should go forward

See Also:

ShoppingLibrary.transactMoneyOnly(MOB, MOB, ShopKeeper, Environmental, boolean), ShoppingLibrary.getSalesTax(Room, MOB), ShoppingLibrary.sellingPrice(MOB, MOB, Environmental, ShopKeeper, CoffeeShop, boolean)

getListInventory

public java.lang.String getListInventory(MOB seller,
                                         MOB buyer,
                                         java.util.List<? extends Environmental> rawInventory,
                                         int limit,
                                         ShopKeeper shop,
                                         java.lang.String mask)

Description copied from interface: ShoppingLibrary

Formats and returns a displayable inventory for a shopkeeper.

Specified by:

getListInventory in interface ShoppingLibrary

Parameters:

seller - the seller mob who speaks

buyer - the buyer mob who is ... buying

rawInventory - the inventory of the seller to show

limit - 0, or maximum number of rows to display

shop - the ShopKeeper object

mask - null, or a name substring mask for items to show

Returns:

the formatted displayable inventory

See Also:

ShoppingLibrary.getListInventory(MOB, MOB, List, int, ShopKeeper, String), ShoppingLibrary.getListForMask(String)

findInnRoom

public java.lang.String findInnRoom(InnKey key,
                                    java.lang.String addThis,
                                    Room R)

Description copied from interface: ShoppingLibrary

Given an inn key, and a starting room, this will return the directions to follow to reach the room.

Specified by:

findInnRoom in interface ShoppingLibrary

Parameters:

key - the key to find the room for

addThis - a word to prefix the directions with

R - the room starting from

Returns:

the directions to the room

parseBuyingFor

public MOB parseBuyingFor(MOB buyer,
                          java.lang.String message)

Description copied from interface: ShoppingLibrary

Given a BUY message string, will look for the FOR syntax and return the mob in the same room as the agent buyer with that name, or null.

Specified by:

parseBuyingFor in interface ShoppingLibrary

Parameters:

buyer - the agent buyer in the room

message - the buy message string

Returns:

the mob in the room the item is really for

transactPawn

public double transactPawn(MOB shopkeeper,
                           MOB pawner,
                           ShopKeeper shop,
                           Environmental product)

Description copied from interface: ShoppingLibrary

Does the transaction where a player/mob sells an item to a shopkeeper. It returns the amount given to the player in absolute value. Adds the item to the shopkeepers inventory

Specified by:

transactPawn in interface ShoppingLibrary

Parameters:

shopkeeper - the shopkeeper mob being sold to

pawner - the player/mob selling an item

shop - the shopkeeper object

product - the product sold to the shopkeeper

Returns:

the value given to the player

See Also:

ShoppingLibrary.pawnEvaluation(MOB, MOB, Environmental, ShopKeeper, double, double, boolean), ShoppingLibrary.pawningPrice(MOB, MOB, Environmental, ShopKeeper, CoffeeShop)

transactMoneyOnly

public void transactMoneyOnly(MOB sellerM,
                              MOB buyerM,
                              ShopKeeper shop,
                              Environmental product,
                              boolean sellerGetsPaid)

Description copied from interface: ShoppingLibrary

Part of a shopkeeper selling an item to a player/mob is the transaction of the price. This handles that by taking away the buyers money, qp, xp, or whatever. The price comes from sellingPrice above. Having the money go into the shopkeepers pocket is optional.

Specified by:

transactMoneyOnly in interface ShoppingLibrary

Parameters:

sellerM - the seller mob who wants money

buyerM - the buyer mob who is losing money

shop - the shop itself

product - the product being sold, whose value constitutes the price

sellerGetsPaid - true to add the money to the shopkeepers

See Also:

ShoppingLibrary.sellEvaluation(MOB, MOB, Environmental, ShopKeeper, boolean), ShoppingLibrary.getSalesTax(Room, MOB), ShoppingLibrary.sellingPrice(MOB, MOB, Environmental, ShopKeeper, CoffeeShop, boolean)

purchaseItems

public boolean purchaseItems(Item baseProduct,
                             java.util.List<Environmental> products,
                             MOB seller,
                             MOB mobFor)

Description copied from interface: ShoppingLibrary

Completes the purchase of the given item from the given seller to the given buyer mob.

Specified by:

purchaseItems in interface ShoppingLibrary

Parameters:

baseProduct - the item being purchased

products - all items in the item product

seller - the seller

mobFor - the buyer

Returns:

true if the purchase went through, false otherwise

See Also:

ShoppingLibrary.purchaseAbility(Ability, MOB, ShopKeeper, MOB), ShoppingLibrary.purchaseMOB(MOB, MOB, ShopKeeper, MOB)

purchaseMOB

public boolean purchaseMOB(MOB product,
                           MOB seller,
                           ShopKeeper shop,
                           MOB mobFor)

Description copied from interface: ShoppingLibrary

Completes the purchase of the given follower mob from the given seller to the given buyer mob.

Specified by:

purchaseMOB in interface ShoppingLibrary

Parameters:

product - the follower mob being purchased

seller - the seller

shop - the seller's shop

mobFor - the buyer

Returns:

true if the purchase went through, false otherwise

See Also:

ShoppingLibrary.purchaseAbility(Ability, MOB, ShopKeeper, MOB), ShoppingLibrary.purchaseItems(Item, List, MOB, MOB)

purchaseAbility

public void purchaseAbility(Ability A,
                            MOB seller,
                            ShopKeeper shop,
                            MOB mobFor)

Description copied from interface: ShoppingLibrary

Completes the purchase of the given ability from the given seller to the given buyer mob.

Specified by:

purchaseAbility in interface ShoppingLibrary

Parameters:

A - the ability being purchased

seller - the seller

shop - the seller's shop

mobFor - the buyer

See Also:

ShoppingLibrary.purchaseMOB(MOB, MOB, ShopKeeper, MOB), ShoppingLibrary.purchaseItems(Item, List, MOB, MOB)

addRealEstateTitles

public java.util.List<Environmental> addRealEstateTitles(java.util.List<Environmental> productsV,
                                                         MOB buyer,
                                                         CoffeeShop shop,
                                                         Room myRoom)

Description copied from interface: ShoppingLibrary

Adjusts the given inventory of a shopkeepers shop by adding external inventory, which might include new real estate titles, or existing titles to real estate, ships, and the like.

Specified by:

addRealEstateTitles in interface ShoppingLibrary

Parameters:

productsV - the existing inventory

buyer - the buyer who wants to see the inventory

shop - the shop inventory object

myRoom - the room where the shopkeeper is

Returns:

the filled inventory

ignoreIfNecessary

public boolean ignoreIfNecessary(MOB mob,
                                 java.lang.String ignoreMask,
                                 MOB whoIgnores)

Description copied from interface: ShoppingLibrary

Returns whether the given ignorer (usually a shopkeeper mob) is ignoring the given mob for most purposes.

Specified by:

ignoreIfNecessary in interface ShoppingLibrary

Parameters:

mob - the mob who might be ignored

ignoreMask - the zappermask determining if the mob is ignored

whoIgnores - the mob who might be ignoring

Returns:

true if ignored, false othwrwise

storeKeeperString

public java.lang.String storeKeeperString(CoffeeShop shop,
                                          ShopKeeper keeper)

Description copied from interface: ShoppingLibrary

Returns a brief plain ordinary camel-cased description of what kind of shopkeeper this is: Miscellaneous Magic Items, General Items, etc.

Specified by:

storeKeeperString in interface ShoppingLibrary

Parameters:

shop - coffee shop inventory to check

keeper - the actual coffee shop

Returns:

the items sold description

shopKeeperItemTypeCheck

protected boolean shopKeeperItemTypeCheck(Environmental E,
                                          int dealCode,
                                          ShopKeeper shopKeeper)

doISellThis

public boolean doISellThis(Environmental thisThang,
                           ShopKeeper shop)

Description copied from interface: ShoppingLibrary

Returns whether the given shopkeeper shop sells the given thing normally. Does not care whether its in stock.

Specified by:

doISellThis in interface ShoppingLibrary

Parameters:

thisThang - the thing to see if its ordinary stock

shop - the actual shop to check for a good match

Returns:

true if the shop would sell it, false otherwise

returnMoney

public void returnMoney(MOB to,
                        java.lang.String currency,
                        double amt)

Description copied from interface: ShoppingLibrary

A manipulator of the given players money. Either adds or subtracts money as given, and then re-saves the players inventory to the database.

Specified by:

returnMoney in interface ShoppingLibrary

Parameters:

to - the mob who is getting or losing money

currency - the currency to add/remove

amt - the amount to add/remove

bid

public java.lang.String[] bid(MOB mob,
                              double bid,
                              java.lang.String bidCurrency,
                              AuctionData auctionData,
                              Item I,
                              java.util.List<java.lang.String> auctionAnnounces)

Description copied from interface: ShoppingLibrary

Submits a new bid for an item by the given mob, of the given amount of the given currency to the given auction for the given item. It also returns a message for any public auction channels to the given array. It turns a two- dimensional array.

Specified by:

bid in interface ShoppingLibrary

Parameters:

mob - the bidder mob

bid - the bidding amount in base value

bidCurrency - the bidding currency

auctionData - the auction data for the auction bid on

I - the item bid on (why not use from auction data?)

auctionAnnounces - list to put channel messages into

Returns:

2-dim array: message to bidder, message to prev high bidder

See Also:

AuctionData, ShoppingLibrary.auctionNotify(MOB, String, String), ShoppingLibrary.saveAuction(AuctionData, String, boolean), ShoppingLibrary.cancelAuction(String, AuctionData), ShoppingLibrary.fetchAuctionByItemName(String, String), ShoppingLibrary.getAuctions(Object, String), ShoppingLibrary.getAuctionInventory(MOB, MOB, Auctioneer, String)

fetchAuctionByItemName

public AuctionData fetchAuctionByItemName(java.lang.String named,
                                          java.lang.String auctionHouse)

Description copied from interface: ShoppingLibrary

Returns auction data for the auction for an item of the given name in the given auction house.

Specified by:

fetchAuctionByItemName in interface ShoppingLibrary

Parameters:

named - the item name, or partial match

auctionHouse - the auction house to search in

Returns:

null, or the auctio data

See Also:

AuctionData, ShoppingLibrary.auctionNotify(MOB, String, String), ShoppingLibrary.saveAuction(AuctionData, String, boolean), ShoppingLibrary.cancelAuction(String, AuctionData), ShoppingLibrary.getAuctions(Object, String), ShoppingLibrary.getAuctionInventory(MOB, MOB, Auctioneer, String), ShoppingLibrary.bid(MOB, double, String, AuctionData, Item, List)

saveAuction

public void saveAuction(AuctionData data,
                        java.lang.String auctionHouse,
                        boolean updateOnly)

Description copied from interface: ShoppingLibrary

Update the given AuctionData (an auction) for the given auctionHouse. Called usually when the auction is created, or max big is raised.

Specified by:

saveAuction in interface ShoppingLibrary

Parameters:

data - the AuctionData to update

auctionHouse - the auction house the data belongs to

updateOnly - true for update, false when creating

See Also:

AuctionData, ShoppingLibrary.auctionNotify(MOB, String, String), ShoppingLibrary.cancelAuction(String, AuctionData), ShoppingLibrary.fetchAuctionByItemName(String, String), ShoppingLibrary.getAuctions(Object, String), ShoppingLibrary.getAuctionInventory(MOB, MOB, Auctioneer, String), ShoppingLibrary.bid(MOB, double, String, AuctionData, Item, List)

getAuctions

public java.util.Enumeration<AuctionData> getAuctions(java.lang.Object ofLike,
                                                      java.lang.String auctionHouse)

Description copied from interface: ShoppingLibrary

Returns an enumeration of all active auctions in the given auction house, of the given name

Specified by:

getAuctions in interface ShoppingLibrary

Parameters:

ofLike - null, or a name to match

auctionHouse - the auction house to return auctions from

Returns:

an enumeration of all auctions

See Also:

AuctionData, ShoppingLibrary.auctionNotify(MOB, String, String), ShoppingLibrary.saveAuction(AuctionData, String, boolean), ShoppingLibrary.cancelAuction(String, AuctionData), ShoppingLibrary.fetchAuctionByItemName(String, String), ShoppingLibrary.getAuctionInventory(MOB, MOB, Auctioneer, String), ShoppingLibrary.bid(MOB, double, String, AuctionData, Item, List)

getListForMask

public java.lang.String getListForMask(java.lang.String targetMessage)

Description copied from interface: ShoppingLibrary

Checks a BUY message for an english embedded 'FOR' message, which can affect the assignment of purchased private property.

Specified by:

getListForMask in interface ShoppingLibrary

Parameters:

targetMessage - the target message string

Returns:

null, or a name that the object is being purchased for

See Also:

ShoppingLibrary.getListInventory(MOB, MOB, List, int, ShopKeeper, String), ShoppingLibrary.getListForMask(String)

getAuctionInventory

public java.lang.String getAuctionInventory(MOB seller,
                                            MOB buyer,
                                            Auctioneer auction,
                                            java.lang.String itemName)

Description copied from interface: ShoppingLibrary

Returns the formal auction listing of all items for the given auctioneer's auction house.

Specified by:

getAuctionInventory in interface ShoppingLibrary

Parameters:

seller - the seller mob, which is not necessarily the auction house

buyer - the buyer doing the listing

auction - the auction house object itself

itemName - the null or the name of the item interested in

Returns:

the displayable list of auctioned items

See Also:

AuctionData, ShoppingLibrary.auctionNotify(MOB, String, String), ShoppingLibrary.saveAuction(AuctionData, String, boolean), ShoppingLibrary.cancelAuction(String, AuctionData), ShoppingLibrary.fetchAuctionByItemName(String, String), ShoppingLibrary.getAuctions(Object, String), ShoppingLibrary.bid(MOB, double, String, AuctionData, Item, List)

auctionNotify

public void auctionNotify(MOB M,
                          java.lang.String resp,
                          java.lang.String regardingItem)

Description copied from interface: ShoppingLibrary

Sends a notification to the given stakeholder in an auction for the given item. It does a tell for online players, and an email for those not online.

Specified by:

auctionNotify in interface ShoppingLibrary

Parameters:

M - the recipient of the message

resp - the message

regardingItem - the item up for auction

See Also:

AuctionData, ShoppingLibrary.saveAuction(AuctionData, String, boolean), ShoppingLibrary.cancelAuction(String, AuctionData), ShoppingLibrary.fetchAuctionByItemName(String, String), ShoppingLibrary.getAuctions(Object, String), ShoppingLibrary.getAuctionInventory(MOB, MOB, Auctioneer, String), ShoppingLibrary.bid(MOB, double, String, AuctionData, Item, List), ShoppingLibrary.auctionNotify(MOB, String, String)

cancelAuction

public void cancelAuction(java.lang.String auctionHouse,
                          AuctionData data)

Description copied from interface: ShoppingLibrary

Cancels the given auction.

Specified by:

cancelAuction in interface ShoppingLibrary

Parameters:

auctionHouse - the auction house the data belongs to

data - the AuctionData to delete

See Also:

AuctionData, ShoppingLibrary.saveAuction(AuctionData, String, boolean), ShoppingLibrary.fetchAuctionByItemName(String, String), ShoppingLibrary.getAuctions(Object, String), ShoppingLibrary.getAuctionInventory(MOB, MOB, Auctioneer, String), ShoppingLibrary.bid(MOB, double, String, AuctionData, Item, List), ShoppingLibrary.auctionNotify(MOB, String, String)