Package com.planet_ink.coffee_mud.Items.Basic

Class StdRideable

java.lang.Object

com.planet_ink.coffee_mud.Items.Basic.StdItem

com.planet_ink.coffee_mud.Items.Basic.StdContainer

com.planet_ink.coffee_mud.Items.Basic.StdRideable

All Implemented Interfaces:

Affectable, Behavable, CloseableLockable, CMObject, Contingent, DBIdentifiable, Environmental, Expireable, Modifiable, MsgListener, Physical, PhysicalAgent, Readable, Rideable, Rider, StatsAffecting, Tickable, Container, Item, Wearable, java.lang.Cloneable, java.lang.Comparable<CMObject>

Direct Known Subclasses:

Boat, Chair, GenRideable, HorseCart, StdCageRideable, StdComputerConsole, StdSiegeWeapon, StdTub

public class StdRideable
extends StdContainer
implements Rideable

Nested Class Summary

Nested classes/interfaces inherited from interface com.planet_ink.coffee_mud.core.interfaces.Rideable

Rideable.Basis

Nested classes/interfaces inherited from interface com.planet_ink.coffee_mud.Items.interfaces.Wearable

Wearable.CODES

Field Summary

Fields

Modifier and Type	Field	Description
protected java.lang.String	dismountString
protected java.lang.String	mountString
protected java.lang.String	putString
protected Rideable.Basis	rideBasis
protected int	riderCapacity
protected java.util.List<Rider>	riders
protected java.lang.String	rideString
protected java.lang.String	stateString
protected java.lang.String	stateSubjectStr

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

idConverter

Fields inherited from interface com.planet_ink.coffee_mud.Items.interfaces.Container

CONTAIN_ANYTHING, CONTAIN_BODIES, CONTAIN_CAGED, CONTAIN_CLOTHES, CONTAIN_COINS, CONTAIN_DAGGERS, CONTAIN_DESCS, CONTAIN_DRINKABLES, CONTAIN_EATABLES, CONTAIN_FOOTWEAR, CONTAIN_KEYS, CONTAIN_LIQUID, CONTAIN_ONEHANDWEAPONS, CONTAIN_OTHERWEAPONS, CONTAIN_RAWMATERIALS, CONTAIN_READABLES, CONTAIN_SCROLLS, CONTAIN_SHIELDS, CONTAIN_SMOKEABLES, CONTAIN_SSCOMPONENTS, CONTAIN_SWORDS

Fields inherited from class com.planet_ink.coffee_mud.Items.Basic.StdContainer

capacity, containType, defaultsClosed, defaultsLocked, hasALid, hasALock, isLocked, isOpen, openDelayTicks

Fields inherited from class com.planet_ink.coffee_mud.Items.Basic.StdItem

_name, affectPhyStats, affects, baseGoldValue, basePhyStats, behaviors, cachedImageName, CODES, databaseID, description, destroyed, displayText, dispossessionTime, material, me, miscText, myContainer, myUses, myWornCode, owner, phyStats, properWornBitmap, rawImageName, riding, scripts, secretIdentity, tickCtr, tickStatus, wornLogicalAnd, xtraValues

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

Fields inherited from interface com.planet_ink.coffee_mud.Items.interfaces.Wearable

DEFAULT_WORN_CODES, DEFAULT_WORN_DEPENDENCYGRID, DEFAULT_WORN_DESCS, DEFAULT_WORN_ORDER, DEFAULT_WORN_USUAL_NAMES, DEFAULT_WORN_WEIGHT_POINTS, DEFAULT_WORN_WEIGHTS, FILTER_ANY, FILTER_MOBINVONLY, FILTER_ROOMONLY, FILTER_UNWORNONLY, FILTER_WORNONLY, HIGHEST_WORN_CODE, IN_INVENTORY, WORN_ABOUT_BODY, WORN_ARMS, WORN_BACK, WORN_EARS, WORN_EYES, WORN_FEET, WORN_FLOATING_NEARBY, WORN_HANDS, WORN_HEAD, WORN_HELD, WORN_LEFT_FINGER, WORN_LEFT_WRIST, WORN_LEGS, WORN_MOUTH, WORN_NECK, WORN_RIGHT_FINGER, WORN_RIGHT_WRIST, WORN_TORSO, WORN_WAIST, WORN_WIELD

