Package com.planet_ink.coffee_mud.Items.Basic

Class GenPackagedItems

java.lang.Object

com.planet_ink.coffee_mud.Items.Basic.StdItem

com.planet_ink.coffee_mud.Items.Basic.GenItem

com.planet_ink.coffee_mud.Items.Basic.GenPackagedItems

All Implemented Interfaces:

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

Direct Known Subclasses:

GenPackagedStack

public class GenPackagedItems
extends GenItem
implements PackagedItems

Nested Class Summary

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 byte[]	readableText

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

idConverter

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

PACKAGE_FLAG_TO_ITEMS_PROGRAMMATICALLY

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
GenPackagedItems()

Method Summary

Modifier and Type	Method	Description
protected boolean	abilityImbuesMagic()
boolean	areAllItemsTheSame()	Returns whether this package contains identical items.
java.lang.String	displayText()	Gets the raw string used to show what this object looks like in the room.
java.lang.String	genericName()	Returns a generic name for this object, devoid of its particular identifying details.
int	getPackageFlagsBitmap()	Returns the flag bitmap describing how this item behaves.
java.lang.String	ID()	The CoffeeMud Java Class ID shared by all instances of this object.
boolean	isPackagable(java.util.List<Item> V)	Returns whether the given list of items can be held by this package.
java.lang.String	name()	The nice displayable name of this instance of this object
int	numberOfItemsInPackage()	Returns the total number of items in the package.
boolean	packageMe(Item I, int number)	Puts the given item into the package, and records the number of times it is repeated in the package.
java.lang.String	packageText()	Returns the contents of the package as an XML doc.
Item	peekFirstItem()	Returns the first item in the package, as a peek.
java.lang.String	readableText()	For things that are readable, this returns the readable string for this thing.
void	setNumberOfItemsInPackage(int number)	For packages that hold only one type of item, this is a quick method to alter the number in the package.
void	setPackageFlagsBitmap(int bitmap)	Sets the flag bitmap describing how this item behaves.
void	setPackageText(java.lang.String text)	Sets the contents of the package from an XML doc.
void	setReadableText(java.lang.String text)	For things that are readable, this set the readable string for this thing.
java.util.List<Item>	unPackage(int number)	Unpackages the top number of items in the package and returns them in an item list.

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

addEffect, addNonUninvokableEffect, basePhyStats, delAllEffects, delEffect, eachEffect, effects, fetchEffect, fetchEffect, numEffects, phyStats, recoverPhyStats, 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, destroy, 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, 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 class com.planet_ink.coffee_mud.Items.Basic.GenItem

getStat, getStatCodes, isGeneric, sameAs, setMiscText, setStat, text

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

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

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

getSaveStatIndex, getStat, getStatCodes, isStat, setStat

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

executeMsg, okMessage

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, displayText, name

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

isReadable, setReadable

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, affectPhyStats

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

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

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

getTickStatus, 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

readableText

protected byte[] readableText

Constructor Detail

GenPackagedItems

public GenPackagedItems()

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 GenItem

Returns:

the name of this class

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 StdItem

Returns:

the generic name of this thing

abilityImbuesMagic

protected boolean abilityImbuesMagic()

Overrides:

abilityImbuesMagic in class StdItem

name

public java.lang.String name()

Description copied from interface: Tickable

The nice displayable name of this instance of this object

Specified by:

name in interface CMObject

Specified by:

name in interface Tickable

Overrides:

name in class StdItem

Returns:

the displayable name of this object instance

See Also:

Environmental.Name()

displayText

public java.lang.String displayText()

Description copied from interface: Environmental

Gets the raw string used to show what this object looks like in the room. May be used as a basis for other methods, such as the title of rooms, and what an exit looks like when open. The value for Items may be null if the item is not displayed when the room is seen.

Specified by:

displayText in interface Environmental

Overrides:

displayText in class StdItem

Returns:

the string describing how this object looks in the room

numberOfItemsInPackage

public int numberOfItemsInPackage()

Description copied from interface: PackagedItems

Returns the total number of items in the package.

Specified by:

numberOfItemsInPackage in interface PackagedItems

Returns:

the total number of items in the package.

setNumberOfItemsInPackage

