Package com.planet_ink.coffee_mud.Items.Weapons

Class GenStaff

java.lang.Object

com.planet_ink.coffee_mud.Items.Basic.StdItem

com.planet_ink.coffee_mud.Items.Weapons.StdWeapon

com.planet_ink.coffee_mud.Items.Weapons.GenWeapon

com.planet_ink.coffee_mud.Items.Weapons.GenStaff

All Implemented Interfaces:

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

public class GenStaff
extends GenWeapon
implements Wand

Nested Class Summary

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

Wand.WandUsage

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 int	enchType
protected int	maxUses
protected java.lang.String	secretWord
protected java.lang.String	spellText

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

idConverter

Fields inherited from class com.planet_ink.coffee_mud.Items.Weapons.GenWeapon

GENWEAPONCODES, readableText

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 class com.planet_ink.coffee_mud.Items.Weapons.StdWeapon

ammoCapacity, lastReloadTime, ranges, useExtendedMissString, weaponClassification, weaponDamageType

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.Weapon

CLASS_AXE, CLASS_BLUNT, CLASS_DAGGER, CLASS_DESCS, CLASS_EDGED, CLASS_FLAILED, CLASS_HAMMER, CLASS_NATURAL, CLASS_POLEARM, CLASS_RANGED, CLASS_STAFF, CLASS_SWORD, CLASS_THROWN, MASK_MAXRANGEBITS, MASK_MAXRANGEFLAG, MASK_MAXRANGESHFT, MASK_MAXRANGEZERO, MASK_MINRANGEBITS, MASK_MINRANGEFLAG, MASK_MINRANGESHFT, MASK_MINRANGEZERO, MASK_MOAMMOBITS, MASK_MOAMMOFLAG, MASK_MOAMMOSHFT, MASK_MOAMMOZERO, MSG_TYPE_MAP, TYPE_BASHING, TYPE_BURNING, TYPE_BURSTING, TYPE_CORRUPTING, TYPE_DESCS, TYPE_DISRUPTING, TYPE_FROSTING, TYPE_GASSING, TYPE_LASERING, TYPE_MELTING, TYPE_MSG_MAP, TYPE_NATURAL, TYPE_PIERCING, TYPE_SCRAPING, TYPE_SHOOT, TYPE_SLASHING, TYPE_SONICING, TYPE_STRIKING, TYPE_STULTIFYING

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

Method Summary

Modifier and Type	Method	Description
boolean	checkWave(MOB mob, java.lang.String message)	Returns whether the given mob can use this wand.
void	executeMsg(Environmental myHost, CMMsg msg)	The general message event handler for the object.
int	getCharges()	Returns the number charges remaining
int	getEnchantType()	Returns the type of magic that can be enchanted onto this wand.
int	getMaxCharges()	Gets the max number of times this can be invoked before being drained and empty useless.
Ability	getSpell()	Sets the spell ability object that this wand can cast.
java.lang.String	getStat(java.lang.String code)	An alternative means of retreiving the values of those fields on this object which are modifiable at run-time by builders.
java.lang.String[]	getStatCodes()	Returns an array of the string names of those fields which are modifiable on this object at run-time by builders.
java.lang.String	ID()	The CoffeeMud Java Class ID shared by all instances of this object.
boolean	isGeneric()	Whether the fields of this item are set in code, or set by builders.
java.lang.String	magicWord()	Returns the magic word that invokes this wand
java.lang.String	readableText()	For things that are readable, this returns the readable string for this thing.
boolean	sameAs(Environmental E)	Whether this object instance is functionally identical to the object passed in.
java.lang.String	secretIdentity()	This method returns the calculated and expanded description of the properties of the item as would be discovered through the Identify spell.
void	setCharges(int newCharges)	Sets the number of charges remaining
void	setEnchantType(int enchType)	Sets the type of magic that can be enchanted onto this wand.
void	setMaxCharges(int num)	Sets the max number of times this wand can be invoked before being drained and empty useless stick.
void	setReadableText(java.lang.String text)	For things that are readable, this set the readable string for this thing.
void	setSpell(Ability theSpell)	Sets the spell ability object that this wand can cast.
void	setStat(java.lang.String code, java.lang.String val)	An alternative means of setting the values of those fields on this object which are modifiable at run-time by builders.
boolean	subjectToWearAndTear()	Whether the usesRemaining() number above is used to determine the percentage health of the item.
int	value()	The default value of the item, represented in the base CoffeeMud currency.
void	waveIfAble(MOB mob, Physical afftarget, java.lang.String message)	Checks to see if the mob can invoke this wand against the given target, given the message they just said out loud.

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, displayText, image, L, maxRange, minRange, miscTextFormat, Name, rawImage, 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.Weapons.GenWeapon