Constructor Summary

Constructors

Constructor	Description
StdRideable()

Method Summary

Modifier and Type	Method	Description
void	addRider(Rider mob)	Adds a new Rider to this Rideable.
void	affectPhyStats(Physical affected, PhyStats affectableStats)	This method is called by the recoverPhyStats() method on other Environmental objects.
boolean	amRiding(Rider mob)	Returns whether Rider is currently mounted on this Rideable
protected void	cloneFix(Item E)
void	delRider(Rider mob)	Removes a Rider from this Rideable.
void	destroy()	Utterly and permanently destroy this object, not only removing it from the map, but causing this object to be collected as garbage by Java.
java.lang.String	dismountString(Rider R)	Returns a string grammatically correct for the given rider when they are dismounting this Rideable
java.lang.String	displayText(MOB mob)	Returns the displayText, but as seen by the given viewer.
void	executeMsg(Environmental myHost, CMMsg msg)	The general message event handler for the object.
Rider	fetchRider(int which)	Returns a particular Rider mounted on this Rideable.
java.lang.String	genericName()	Returns a generic name for this object, devoid of its particular identifying details.
java.lang.String	getDismountString()	Returns a custom string grammatically correct for the given rider when they are dismounting this Rideable
java.lang.String	getMountString()	Returns a custom string grammatically correct for the given rider when they are mounting this Rideable
java.lang.String	getPutString()	Returns a custom string grammatically correct for the given rider when they are putting something on this Rideable
java.util.Set<MOB>	getRideBuddies(java.util.Set<MOB> list)	Adds all of the MOB Riders on this Rideable to the given Set and returns it
java.lang.String	getRideString()	Returns a custom verb string describing what one does when one rides this Rideable from room to room.
java.lang.String	getStateString()	Returns the custom string grammatically correct for the given rider when they are mounted on this Rideable
java.lang.String	getStateStringSubject()	Returns a custom string grammatically correct for this Rideable when Riders are mounted
java.lang.String	ID()	The CoffeeMud Java Class ID shared by all instances of this object.
boolean	isMobileRideBasis()	Whether the type of rideable is mobile.
boolean	mobileRideBasis()	Whether this Rideable moves when the Rider wants to move it.
java.lang.String	mountString(int commandType, Rider R)	Returns a string grammatically correct for the given rider when they are mounting this Rideable
int	numRiders()	Returns the number of riders currently mounted on this Rideable
boolean	okMessage(Environmental myHost, CMMsg msg)	The general message event previewer for the object.
java.lang.String	putString(Rider R)	Returns a string grammatically correct for the given rider when they are putting something on this Rideable
void	recoverPhyStats()	This method copies the basePhyStats() object into the phyStats() object, then makes repeated calls to all surrounding objects with affectPhyStats(Environmental,PhyStats) method.
Rideable.Basis	rideBasis()	The type of rideable object this is.
int	riderCapacity()	The number of Riders which may ride upon this Rideable
java.util.Enumeration<Rider>	riders()	Returns an iterator of the riders on this rideable
java.lang.String	rideString(Rider R)	Returns a verb string describing what one does when one rides this Rideable from room to room.
boolean	savable()
void	setDismountString(java.lang.String str)	Sets a string grammatically correct for the given rider when they are dismounting this Rideable
void	setMountString(java.lang.String str)	Setss a string grammatically correct for the given rider when they are mounting this Rideable
void	setPutString(java.lang.String str)	Set a string grammatically correct for the given rider when they are putting something on this Rideable
void	setRideBasis(Rideable.Basis basis)	Sets type of rideable object this is.
void	setRiderCapacity(int newCapacity)	Sets the number of Riders which may ride upon this Rideable
void	setRideString(java.lang.String str)	Sets a verb string describing what one does when one rides this Rideable from room to room.
void	setStateString(java.lang.String str)	Returns a string grammatically correct for the given rider when they are mounted on this Rideable
void	setStateStringSubject(java.lang.String str)	Sets a string grammatically correct for this Rideable when Riders are mounted
java.lang.String	stateString(Rider R)	Returns a string grammatically correct for the given rider when they are mounted on this Rideable
java.lang.String	stateStringSubject(Rider R)	Returns a string grammatically correct for this Rideable when Riders are mounted
boolean	subjectToWearAndTear()	Whether the usesRemaining() number above is used to determine the percentage health of the item.

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