public void setNumberOfItemsInPackage(int number)

Description copied from interface: PackagedItems

For packages that hold only one type of item, this is a quick method to alter the number in the package. It is otherwise harmful.

Specified by:

setNumberOfItemsInPackage in interface PackagedItems

Parameters:

number - the new number of items in the package

readableText

public java.lang.String readableText()

Description copied from interface: Readable

For things that are readable, this returns the readable string for this thing. That is to say, what the player sees when they read the door.

Specified by:

readableText in interface Readable

Overrides:

readableText in class GenItem

Returns:

the readable string

See Also:

Readable.isReadable(), Readable.setReadable(boolean), Readable.setReadableText(String)

setReadableText

public void setReadableText(java.lang.String text)

Description copied from interface: Readable

For things that are readable, this set the readable string for this thing. That is to say, what the player sees when they read the door.

Specified by:

setReadableText in interface Readable

Overrides:

setReadableText in class GenItem

Parameters:

text - the readable text

See Also:

Readable.isReadable(), Readable.setReadable(boolean), Readable.readableText()

packageMe

public boolean packageMe(Item I,
                         int number)

Description copied from interface: PackagedItems

Puts the given item into the package, and records the number of times it is repeated in the package.

Specified by:

packageMe in interface PackagedItems

Parameters:

I - the item to put in the package

number - the number of times the item repeats

Returns:

true if the packaging went well, false otherwise

See Also:

PackagedItems.unPackage(int), PackagedItems.isPackagable(List)

isPackagable

public boolean isPackagable(java.util.List<Item> V)

Description copied from interface: PackagedItems

Returns whether the given list of items can be held by this package. Some require all items to be identical while others are more flexible. This method should be called before trying to package anything.

Specified by:

isPackagable in interface PackagedItems

Parameters:

V - the list of items to test

Returns:

true if the entire list can be packaged, and false otherwise

areAllItemsTheSame

public boolean areAllItemsTheSame()

Description copied from interface: PackagedItems

Returns whether this package contains identical items.

Specified by:

areAllItemsTheSame in interface PackagedItems

Returns:

true if this package contains identical items

peekFirstItem

public Item peekFirstItem()

Description copied from interface: PackagedItems

Returns the first item in the package, as a peek. It does not affect the contents of the package. The item should be destroyed after inspection.

Specified by:

peekFirstItem in interface PackagedItems

Returns:

the first item in the package, or null

unPackage

public java.util.List<Item> unPackage(int number)

Description copied from interface: PackagedItems

Unpackages the top number of items in the package and returns them in an item list. If this results in 0 items in the package, the package is destroyed!

Specified by:

unPackage in interface PackagedItems

Parameters:

number - the number of items to unpackage

Returns:

the list of items unpackaged

packageText

public java.lang.String packageText()

Description copied from interface: PackagedItems

Returns the contents of the package as an XML doc.

Specified by:

packageText in interface PackagedItems

Returns:

the contents of the package as an XML doc

See Also:

PackagedItems.setPackageText(String)

setPackageText

public void setPackageText(java.lang.String text)

Description copied from interface: PackagedItems

Sets the contents of the package from an XML doc.

Specified by:

setPackageText in interface PackagedItems

Parameters:

text - the contents of the package as an XML doc

See Also:

PackagedItems.packageText()

getPackageFlagsBitmap

public int getPackageFlagsBitmap()

Description copied from interface: PackagedItems

Returns the flag bitmap describing how this item behaves.

Specified by:

getPackageFlagsBitmap in interface PackagedItems

Returns:

the flag bitmap describing how this item behaves.

See Also:

PackagedItems.PACKAGE_FLAG_TO_ITEMS_PROGRAMMATICALLY, PackagedItems.setPackageFlagsBitmap(int)

setPackageFlagsBitmap

public void setPackageFlagsBitmap(int bitmap)

Description copied from interface: PackagedItems

Sets the flag bitmap describing how this item behaves.

Specified by:

setPackageFlagsBitmap in interface PackagedItems

Parameters:

bitmap - the flag bitmap describing how this item behaves.

See Also:

PackagedItems.PACKAGE_FLAG_TO_ITEMS_PROGRAMMATICALLY, PackagedItems.getPackageFlagsBitmap()