getGenWeaponCodeNum, getGenWeaponStat, setGenWeaponStat, setMiscText, text

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

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

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

getSaveStatIndex, isStat

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

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, genericName, 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, 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, displayText, eachBehavior, eachEffect, eachScript, effects, expirationDate, fetchBehavior, fetchBehavior, fetchEffect, fetchEffect, fetchScript, fitsOn, getSaveStatIndex, getTickStatus, I, image, initializeClass, isReadable, isSavable, isStat, L, material, miscTextFormat, name, name, Name, newInstance, numBehaviors, numberOfItems, numEffects, numScripts, owner, phyStats, rawImage, rawLogicalAnd, rawProperLocationBitmap, rawSecretIdentity, rawWornCode, recursiveWeight, removeFromOwnerContainer, riding, scripts, setBasePhyStats, setBaseValue, setContainer, setDatabaseID, setDescription, setDisplayText, setExpirationDate, setImage, setMaterial, setName, setOwner, setRawLogicalAnd, setRawProperLocationBitmap, setRawWornCode, setReadable, setRiding, setSavable, setSecretIdentity, stopTicking, tackOns, tick, ultimateContainer, unWear, usesRemaining, wearAt, wearEvenIfImpossible, wearIfPossible, wearIfPossible, whereCantWear

Methods inherited from class com.planet_ink.coffee_mud.Items.Weapons.StdWeapon

abilityImbuesMagic, affectPhyStats, ammunitionCapacity, ammunitionRemaining, ammunitionType, genericName, getRanges, hitString, inventoryAmmoCheck, isFreeStanding, maxRange, minRange, missString, okMessage, rawAmmunitionCapacity, recoverOwner, recoverPhyStats, requiresAmmunition, setAmmoCapacity, setAmmoRemaining, setAmmunitionType, setRanges, setUsesRemaining, setWeaponClassification, setWeaponDamageType, weaponClassification, weaponDamageType, weaponHealth

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

secretWord

protected java.lang.String secretWord

spellText

protected java.lang.String spellText

enchType

protected int enchType

maxUses

protected int maxUses

Constructor Detail

GenStaff

public GenStaff()

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 GenWeapon

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 StdWeapon

Returns:

whether this item has a valid condition

getCharges

public int getCharges()

Description copied from interface: Dischargeable

Returns the number charges remaining

Specified by:

getCharges in interface Dischargeable

Returns:

the number charges remaining

setCharges

public void setCharges(int newCharges)

Description copied from interface: Dischargeable

Sets the number of charges remaining

Specified by:

setCharges in interface Dischargeable

Parameters:

newCharges - the number of charges remaining

getMaxCharges

public int getMaxCharges()

Description copied from interface: Dischargeable

Gets the max number of times this can be invoked before being drained and empty useless.

Specified by:

getMaxCharges in interface Dischargeable

Returns:

the number of times this wand can be invoked

See Also:

Dischargeable.setMaxCharges(int)

setMaxCharges

public void setMaxCharges(int num)

Description copied from interface: Dischargeable

Sets the max number of times this wand can be invoked before being drained and empty useless stick.

Specified by:

setMaxCharges in interface Dischargeable

Parameters:

num - the number of times this can be invoked

See Also:

Dischargeable.getMaxCharges()

getEnchantType

public int getEnchantType()

Description copied from interface: Wand

Returns the type of magic that can be enchanted onto this wand.

Specified by:

getEnchantType in interface Wand

Returns:

the enchantment/magic type

See Also:

Ability.ACODE_SPELL

setEnchantType

public void setEnchantType(int enchType)

Description copied from interface: Wand

Sets the type of magic that can be enchanted onto this wand.

Specified by:

setEnchantType in interface Wand

Parameters:

enchType - the enchantment/magic type

See Also:

Ability.ACODE_CHANT

isGeneric

public boolean isGeneric()

Description copied from interface: Environmental

Whether the fields of this item are set in code, or set by builders. Generic means that they are set by builders, in which case XML is returned by the text() method containing all of the values for all the fields.

Specified by:

isGeneric in interface Environmental

Overrides:

isGeneric in class GenWeapon

Returns:

whether this item is modifiable by builders

See Also:

Environmental.text()

value

public int value()

Description copied from interface: Item

The default value of the item, represented in the base CoffeeMud currency. This method starts with baseGoldValue, which is a user-entered value, and adjusts according to magical enhancements and the condition of the item.

Specified by:

value in interface Item

Overrides:

value in class StdWeapon

Returns:

the adjusted value of the item in the base currency.

setSpell

public void setSpell(Ability theSpell)

Description copied from interface: Wand

Sets the spell ability object that this wand can cast.

Specified by:

setSpell in interface Wand

Parameters:

theSpell - the spell ability object that this wand can cast.

See Also:

Wand.getSpell()

getSpell

public Ability getSpell()

Description copied from interface: Wand

Sets the spell ability object that this wand can cast.

Specified by:

getSpell in interface Wand

Returns:

the spell ability object that this wand can cast.

See Also:

Wand.setSpell(Ability)

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 GenWeapon

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 GenWeapon

Parameters:

text - the readable text

See Also:

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

secretIdentity

public java.lang.String secretIdentity()

Description copied from interface: Item

This method returns the calculated and expanded description of the properties of the item as would be discovered through the Identify spell. It starts with its rawSecretIdentity() and adds to it any strings which the Ability objects contained in the Items effects list would generate. An empty string means the item has no secret properties per se.

Specified by:

secretIdentity in interface Item

Overrides:

secretIdentity in class StdWeapon

Returns:

a displayable string describing the secret properties of the item.

magicWord

public java.lang.String magicWord()

Description copied from interface: Wand

Returns the magic word that invokes this wand

Specified by:

magicWord in interface Wand

Returns:

the magic word that invokes this wand

waveIfAble

public void waveIfAble(MOB mob,
                       Physical afftarget,
                       java.lang.String message)

Description copied from interface: Wand

Checks to see if the mob can invoke this wand against the given target, given the message they just said out loud.

Specified by:

waveIfAble in interface Wand

Parameters:

mob - the invoker of the wand

afftarget - the target of the say message

message - the thing said by the wand invoker

checkWave

public boolean checkWave(MOB mob,
                         java.lang.String message)

Description copied from interface: Wand

Returns whether the given mob can use this wand. They must be holding it, and must say the magic word, etc.

Specified by:

checkWave in interface Wand

Parameters:

mob - the mob to check for waving ability

message - what the mob said prior to the check

Returns:

true if the wand can be invoked, false otherwise

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 StdWeapon

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

getStat

public java.lang.String getStat(java.lang.String code)

Description copied from interface: Modifiable

An alternative means of retreiving the values of those fields on this object which are modifiable at run-time by builders. See getStatCodes() for possible values for the code passed to this method. Values returned are always strings, even if the field itself is numeric or a list.

Specified by:

getStat in interface Modifiable

Overrides:

getStat in class GenWeapon

Parameters:

code - the name of the field to read.

Returns:

the value of the field read

See Also:

Modifiable.getStatCodes()

setStat

public void setStat(java.lang.String code,
                    java.lang.String val)

Description copied from interface: Modifiable

An alternative means of setting the values of those fields on this object which are modifiable at run-time by builders. See getStatCodes() for possible values for the code passed to this method. The value passed in is always a string, even if the field itself is numeric or a list.

Specified by:

setStat in interface Modifiable

Overrides:

setStat in class GenWeapon

Parameters:

code - the name of the field to set

val - the value to set the field to

See Also:

Modifiable.getStatCodes()

getStatCodes

public java.lang.String[] getStatCodes()

Description copied from interface: Modifiable

Returns an array of the string names of those fields which are modifiable on this object at run-time by builders.

Specified by:

getStatCodes in interface Modifiable

Overrides:

getStatCodes in class GenWeapon

Returns:

list of the fields which may be set.

See Also:

Modifiable.getStat(String), Modifiable.setStat(String, String)

sameAs

public boolean sameAs(Environmental E)

Description copied from interface: Environmental

Whether this object instance is functionally identical to the object passed in. Works by repeatedly calling getStat on both objects and comparing the values.

Specified by:

sameAs in interface Environmental

Overrides:

sameAs in class GenWeapon

Parameters:

E - the object to compare this one to

Returns:

whether this object is the same as the one passed in

See Also:

Modifiable.getStatCodes(), Modifiable.getStat(String)