addEffect, addNonUninvokableEffect, basePhyStats, delAllEffects, delEffect, eachEffect, effects, fetchEffect, fetchEffect, numEffects, phyStats, setBasePhyStats

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

addBehavior, addScript, behaviors, delAllBehaviors, delAllScripts, delBehavior, delScript, eachBehavior, eachScript, fetchBehavior, fetchBehavior, fetchScript, numBehaviors, numScripts, scripts

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

copyOf, initializeClass, newInstance

Methods inherited from interface java.lang.Comparable

compareTo

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

amDestroyed, isSavable, setSavable

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

canSaveDatabaseID, databaseID, setDatabaseID

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

description, displayText, image, isGeneric, L, maxRange, minRange, miscTextFormat, Name, rawImage, sameAs, setDescription, setDisplayText, setImage, setMiscText, setName, text

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

expirationDate, setExpirationDate

Methods inherited from interface com.planet_ink.coffee_mud.Items.interfaces.Item

baseGoldValue, container, material, owner, rawSecretIdentity, removeFromOwnerContainer, secretIdentity, setBaseValue, setContainer, setMaterial, setOwner, setSecretIdentity, setUsesRemaining, stopTicking, ultimateContainer, usesRemaining, value

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

getSaveStatIndex, getStat, getStatCodes, isStat, setStat

Methods inherited from class java.lang.Object

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

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

description, name

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

isReadable, readableText, setReadable, setReadableText

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

riding, setRiding

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

affectCharState, affectCharStats

Methods inherited from class com.planet_ink.coffee_mud.Items.Basic.StdContainer

canContain, capacity, containTypes, defaultsClosed, defaultsLocked, emptyPlease, getContents, getDeepContents, hasADoor, hasALock, hasContent, isInside, isLocked, isOpen, keyName, numberOfItems, openDelayTicks, recursiveWeight, setCapacity, setContainTypes, setDoorsNLocks, setKeyName, setMiscText, setOpenDelayTicks, tick

Methods inherited from class com.planet_ink.coffee_mud.Items.Basic.StdItem

abilityImbuesMagic, addBehavior, addEffect, addNonUninvokableEffect, addScript, affectCharState, affectCharStats, alreadyWornMsg, amBeingWornProperly, amDestroyed, amWearingAt, baseGoldValue, basePhyStats, behaviors, canSaveDatabaseID, canWear, canWearComplete, compareProperLocations, compareTo, container, copyOf, databaseID, delAllBehaviors, delAllEffects, delAllScripts, delBehavior, delEffect, delScript, description, description, displayText, eachBehavior, eachEffect, eachScript, effects, expirationDate, fetchBehavior, fetchBehavior, fetchEffect, fetchEffect, fetchScript, fitsOn, getSaveStatIndex, getStat, getStatCodes, getTickStatus, I, image, initializeClass, isGeneric, isReadable, isSavable, isStat, L, material, maxRange, minRange, miscTextFormat, name, name, Name, newInstance, numBehaviors, numEffects, numScripts, owner, phyStats, rawImage, rawLogicalAnd, rawProperLocationBitmap, rawSecretIdentity, rawWornCode, readableText, removeFromOwnerContainer, riding, sameAs, scripts, secretIdentity, setBasePhyStats, setBaseValue, setContainer, setDatabaseID, setDescription, setDisplayText, setExpirationDate, setImage, setMaterial, setName, setOwner, setRawLogicalAnd, setRawProperLocationBitmap, setRawWornCode, setReadable, setReadableText, setRiding, setSavable, setSecretIdentity, setStat, setUsesRemaining, stopTicking, tackOns, text, ultimateContainer, unWear, usesRemaining, value, wearAt, wearEvenIfImpossible, wearIfPossible, wearIfPossible, whereCantWear

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

getTickStatus, name, tick

Methods inherited from interface com.planet_ink.coffee_mud.Items.interfaces.Wearable

amBeingWornProperly, amWearingAt, canWear, compareProperLocations, fitsOn, rawLogicalAnd, rawProperLocationBitmap, rawWornCode, setRawLogicalAnd, setRawProperLocationBitmap, setRawWornCode, unWear, wearAt, wearEvenIfImpossible, wearIfPossible, wearIfPossible, whereCantWear

Field Detail

rideBasis

protected Rideable.Basis rideBasis

riderCapacity

protected int riderCapacity

riders

protected java.util.List<Rider> riders

putString

protected java.lang.String putString

rideString

protected java.lang.String rideString

stateString

protected java.lang.String stateString

stateSubjectStr

protected java.lang.String stateSubjectStr

mountString

protected java.lang.String mountString

dismountString

protected java.lang.String dismountString

Constructor Detail

StdRideable

public StdRideable()

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 StdContainer

Returns:

the name of this class

subjectToWearAndTear

public boolean subjectToWearAndTear()

Description copied from interface: Item

Whether the usesRemaining() number above is used to determine the percentage health of the item. If this method returns false, then health or condition is irrelevant to this Item. If true is returned, then usesRemaining is a number from 100 to 0, where 100 means perfect condition, and 0 means imminent disintegration.

Specified by:

subjectToWearAndTear in interface Item

Overrides:

subjectToWearAndTear in class StdItem

Returns:

whether this item has a valid condition

destroy

public void destroy()

Description copied from interface: Contingent

Utterly and permanently destroy this object, not only removing it from the map, but causing this object to be collected as garbage by Java. Containers, rooms. and mobs who have their destroy() method called will also call the destroy() methods on all items and other objects listed as content, recursively.

Specified by:

destroy in interface Contingent

Overrides:

destroy in class StdItem

savable

public boolean savable()

isMobileRideBasis

public boolean isMobileRideBasis()

Description copied from interface: Rideable

Whether the type of rideable is mobile.

Specified by:

isMobileRideBasis in interface Rideable

Returns:

Whether this type of rideable is mobile

See Also:

Rideable

rideBasis

public Rideable.Basis rideBasis()

Description copied from interface: Rideable

The type of rideable object this is.

Specified by:

rideBasis in interface Rideable

Returns:

the RIDEABLE_* constant describing how this is ridden

See Also:

Rideable

setRideBasis

public void setRideBasis(Rideable.Basis basis)

Description copied from interface: Rideable

Sets type of rideable object this is.

Specified by:

setRideBasis in interface Rideable

Parameters:

basis - the RIDEABLE_* constant describing how this is ridden

See Also:

Rideable

riderCapacity

public int riderCapacity()

Description copied from interface: Rideable

The number of Riders which may ride upon this Rideable

Specified by:

riderCapacity in interface Rideable

Returns:

the maximum riders

See Also:

Rider

setRiderCapacity

public void setRiderCapacity(int newCapacity)

Description copied from interface: Rideable

Sets the number of Riders which may ride upon this Rideable

Specified by:

setRiderCapacity in interface Rideable

Parameters:

newCapacity - the maximum riders

See Also:

Rider

numRiders

public int numRiders()

Description copied from interface: Rideable

Returns the number of riders currently mounted on this Rideable

Specified by:

numRiders in interface Rideable

Returns:

the number of current Riders

See Also:

Rider

fetchRider

public Rider fetchRider(int which)

Description copied from interface: Rideable

Returns a particular Rider mounted on this Rideable. May return null in the case of a race condition

Specified by:

fetchRider in interface Rideable

Parameters:

which - which rider to detch

Returns:

the rider riding

See Also:

Rider, Rideable, Rideable.numRiders()

addRider

public void addRider(Rider mob)

Description copied from interface: Rideable

Adds a new Rider to this Rideable. Is called by Rider.setRiding(Rideable) Should also call Rider.setRiding(Rideable) without recursion

Specified by:

addRider in interface Rideable

Parameters:

mob - Rider object, either an item or a mob

See Also:

Rider, Rideable

riders

public java.util.Enumeration<Rider> riders()

Description copied from interface: Rideable

Returns an iterator of the riders on this rideable

Specified by:

riders in interface Rideable

Returns:

the riders

See Also:

Rider

delRider

public void delRider(Rider mob)

Description copied from interface: Rideable

Removes a Rider from this Rideable. Is called by Rider.setRiding(null) Should also call Rider.setRiding(null) without recursion

Specified by:

delRider in interface Rideable

Parameters:

mob - Rider object, either an item or a mob

See Also:

Rider, Rideable

cloneFix

protected void cloneFix(Item E)

Overrides:

cloneFix in class StdItem

getRideBuddies

public java.util.Set<MOB> getRideBuddies(java.util.Set<MOB> list)

Description copied from interface: Rideable

Adds all of the MOB Riders on this Rideable to the given Set and returns it

Specified by:

getRideBuddies in interface Rideable

Parameters:

list - the hashset into which to add all the mob riders

Returns:

the same list passed in, filled

genericName

public java.lang.String genericName()

Description copied from interface: Physical

Returns a generic name for this object, devoid of its particular identifying details. e.g. for a mob, this would return the age-range and race of this mob, as if it were someone spotted on the street that you didn't know.

Specified by:

genericName in interface Physical

Overrides:

genericName in class StdContainer

Returns:

the generic name of this thing

mobileRideBasis

public boolean mobileRideBasis()

Description copied from interface: Rideable

Whether this Rideable moves when the Rider wants to move it. Largely derived from rideBasis().

Specified by:

mobileRideBasis in interface Rideable

Returns:

whether this item moves with the rider

See Also:

Rideable.rideBasis()

stateString

public java.lang.String stateString(Rider R)

Description copied from interface: Rideable

Returns a string grammatically correct for the given rider when they are mounted on this Rideable

Specified by:

stateString in interface Rideable

Parameters:

R - The rider object to make grammatically correct.

Returns:

a string describing the riders state of riding this Rideable

See Also:

Rider, Rideable.setStateString(String), Rideable.getStateString()

getStateString

public java.lang.String getStateString()

Description copied from interface: Rideable

Returns the custom string grammatically correct for the given rider when they are mounted on this Rideable

Specified by:

getStateString in interface Rideable

Returns:

a custom string describing the riders state of riding this Rideable

See Also:

Rider, Rideable.setStateString(String), Rideable.stateString(Rider)

setStateString

public void setStateString(java.lang.String str)

Description copied from interface: Rideable

Returns a string grammatically correct for the given rider when they are mounted on this Rideable

Specified by:

setStateString in interface Rideable

Parameters:

str - a string describing the riders state of riding this Rideable

See Also:

Rider, Rideable.stateString(Rider), Rideable.getStateString()

putString

public java.lang.String putString(Rider R)

Description copied from interface: Rideable

Returns a string grammatically correct for the given rider when they are putting something on this Rideable

Specified by:

putString in interface Rideable

Parameters:

R - The rider object to make grammatically correct.

Returns:

a string describing the riders state of putting something on this Rideable

See Also:

Rider, Rideable.setPutString(String), Rideable.getPutString()

getPutString

public java.lang.String getPutString()

Description copied from interface: Rideable

Returns a custom string grammatically correct for the given rider when they are putting something on this Rideable

Specified by:

getPutString in interface Rideable

Returns:

a custom string describing the riders state of putting something on this Rideable

See Also:

Rider, Rideable.setPutString(String), Rideable.putString(Rider)

setPutString

public void setPutString(java.lang.String str)

Description copied from interface: Rideable

Set a string grammatically correct for the given rider when they are putting something on this Rideable

Specified by:

setPutString in interface Rideable

Parameters:

str - a string describing the riders state of putting something on this Rideable

See Also:

Rider, Rideable.putString(Rider), Rideable.getPutString()

rideString

public java.lang.String rideString(Rider R)

Description copied from interface: Rideable

Returns a verb string describing what one does when one rides this Rideable from room to room.

Specified by:

rideString in interface Rideable

Parameters:

R - The rider object to make grammatically correct.

Returns:

a string describing the riders verb of riding this Rideable somewhere

See Also:

Rider, Rideable.setRideString(String), Rideable.getRideString()

getRideString

public java.lang.String getRideString()

Description copied from interface: Rideable

Returns a custom verb string describing what one does when one rides this Rideable from room to room.

Specified by:

getRideString in interface Rideable

Returns:

a custom string describing the riders verb of riding this Rideable somewhere

See Also:

Rider, Rideable.setRideString(String), Rideable.rideString(Rider)

setRideString

public void setRideString(java.lang.String str)

Description copied from interface: Rideable

Sets a verb string describing what one does when one rides this Rideable from room to room.

Specified by:

setRideString in interface Rideable

Parameters:

str - a string describing the riders verb of riding this Rideable somewhere

See Also:

Rider, Rideable.rideString(Rider), Rideable.getRideString()

getMountString

public java.lang.String getMountString()

Description copied from interface: Rideable

Returns a custom string grammatically correct for the given rider when they are mounting this Rideable

Specified by:

getMountString in interface Rideable

Returns:

a custom string describing the riders state of mounting this Rideable

See Also:

Rider, Rideable.setMountString(String), Rideable.mountString(int, Rider)

mountString

public java.lang.String mountString(int commandType,
                                    Rider R)

Description copied from interface: Rideable

Returns a string grammatically correct for the given rider when they are mounting this Rideable

Specified by:

mountString in interface Rideable

Parameters:

commandType - one of the RIDEABLE_ constants as a type

R - The rider object to make grammatically correct.

Returns:

a string describing the riders state of mounting this Rideable

See Also:

Rider, Rideable.setMountString(String), Rideable.getMountString()

setMountString

public void setMountString(java.lang.String str)

Description copied from interface: Rideable

Setss a string grammatically correct for the given rider when they are mounting this Rideable

Specified by:

setMountString in interface Rideable

Parameters:

str - a string describing the riders state of mounting this Rideable

See Also:

Rider, Rideable.mountString(int, Rider), Rideable.getDismountString()

dismountString

public java.lang.String dismountString(Rider R)

Description copied from interface: Rideable

Returns a string grammatically correct for the given rider when they are dismounting this Rideable

Specified by:

dismountString in interface Rideable

Parameters:

R - The rider object to make grammatically correct.

Returns:

a string describing the riders state of dismounting this Rideable

See Also:

Rider, Rideable.setDismountString(String), Rideable.getDismountString()

getDismountString

public java.lang.String getDismountString()

Description copied from interface: Rideable

Returns a custom string grammatically correct for the given rider when they are dismounting this Rideable

Specified by:

getDismountString in interface Rideable

Returns:

a custom string describing the riders state of dismounting this Rideable

See Also:

Rider, Rideable.setDismountString(String), Rideable.dismountString(Rider)

setDismountString

public void setDismountString(java.lang.String str)

Description copied from interface: Rideable

Sets a string grammatically correct for the given rider when they are dismounting this Rideable

Specified by:

setDismountString in interface Rideable

Parameters:

str - a string describing the riders state of dismounting this Rideable

See Also:

Rider, Rideable.dismountString(Rider), Rideable.getDismountString()

stateStringSubject

public java.lang.String stateStringSubject(Rider R)

Description copied from interface: Rideable

Returns a string grammatically correct for this Rideable when Riders are mounted

Specified by:

stateStringSubject in interface Rideable

Parameters:

R - The rider object to make grammatically correct.

Returns:

a string describing the Riderable state of being ridden

See Also:

Rider, Rideable.setStateStringSubject(String), Rideable.getStateStringSubject()

getStateStringSubject

public java.lang.String getStateStringSubject()

Description copied from interface: Rideable

Returns a custom string grammatically correct for this Rideable when Riders are mounted

Specified by:

getStateStringSubject in interface Rideable

Returns:

a custom string describing the Riderable state of being ridden

See Also:

Rider, Rideable.setStateStringSubject(String), Rideable.stateStringSubject(Rider)

setStateStringSubject

public void setStateStringSubject(java.lang.String str)

Description copied from interface: Rideable

Sets a string grammatically correct for this Rideable when Riders are mounted

Specified by:

setStateStringSubject in interface Rideable

Parameters:

str - a string describing the Riderable state of being ridden

See Also:

Rider, Rideable.stateStringSubject(Rider), Rideable.getStateStringSubject()

recoverPhyStats

public void recoverPhyStats()

Description copied from interface: Affectable

This method copies the basePhyStats() object into the phyStats() object, then makes repeated calls to all surrounding objects with affectPhyStats(Environmental,PhyStats) method. Surrounding objects include the room where the object is located, the Ability objects in the Effects list, the Behaviors in the behaviors list, and race/charclass/area if applicable. Those methods will then make all necessary adjustments to the values in the new phyStats() object. When it returns, phyStats() will have a totally updated object. This method must be called in code whenever the object is placed on the map, or when anything changes in its environment, such as location, effects, or other states.

Specified by:

recoverPhyStats in interface Affectable

Overrides:

recoverPhyStats in class StdItem

See Also:

Affectable.basePhyStats(), Affectable.phyStats(), Affectable.addEffect(Ability), Behavable.addBehavior(Behavior), PhyStats

affectPhyStats

public void affectPhyStats(Physical affected,
                           PhyStats affectableStats)

Description copied from interface: StatsAffecting

This method is called by the recoverPhyStats() method on other Environmental objects. It is used to transform the Environmental basePhyStats() object into a finished phyStats() object, both of which are objects implementing the PhyStats interface. See those methods for more information.

Specified by:

affectPhyStats in interface StatsAffecting

Overrides:

affectPhyStats in class StdItem

Parameters:

affected - the host of the PhyStats object being affected

affectableStats - the particular PhyStats object being affected

See Also:

PhyStats, Environmental, Affectable.basePhyStats(), Affectable.phyStats(), Affectable.recoverPhyStats()

displayText

public java.lang.String displayText(MOB mob)

Description copied from interface: Physical

Returns the displayText, but as seen by the given viewer. Can differ from displayText() without being saved to the DB. Display Texts are normally the way something appears in a room, or is the roomTitle of rooms.

Specified by:

displayText in interface Physical

Overrides:

displayText in class StdItem

Parameters:

mob - the mob viewing the physical thing

Returns:

the displayText as seen by the viewer

See Also:

Environmental.displayText()

amRiding

public boolean amRiding(Rider mob)

Description copied from interface: Rideable

Returns whether Rider is currently mounted on this Rideable

Specified by:

amRiding in interface Rideable

Parameters:

mob - the Rider to check this Rideable for

Returns:

true if the Rider is mounted on this Rideable

See Also:

Rider, Rideable

okMessage

public boolean okMessage(Environmental myHost,
                         CMMsg msg)

Description copied from interface: MsgListener

The general message event previewer for the object. Messages passed herein are in a pending state, and may be safely modified or rejected without fear that they might be in the middle of being executed. Messages passed herein may not necessarily be FOR or FROM this object, but will almost always represent events which want to happen in the same rom. This method should always always return true UNLESS this message needs to be canceled, in which case it is necessary to tell the mob initiating the event (CMMsg.source()) why it is being cancelled. Every game event goes through these methods.

Specified by:

okMessage in interface MsgListener

Overrides:

okMessage in class StdContainer

Parameters:

myHost - either the initiator of the event, or the host of this object

msg - the CMMsg that wants to be executed

Returns:

whether this message is allowed to execute

See Also:

CMMsg, CMMsg.source()

executeMsg

public void executeMsg(Environmental myHost,
                       CMMsg msg)

Description copied from interface: MsgListener

The general message event handler for the object. Messages passed herein may not necessarily be FOR this object, or from it, but will almost always represent events happening in the same room. The messages have already been through an approval process, so this method is called only to affect the final execution of the meaning of the message. Every game event goes through these methods.

Specified by:

executeMsg in interface MsgListener

Overrides:

executeMsg in class StdContainer

Parameters:

myHost - either the initiator of the event, or the host of this object

msg - the CMMsg that needs to be executed

See Also:

CMMsg