StdAbility

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.planet_ink.coffee_mud.Abilities
Class StdAbility

java.lang.Object
  com.planet_ink.coffee_mud.Abilities.StdAbility

All Implemented Interfaces:: Ability, Behavable, CMModifiable, CMObject, Environmental, MsgListener, StatsAffecting, Tickable, java.lang.Cloneable, java.lang.Comparable<CMObject>

Direct Known Subclasses:: Addictions, Age, Allergies, Amputation, Antidote, ArchonSkill, BardSkill, Bleeding, Burning, Chant, CommonSkill, Dance, Disease, Disease_MummyRot, DiseaseCure, Dragonbreath, Druid_Bite, Druid_DruidicPass, Druid_GolemForm, Druid_KnowPlants, Druid_MyPlants, Druid_PackCall, Druid_PlantForm, Druid_RecoverVoice, Druid_Rend, Druid_ShapeShift, Falling, FighterSkill, GenAbility, Immunities, Injury, ItemRejuv, Mood, Paladin, Paladin_Breakup, Paladin_Defend, Paladin_HealingHands, Paladin_MountedCharge, Paladin_SummonMount, Paralysis, Play, Poison, Prayer, Pregnancy, Prisoner, Ranger_AnimalFrenzy, Ranger_Enemy1, Ranger_FindWater, Ranger_Hide, Ranger_Sneak, Ranger_Track, Ranger_TrackAnimal, Ranger_WoodlandCreep, Ranger_WoodlandLore, Regeneration, Sinking, Soiled, Song, SoundEcho, Specialization_Weapon, Spell, StdLanguage, StdSkill, StdTrap, SuperPower, TemporaryImmunity, ThiefSkill, Trap_Trap, Undead_ColdTouch, Undead_EnergyDrain, Undead_LifeDrain, Undead_WeakEnergyDrain, WeakParalysis, WingFlying

public class StdAbility
extends java.lang.Object
implements Ability
extends java.lang.Object
implements Ability

Field Summary
`protected Environmental`	`affected`
`protected boolean`	`amDestroyed`
`protected boolean`	`canBeUninvoked`
`static java.lang.String[]`	`empty`
`protected static EnvStats`	`envStats`
`protected short[]`	`expertise`
`protected MOB`	`invoker`
`protected boolean`	`isAnAutoEffect`
`protected long`	`lastCastHelp`
`java.lang.String`	`miscText`
`protected int`	`proficiency`
`protected boolean`	`savable`
`protected int`	`tickDown`
`protected boolean`	`unInvoked`

Fields inherited from interface com.planet_ink.coffee_mud.Abilities.interfaces.Ability
ACODE_CHANT, ACODE_COMMON_SKILL, ACODE_DESCS, ACODE_DISEASE, ACODE_LANGUAGE, ACODE_POISON, ACODE_PRAYER, ACODE_PROPERTY, ACODE_SKILL, ACODE_SONG, ACODE_SPELL, ACODE_SUPERPOWER, ACODE_THIEF_SKILL, ACODE_TRAP, ALL_ACODES, ALL_DOMAINS, CAN_AREAS, CAN_DESCS, CAN_EXITS, CAN_ITEMS, CAN_MOBS, CAN_ROOMS, DOMAIN_ABJURATION, DOMAIN_ACROBATIC, DOMAIN_ALERT, DOMAIN_ALTERATION, DOMAIN_ANATOMY, DOMAIN_ANIMALAFFINITY, DOMAIN_ARCANELORE, DOMAIN_ARCHON, DOMAIN_ARMORUSE, DOMAIN_ARTISTIC, DOMAIN_BINDING, DOMAIN_BLESSING, DOMAIN_BREEDING, DOMAIN_CALLIGRAPHY, DOMAIN_COMBATFLUIDITY, DOMAIN_COMBATLORE, DOMAIN_COMMUNING, DOMAIN_CONJURATION, DOMAIN_CORRUPTION, DOMAIN_CRAFTINGSKILL, DOMAIN_CREATION, DOMAIN_CRIMINAL, DOMAIN_CURSING, DOMAIN_DANCING, DOMAIN_DEATHLORE, DOMAIN_DECEPTIVE, DOMAIN_DEEPMAGIC, DOMAIN_DESCS, DOMAIN_DETRAP, DOMAIN_DIRTYFIGHTING, DOMAIN_DIVINATION, DOMAIN_ENCHANTMENT, DOMAIN_ENDURING, DOMAIN_EVANGELISM, DOMAIN_EVASIVE, DOMAIN_EVOCATION, DOMAIN_FITNESS, DOMAIN_FOOLISHNESS, DOMAIN_GATHERINGSKILL, DOMAIN_GRAPPLING, DOMAIN_HEALING, DOMAIN_HOLYPROTECTION, DOMAIN_ILLUSION, DOMAIN_INFLUENTIAL, DOMAIN_KICKING, DOMAIN_LEGAL, DOMAIN_MARTIALLORE, DOMAIN_MOONALTERING, DOMAIN_MOONSUMMONING, DOMAIN_NATURELORE, DOMAIN_NEUTRALIZATION, DOMAIN_PLANTCONTROL, DOMAIN_PLANTGROWTH, DOMAIN_PLAYING, DOMAIN_POISONING, DOMAIN_PRESERVING, DOMAIN_PUNCHING, DOMAIN_RACIALABILITY, DOMAIN_RESTORATION, DOMAIN_ROCKCONTROL, DOMAIN_SHAPE_SHIFTING, DOMAIN_SHIELDUSE, DOMAIN_SINGING, DOMAIN_STEALING, DOMAIN_STEALTHY, DOMAIN_STREETSMARTS, DOMAIN_TRANSMUTATION, DOMAIN_TRAPPING, DOMAIN_VERBS, DOMAIN_VEXING, DOMAIN_WARDING, DOMAIN_WEAPON_USE, DOMAIN_WEATHER_MASTERY, FLAG_AIRBASED, FLAG_BINDING, FLAG_CHARMING, FLAG_CLANMAGIC, FLAG_DESCS, FLAG_EARTHBASED, FLAG_FIREBASED, FLAG_HEALINGMAGIC, FLAG_HEATING, FLAG_HOLY, FLAG_INTOXICATING, FLAG_MOVING, FLAG_NOORDERING, FLAG_PARALYZING, FLAG_SUMMONING, FLAG_TRACKING, FLAG_TRANSPORTING, FLAG_UNHOLY, FLAG_WATERBASED, FLAG_WEATHERAFFECTING, QUALITY_BENEFICIAL_OTHERS, QUALITY_BENEFICIAL_SELF, QUALITY_DESCS, QUALITY_INDIFFERENT, QUALITY_MALICIOUS, QUALITY_OK_OTHERS, QUALITY_OK_SELF, RANGE_CHOICES, USAGE_DESCS, USAGE_HITPOINTS, USAGE_MANA, USAGE_MOVEMENT, USAGE_NADA, USAGEINDEX_HITPOINTS, USAGEINDEX_MANA, USAGEINDEX_MOVEMENT

Fields inherited from interface com.planet_ink.coffee_mud.Abilities.interfaces.Ability

ACODE_CHANT, ACODE_COMMON_SKILL, ACODE_DESCS, ACODE_DISEASE, ACODE_LANGUAGE, ACODE_POISON, ACODE_PRAYER, ACODE_PROPERTY, ACODE_SKILL, ACODE_SONG, ACODE_SPELL, ACODE_SUPERPOWER, ACODE_THIEF_SKILL, ACODE_TRAP, ALL_ACODES, ALL_DOMAINS, CAN_AREAS, CAN_DESCS, CAN_EXITS, CAN_ITEMS, CAN_MOBS, CAN_ROOMS, DOMAIN_ABJURATION, DOMAIN_ACROBATIC, DOMAIN_ALERT, DOMAIN_ALTERATION, DOMAIN_ANATOMY, DOMAIN_ANIMALAFFINITY, DOMAIN_ARCANELORE, DOMAIN_ARCHON, DOMAIN_ARMORUSE, DOMAIN_ARTISTIC, DOMAIN_BINDING, DOMAIN_BLESSING, DOMAIN_BREEDING, DOMAIN_CALLIGRAPHY, DOMAIN_COMBATFLUIDITY, DOMAIN_COMBATLORE, DOMAIN_COMMUNING, DOMAIN_CONJURATION, DOMAIN_CORRUPTION, DOMAIN_CRAFTINGSKILL, DOMAIN_CREATION, DOMAIN_CRIMINAL, DOMAIN_CURSING, DOMAIN_DANCING, DOMAIN_DEATHLORE, DOMAIN_DECEPTIVE, DOMAIN_DEEPMAGIC, DOMAIN_DESCS, DOMAIN_DETRAP, DOMAIN_DIRTYFIGHTING, DOMAIN_DIVINATION, DOMAIN_ENCHANTMENT, DOMAIN_ENDURING, DOMAIN_EVANGELISM, DOMAIN_EVASIVE, DOMAIN_EVOCATION, DOMAIN_FITNESS, DOMAIN_FOOLISHNESS, DOMAIN_GATHERINGSKILL, DOMAIN_GRAPPLING, DOMAIN_HEALING, DOMAIN_HOLYPROTECTION, DOMAIN_ILLUSION, DOMAIN_INFLUENTIAL, DOMAIN_KICKING, DOMAIN_LEGAL, DOMAIN_MARTIALLORE, DOMAIN_MOONALTERING, DOMAIN_MOONSUMMONING, DOMAIN_NATURELORE, DOMAIN_NEUTRALIZATION, DOMAIN_PLANTCONTROL, DOMAIN_PLANTGROWTH, DOMAIN_PLAYING, DOMAIN_POISONING, DOMAIN_PRESERVING, DOMAIN_PUNCHING, DOMAIN_RACIALABILITY, DOMAIN_RESTORATION, DOMAIN_ROCKCONTROL, DOMAIN_SHAPE_SHIFTING, DOMAIN_SHIELDUSE, DOMAIN_SINGING, DOMAIN_STEALING, DOMAIN_STEALTHY, DOMAIN_STREETSMARTS, DOMAIN_TRANSMUTATION, DOMAIN_TRAPPING, DOMAIN_VERBS, DOMAIN_VEXING, DOMAIN_WARDING, DOMAIN_WEAPON_USE, DOMAIN_WEATHER_MASTERY, FLAG_AIRBASED, FLAG_BINDING, FLAG_CHARMING, FLAG_CLANMAGIC, FLAG_DESCS, FLAG_EARTHBASED, FLAG_FIREBASED, FLAG_HEALINGMAGIC, FLAG_HEATING, FLAG_HOLY, FLAG_INTOXICATING, FLAG_MOVING, FLAG_NOORDERING, FLAG_PARALYZING, FLAG_SUMMONING, FLAG_TRACKING, FLAG_TRANSPORTING, FLAG_UNHOLY, FLAG_WATERBASED, FLAG_WEATHERAFFECTING, QUALITY_BENEFICIAL_OTHERS, QUALITY_BENEFICIAL_SELF, QUALITY_DESCS, QUALITY_INDIFFERENT, QUALITY_MALICIOUS, QUALITY_OK_OTHERS, QUALITY_OK_SELF, RANGE_CHOICES, USAGE_DESCS, USAGE_HITPOINTS, USAGE_MANA, USAGE_MOVEMENT, USAGE_NADA, USAGEINDEX_HITPOINTS, USAGEINDEX_MANA, USAGEINDEX_MOVEMENT

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_CLAN, TICKID_CLANITEM, TICKID_DEADBODY_DECAY, TICKID_EMAIL, TICKID_EXIT_BEHAVIOR, TICKID_EXIT_REOPEN, TICKID_ITEM_BEHAVIOR, TICKID_ITEM_BOUNCEBACK, TICKID_LIGHT_FLICKERS, TICKID_LIVEAUCTION, TICKID_LONGERMASK, TICKID_MOB, TICKID_QUEST, TICKID_READYTOSTOP, TICKID_ROOM_BEHAVIOR, TICKID_ROOM_ITEM_REJUV, TICKID_SPELL_AFFECT, TICKID_TIMEAUCTION, TICKID_TRAP_DESTRUCTION, TICKID_TRAP_RESET, TICKMASK_SOLITARY, TICKS_PER_RLMIN, TIME_MILIS_PER_MUDHOUR, TIME_TICK, TIME_TICK_DOUBLE

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_CLAN, TICKID_CLANITEM, TICKID_DEADBODY_DECAY, TICKID_EMAIL, TICKID_EXIT_BEHAVIOR, TICKID_EXIT_REOPEN, TICKID_ITEM_BEHAVIOR, TICKID_ITEM_BOUNCEBACK, TICKID_LIGHT_FLICKERS, TICKID_LIVEAUCTION, TICKID_LONGERMASK, TICKID_MOB, TICKID_QUEST, TICKID_READYTOSTOP, TICKID_ROOM_BEHAVIOR, TICKID_ROOM_ITEM_REJUV, TICKID_SPELL_AFFECT, TICKID_TIMEAUCTION, TICKID_TRAP_DESTRUCTION, TICKID_TRAP_RESET, TICKMASK_SOLITARY, TICKS_PER_RLMIN, TIME_MILIS_PER_MUDHOUR, TIME_TICK, TIME_TICK_DOUBLE

Constructor Summary
`StdAbility()`

Method Summary
`int`	`abilityCode()` Returns an optional numeric value whose purpose is entirely contextual.
`protected boolean`	`ableOk(MOB mob, MOB target, CMMsg msg)`
`protected void`	`ableSend(MOB mob, MOB target, CMMsg msg)`
`int`	`abstractQuality()` Returns a constant value notifying the system of the general quality of the skill, whether it is malicious, beneficial, indifferent, or qualifiably beneficial (ok), as well as whether it is intended to target the invoker (self) or others.
`java.lang.String`	`accountForYourself()` For use by the identify spell, this should return a nice description of any properties incorporated by this effect.
`void`	`addBehavior(Behavior to)` Add a new behavior to this object.
`protected int`	`addedTickTime(MOB invokerMOB, int baseTickTime)`
`void`	`addEffect(Ability to)` Add a new effect to this object, whether permanent or temporary.
`void`	`addNonUninvokableEffect(Ability to)` Same as addEffect(Ability), but will set the Ability object as never being able to be uninvoked.
`void`	`addScript(ScriptingEngine S)` Add a new runnable script to this object.
`int`	`adjustedLevel(MOB caster, int asLevel)` This method calculates the strength level of this skill for the given mob, and taking into account the given override-level (asLevel).
`int`	`adjustedMaxInvokerRange(int max)`
`void`	`affectCharState(MOB affectedMob, CharState affectableMaxState)` This method is called by the recoverCharState() method on other MOB objects.
`void`	`affectCharStats(MOB affectedMob, CharStats affectableStats)` This method is called by the recoverCharStats() method on other MOB objects.
`void`	`affectEnvStats(Environmental affectedEnv, EnvStats affectableStats)` This method is called by the recoverEnvStats() method on other Environmental objects.
`Environmental`	`affecting()` Returns a reference to the room, item, mob, or exit that is currently being affected by this skill.
`boolean`	`amDestroyed()` Whether the destroy() method has been previousy called on this object.
`boolean`	`appropriateToMyFactions(MOB mob)` Returns whether there are any Faction reasons why the given mob should not use this skill.
`boolean`	`autoInvocation(MOB mob)` An autoinvocating ability is an ability which affects the mob just by having learned the ability.
`EnvStats`	`baseEnvStats()` Object containing a set of base, unmodified, mostly numeric fields.
`boolean`	`beneficialAffect(MOB mob, Environmental target, int asLevel, int tickAdjustmentFromStandard)`
`boolean`	`beneficialVisualFizzle(MOB mob, Environmental target, java.lang.String message)`
`boolean`	`beneficialWordsFizzle(MOB mob, Environmental target, java.lang.String message)`
`boolean`	`bubbleAffect()` This method is used to modify the behavior of the affectEnvStats, affectCharStats, and affectCharState methods.
`protected int[]`	`buildCostArray(MOB mob, int consumed, int minimum)`
`boolean`	`canAffect(Environmental E)` Returns whether, when used as a property/effect, this ability can affect the given object.
`boolean`	`canAffect(int can_code)` Returns whether, when used as a property/effect, this ability can affect the given type of object.
`protected int`	`canAffectCode()` Designates whether, when used as a property/effect, what sort of objects this ability can affect.
`boolean`	`canBeLearnedBy(MOB teacher, MOB student)` Returns whether the given student mob is able and allowed to learn this skill from the given teacher.
`boolean`	`canBePracticedBy(MOB teacher, MOB student)` Returns whether the given teacher mob is able and allowed to practice this skill with the given student and whether the student is able and allowed to practice this skill.
`boolean`	`canBeTaughtBy(MOB teacher, MOB student)` Returns whether the given teacher mob is able and allowed to teach this skill to the given student.
`boolean`	`canBeUninvoked()` Whether this skill is allowed to be uninvoked.
`boolean`	`canTarget(Environmental E)` Returns whether, when used as a skill, this ability can target itself at the given object.
`boolean`	`canTarget(int can_code)` Returns whether, when used as a skill, this ability can target itself at an object of the given type.
`protected int`	`canTargetCode()` Designates whether, when invoked as a skill, what sort of objects this ability can effectively target.
`int`	`castingQuality(MOB mob, Environmental target)` Serves a purpose similar to that of the Ability abstractQuality() method, but it determines a more exact quality based on a given invoker, target, and assumes an imminent use of the skill.
`protected int`	`castingQuality(MOB mob, Environmental target, int abstractQuality)`
`double`	`castingTime(MOB mob, java.util.Vector cmds)` Returns the number of actions required to completely activate this skill.
`boolean`	`checkComponents(MOB mob)`
`int`	`classificationCode()` Returns a bitmap describing the general classification of the skill (spell, skill, chant, or property, etc) and its domain.
`protected void`	`cloneFix(Ability E)`
`double`	`combatCastingTime(MOB mob, java.util.Vector cmds)` Returns the number of actions required to completely activate this skill.
`int`	`compareTo(CMObject o)`
`CMObject`	`copyOf()` Similar to Cloneable.clone(), but does its best to make sure that any internal objects to this class are also copyOfed.
`void`	`delBehavior(Behavior to)` Delete a behavior from this object.
`void`	`delEffect(Ability to)` Delete an effect from this object, whether permanent or temporary.
`void`	`delScript(ScriptingEngine S)` Remove a running script from this object.
`java.lang.String`	`description()` The basic description of this object, as shown when the item is directly LOOKed at.
`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`	`displayText()` Gets the raw string used to show what this object looks like in the room.
`protected boolean`	`disregardsArmorCheck(MOB mob)`
`int`	`enchantQuality()` Identical to abstractQuality() method, but returns a quality based on how the skill or spell behaves as a spell effect on a weapon or on armor.
`EnvStats`	`envStats()` Object containing a set of current, modified, usable, mostly numeric fields.
`void`	`executeMsg(Environmental myHost, CMMsg msg)` The general message event handler for the object.
`int`	`experienceLevels(MOB caster, int asLevel)`
`protected int`	`expertise(MOB mob, int code)`
`long`	`expirationDate()` If this object expires, it should have a timestamp saying when it expires, in real time.
`java.util.Vector`	`externalFiles()` Any external files which may be required to make this ability work files returned by this method should not be base distrib files!
`Behavior`	`fetchBehavior(int index)` Returns a behavior object on this object.
`Behavior`	`fetchBehavior(java.lang.String ID)` Returns a behavior object listed on this object.
`Ability`	`fetchEffect(int index)` Returns an ability object listed as an effect on this object.
`Ability`	`fetchEffect(java.lang.String ID)` Returns an ability object listed as an effect on this object.
`ScriptingEngine`	`fetchScript(int x)` Retreive one of the enumerated scripts running on this object
`protected void`	`finalize()`
`long`	`flags()` Returns a bitmap giving some specific information about the scope and purpose of the skill.
`Environmental`	`getAnyTarget(MOB mob, java.util.Vector commands, Environmental givenTarget, int wornReqCode)`
`Environmental`	`getAnyTarget(MOB mob, java.util.Vector commands, Environmental givenTarget, int wornReqCode, boolean checkOthersInventory)`
`Environmental`	`getAnyTarget(MOB mob, java.util.Vector commands, Environmental givenTarget, int wornReqCode, boolean checkOthersInventory, boolean alreadyAffOk)`
`int`	`getBeneficialTickdownTime(MOB mob, Environmental target, int tickAdjustmentFromStandard, int asLevel)`
`protected int`	`getCodeNum(java.lang.String code)`
`int`	`getMaliciousTickdownTime(MOB mob, Environmental target, int tickAdjustmentFromStandard, int asLevel)`
`int`	`getSaveStatIndex()` Returns the index into the stat codes array where extra savable fields begins.
`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.
`Item`	`getTarget(MOB mob, Room location, Environmental givenTarget, Item container, java.util.Vector commands, int wornReqCode)`
`Item`	`getTarget(MOB mob, Room location, Environmental givenTarget, java.util.Vector commands, int wornReqCode)`
`MOB`	`getTarget(MOB mob, java.util.Vector commands, Environmental givenTarget)`
`MOB`	`getTarget(MOB mob, java.util.Vector commands, Environmental givenTarget, boolean quiet, boolean alreadyAffOk)`
`int`	`getTickDownRemaining()`
`long`	`getTickStatus()` A coded status for this object during the period where its tick method is being called.
`protected int`	`getX1Level(MOB mob)`
`protected int`	`getX2Level(MOB mob)`
`protected int`	`getX3Level(MOB mob)`
`protected int`	`getX4Level(MOB mob)`
`protected int`	`getX5Level(MOB mob)`
`protected int`	`getXLEVELLevel(MOB mob)`
`protected int`	`getXLOWCOSTLevel(MOB mob)`
`protected int`	`getXMAXRANGELevel(MOB mob)`
`protected int`	`getXPCOSTAdjustment(MOB mob, int xpLoss)`
`protected int`	`getXPCOSTLevel(MOB mob)`
`protected int`	`getXTIMELevel(MOB mob)`
`void`	`helpProficiency(MOB mob)` This method should, occassionally, add to the proficiency the given mob has in this skill.
`java.lang.String`	`ID()` The CoffeeMud Java Class ID shared by all instances of this object.
`java.lang.String`	`image()` Returns the fully qualified and determined name of the image file displayed for this object when MXP is used.
`protected int`	`iniPracticesRequired()`
`protected int`	`iniPracticesToPractice()`
`void`	`initializeClass()` Called ONCE after all objects are loaded, but before the map is read in during initialization.
`protected int`	`iniTrainsRequired()`
`boolean`	`invoke(MOB mob, Environmental target, boolean auto, int asLevel)` This method is called when a player or the system invokes this skill, casts this spell, etc.
`boolean`	`invoke(MOB mob, java.util.Vector commands, Environmental target, boolean auto, int asLevel)` This method is called when a player or the system invokes this skill, casts this spell, etc.
`MOB`	`invoker()` Always returns the mob that invoked or initiated the skill or effect.
`boolean`	`isAutoInvoked()` An autoinvocating ability is an ability which affects the mob just by having learned the ability.
`boolean`	`isGeneric()` Whether the fields of this item are set in code, or set by builders.
`boolean`	`isNowAnAutoEffect()` An autoinvocating ability is an ability which affects the mob just by having learned the ability.
`boolean`	`isStat(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.
`void`	`makeLongLasting()` If this ability has been added as as temporary effect, like sleep, or trip, or other typical spells, calling this method will make it so thatit will not do so on its own for a long long time.
`void`	`makeNonUninvokable()` Designates that this skill should never be uninvoked.
`boolean`	`maliciousAffect(MOB mob, Environmental target, int asLevel, int tickAdjustmentFromStandard, int additionAffectCheckCode)`
`boolean`	`maliciousFizzle(MOB mob, Environmental target, java.lang.String message)`
`int`	`maxRange()` the maximum range of this object, if applicable.
`protected long`	`minCastWaitTime()`
`int`	`minRange()` the minimum range of this object, if applicable.
`java.lang.String`	`miscTextFormat()` Unimplemented as of yet, but will hold a string telling the system what the proper format of any miscText data.
`java.lang.String`	`name()` The displayable name of this object.
`java.lang.String`	`Name()` The raw unmodified name of this object as stored in the database.
`CMObject`	`newInstance()` Returns a new instance of this class.
`int`	`numBehaviors()` The number of behaviors this object has.
`int`	`numEffects()` Returns the number of ability objects listed as effects on this object.
`int`	`numScripts()` Return the number of scripts running on this object
`boolean`	`okMessage(Environmental myHost, CMMsg msg)` The general message event previewer for the object.
`protected int`	`overrideMana()`
`protected static Item`	`possibleContainer(MOB mob, java.util.Vector commands, boolean withStuff, int wornReqCode)`
`void`	`practice(MOB teacher, MOB student)` Causes the student to practice this skill, presumably with the teacher mob.
`int`	`practicesRequired(MOB mob)` Returns practices required to learn this skill
`int`	`practicesToPractice(MOB mob)`
`boolean`	`preInvoke(MOB mob, java.util.Vector commands, Environmental givenTarget, boolean auto, int asLevel, int secondsElapsed, double actionsRemaining)` This method is only called when the mob invoking this skill does not have enough actions to complete it immediately.
`int`	`proficiency()` Returns a number from 0-100 representing the percent of proficiency the mob or player who has this instance in their Abilities list has in this skill.
`boolean`	`proficiencyCheck(MOB mob, int adjustment, boolean auto)` Returns whether the given mob passes their proficiency check in this skill at this time.
`java.util.HashSet`	`properTargets(MOB mob, Environmental givenTarget, boolean auto)`
`boolean`	`putInCommandlist()` Returns whether this skills triggerStrings should be places in the master list of commands, unlike properties or other hidden skills.
`java.lang.String`	`rawImage()` Returns the raw name of the image file to display for this object when MXP is used.
`void`	`recoverEnvStats()` This method copies the baseEnvStats() object into the envStats() object, then makes repeated calls to all surrounding objects with affectEnvStats(Environmental,EnvStats) method.
`java.lang.String`	`requirements()` Returns a string describing the requirements and qualifications that are required to learn this skill.
`boolean`	`sameAs(Environmental E)` Whether this object instance is functionally identical to the object passed in.
`boolean`	`savable()` Whether, if this object is in a room, whether it is appropriate to save this object to the database as a permanent feature of its container.
`void`	`setAbilityCode(int newCode)` Sets an optional numeric value whose purpose is entirely contextual.
`void`	`setAffectedOne(Environmental being)` Sets a reference to the room, item, mob, or exit that is currently being affected by this skill.
`void`	`setBaseEnvStats(EnvStats newBaseEnvStats)` Re-sets the object containing a set of base, unmodified, mostly numeric fields.
`void`	`setDescription(java.lang.String newDescription)` Sets the basic description of this object, as shown when the item is directly LOOKed at.
`void`	`setDisplayText(java.lang.String newDisplayText)` Sets the raw string used to show what this object looks like in the room.
`void`	`setExpirationDate(long time)` If this object expires, it should have a timestamp saying when it expires, in real time.
`void`	`setImage(java.lang.String newImage)` Sets the raw name of the image file to display for this object when MXP is used.
`void`	`setInvoker(MOB mob)` Sets or changes the mob that invoked or initated the skill or effect.
`void`	`setMiscText(java.lang.String newMiscText)` For objects which have false for their isGeneric method, this is used to set any internally coded strings to change the nature or behavior of the object.
`void`	`setName(java.lang.String newName)` Sets the raw unmodified name of this object as stored in the database.
`void`	`setProficiency(int newProficiency)` Sets a number from 0-100 representing the percent of proficiency the mob or player who has this instance in their Abilities list has in this skill.
`void`	`setSavable(boolean truefalse)` Returns whether this skill may be saved to the database, or whether it is strictly a run-time thing that should not be saved.
`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.
`void`	`setTickDownRemaining(int newTick)`
`protected int`	`somanticCastCode(MOB mob, Environmental target, boolean auto)`
`protected int`	`somanticCastMask(MOB mob, Environmental target, boolean auto)`
`void`	`spreadImmunity(MOB mob)`
`void`	`startTickDown(MOB invokerMOB, Environmental affected, int tickTime)` Adds this Ability object as an effect on the given affected target, and sets it to unInvoke after the given number of ticks.
`void`	`teach(MOB teacher, MOB student)` Teaches this skill to the student mob, presumably from the teacher mob.
`java.lang.String`	`text()` For objects which have false for their isGeneric method, this is used to set any internally coded strings to change the nature or behavior of the object.
`boolean`	`tick(Tickable ticking, int tickID)` this is the method which is called periodically by the threading engine.
`int`	`trainsRequired(MOB mob)` Returns trains required to learn this skill
`java.lang.String[]`	`triggerStrings()` A set of the command strings the user types to access this command when it is listed as a skill ability.
`void`	`unInvoke()` If this skill is uninvokable, this method will uninvoke it, remove it as an effect on the target, and shut it down.
`int[]`	`usageCost(MOB mob, boolean ignoreClassOverride)` Returns an integer array telling the system how much mana, movement, or hit points are required to invoke this skill.
`int`	`usageType()` Returns a bitmap made up of constants defined by Ability.USAGE_*.
`protected int`	`verbalCastCode(MOB mob, Environmental target, boolean auto)`
`protected int`	`verbalCastMask(MOB mob, Environmental target, boolean auto)`

Methods inherited from class java.lang.Object
`clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

empty

public static final java.lang.String[] empty

expertise

protected short[] expertise

isAnAutoEffect

protected boolean isAnAutoEffect

proficiency

protected int proficiency

savable

protected boolean savable

miscText

public java.lang.String miscText

invoker

protected MOB invoker

affected

protected Environmental affected

canBeUninvoked

protected boolean canBeUninvoked

unInvoked

protected boolean unInvoked

tickDown

protected int tickDown

lastCastHelp

protected long lastCastHelp

envStats

protected static final EnvStats envStats

amDestroyed

protected boolean amDestroyed

Constructor Detail

StdAbility

public StdAbility()

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, MiscTech. The name is typically identical to the class name.

Specified by:: ID in interface CMObject

Returns:: the name of this class

Name

public java.lang.String Name()

Description copied from interface: Environmental

The raw unmodified name of this object as stored in the database. This is the name set by builders and used as a basis for the name() method.

Specified by:: Name in interface Environmental

Returns:: the raw base name of this object on the map.
See Also:: Environmental.name()

name

public java.lang.String name()

Description copied from interface: Environmental

The displayable name of this object. May be modified by envStats() object. Is derived from the Name().

Specified by:: name in interface Environmental
Specified by:: name in interface Tickable

Returns:: the modified final name of this object on the map.
See Also:: Environmental.Name()

description

public java.lang.String description()

Description copied from interface: Environmental

The basic description of this object, as shown when the item is directly LOOKed at.

Specified by:: description in interface Environmental

Returns:: the basic detail description of this object

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

Returns:: the string describing how this object looks in the room

image

public java.lang.String image()

Description copied from interface: Environmental

Returns the fully qualified and determined name of the image file displayed for this object when MXP is used. If rawImage() is non-empty, it will return rawImage, and otherwise use the mxp default data file.

Specified by:: image in interface Environmental

Returns:: the name of the mxp image to display for this object.

rawImage

public java.lang.String rawImage()

Description copied from interface: Environmental

Returns the raw name of the image file to display for this object when MXP is used. This is the value set by the builder, and may be returned by image() if it is non-empty.

Specified by:: rawImage in interface Environmental

Returns:: the raw name of the mxp image file

setImage

public void setImage(java.lang.String newImage)

Description copied from interface: Environmental

Sets the raw name of the image file to display for this object when MXP is used. This is the value set by the builder, and may be returned by image() if it is non-empty.

Specified by:: setImage in interface Environmental

Parameters:: newImage - the raw name of the mxp image file

triggerStrings

public java.lang.String[] triggerStrings()

Description copied from interface: Ability

A set of the command strings the user types to access this command when it is listed as a skill ability.

Specified by:: triggerStrings in interface Ability

Returns:: an array of command invoking string words
See Also:: Ability.putInCommandlist()

maxRange

public int maxRange()

Description copied from interface: Environmental

the maximum range of this object, if applicable. Can refer to the size of a room, the range of a weapon, or the calculated range of a mob in combat.

Specified by:: maxRange in interface Environmental

Returns:: the maximum range

minRange

public int minRange()

Description copied from interface: Environmental

the minimum range of this object, if applicable. Can refer to the size of a room, the range of a weapon, or the calculated range of a mob in combat. Usually 0.

Specified by:: minRange in interface Environmental

Returns:: the minimum range

castingTime

public double castingTime(MOB mob,
                          java.util.Vector cmds)

Description copied from interface: Ability

Returns the number of actions required to completely activate this skill. A value of 0.0 means invoke instantly. This method only applies when the invoker is not in combat.

Specified by:: castingTime in interface Ability

Parameters:: mob - the potential caster; cmds - the potential command set
Returns:: the number of player free actions required to do this
See Also:: Ability.combatCastingTime(MOB, Vector)

combatCastingTime

public double combatCastingTime(MOB mob,
                                java.util.Vector cmds)

Description copied from interface: Ability

Returns the number of actions required to completely activate this skill. A value of 0.0 means invoke instantly. This method only applies when the invoker is in combat.

Specified by:: combatCastingTime in interface Ability

Parameters:: mob - the potential caster; cmds - the potential command set
Returns:: the number of player free actions required to do this
See Also:: Ability.castingTime(MOB, Vector)

putInCommandlist

public boolean putInCommandlist()

Description copied from interface: Ability

Returns whether this skills triggerStrings should be places in the master list of commands, unlike properties or other hidden skills.

Specified by:: putInCommandlist in interface Ability

Returns:: whether to add the triggerString to the commands list
See Also:: Ability.triggerStrings()

isAutoInvoked

public boolean isAutoInvoked()

Description copied from interface: Ability

An autoinvocating ability is an ability which affects the mob just by having learned the ability. Dodge is an example of this. This method returns whether this skill is classified as one of those kinds of abilities.

Specified by:: isAutoInvoked in interface Ability

Returns:: whether this is an autoinvoking skill

bubbleAffect

public boolean bubbleAffect()

Description copied from interface: Ability

This method is used to modify the behavior of the affectEnvStats, affectCharStats, and affectCharState methods. If this returns true, then those methods will be called only on the owner/mob of the item currently being affected by this skill. If false, those methods behave normally.

Specified by:: bubbleAffect in interface Ability

Returns:: whether this skill affects a mob owner of an item
See Also:: Item.owner()

iniTrainsRequired

protected int iniTrainsRequired()

iniPracticesRequired

protected int iniPracticesRequired()

trainsRequired

public int trainsRequired(MOB mob)

Description copied from interface: Ability

Returns trains required to learn this skill

Specified by:: trainsRequired in interface Ability

Returns:: number of trains to learn this skill
See Also:: Ability.practicesRequired(MOB)

practicesRequired

public int practicesRequired(MOB mob)

Description copied from interface: Ability

Returns practices required to learn this skill

Specified by:: practicesRequired in interface Ability

Returns:: number of practices to learn this skill
See Also:: Ability.trainsRequired(MOB)

practicesToPractice

public int practicesToPractice(MOB mob)

iniPracticesToPractice

protected int iniPracticesToPractice()

miscTextFormat

public java.lang.String miscTextFormat()

Description copied from interface: Environmental

Unimplemented as of yet, but will hold a string telling the system what the proper format of any miscText data. Will use the CMParms.MTFORMAT_* constants for definition.

Specified by:: miscTextFormat in interface Environmental

Returns:: the format expected for the miscText field
See Also:: CMParms, Environmental.text(), Environmental.setMiscText(String)

flags

public long flags()

Description copied from interface: Ability

Returns a bitmap giving some specific information about the scope and purpose of the skill. The bitmap is composed of FLAG_* constants from the Ability interface.

Specified by:: flags in interface Ability

Returns:: FLAG_* constant based bitmap
See Also:: Ability

usageType

public int usageType()

Description copied from interface: Ability

Returns a bitmap made up of constants defined by Ability.USAGE_*. It lets the system know which of the values in the usageCost(MOB,boolean) method are relevant. It determines whether this skill requires mana, movement, hit points, or some combination of the three.

Specified by:: usageType in interface Ability

Returns:: a bitmap defined by Ability.USAGE_*
See Also:: Ability

overrideMana

protected int overrideMana()

abstractQuality

public int abstractQuality()

Description copied from interface: Ability

Returns a constant value notifying the system of the general quality of the skill, whether it is malicious, beneficial, indifferent, or qualifiably beneficial (ok), as well as whether it is intended to target the invoker (self) or others. These constants are defined in the Ability interface and called QUALITY_*

Specified by:: abstractQuality in interface Ability

Returns:: Ability.QUALITY_* constant classification
See Also:: Ability

enchantQuality

public int enchantQuality()

Description copied from interface: Ability

Identical to abstractQuality() method, but returns a quality based on how the skill or spell behaves as a spell effect on a weapon or on armor. This helps decide whether this skill is appropriate in those roles. These constants are defined in the Ability interface and called QUALITY_*

Specified by:: enchantQuality in interface Ability

Returns:: Ability.QUALITY_* constant classification
See Also:: Ability.abstractQuality(), Ability

initializeClass

public void initializeClass()

Description copied from interface: CMObject

Called ONCE after all objects are loaded, but before the map is read in during initialization.

Specified by:: initializeClass in interface CMObject

castingQuality

protected int castingQuality(MOB mob,
                             Environmental target,
                             int abstractQuality)

castingQuality

public int castingQuality(MOB mob,
                          Environmental target)

Description copied from interface: Ability

Serves a purpose similar to that of the Ability abstractQuality() method, but it determines a more exact quality based on a given invoker, target, and assumes an imminent use of the skill. For this reason, the QUALITY_OK_* constants should be avoided in favor of the other Ability.QUALITY_* constants.

Specified by:: castingQuality in interface Ability

Parameters:: mob - the person to use the skill; target - the potential target -- may be invoker
Returns:: Ability.QUALITY_* constant classification
See Also:: Ability, Ability.abstractQuality()

expertise

protected int expertise(MOB mob,
                        int code)

getX1Level

protected int getX1Level(MOB mob)

getX2Level

protected int getX2Level(MOB mob)

getX3Level

protected int getX3Level(MOB mob)

getX4Level

protected int getX4Level(MOB mob)

getX5Level

protected int getX5Level(MOB mob)

getXLEVELLevel

protected int getXLEVELLevel(MOB mob)

getXLOWCOSTLevel

protected int getXLOWCOSTLevel(MOB mob)

getXMAXRANGELevel

protected int getXMAXRANGELevel(MOB mob)

getXTIMELevel

protected int getXTIMELevel(MOB mob)

getXPCOSTLevel

protected int getXPCOSTLevel(MOB mob)

getXPCOSTAdjustment

protected int getXPCOSTAdjustment(MOB mob,
                                  int xpLoss)

adjustedMaxInvokerRange

public int adjustedMaxInvokerRange(int max)

canAffectCode

protected int canAffectCode()

Designates whether, when used as a property/effect, what sort of objects this ability can affect. Uses the Ability.CAN_* constants.

Returns:: a mask showing the type of objects this ability can affect
See Also:: Ability

canTargetCode

protected int canTargetCode()

Designates whether, when invoked as a skill, what sort of objects this ability can effectively target. Uses the Ability.CAN_* constants.

Returns:: a mask showing the type of objects this ability can target
See Also:: Ability

finalize

protected void finalize()

Overrides:: finalize in class java.lang.Object

newInstance

public CMObject newInstance()

Description copied from interface: CMObject

Returns a new instance of this class.

Specified by:: newInstance in interface CMObject

Returns:: a new instance of this class

classificationCode

public int classificationCode()

Description copied from interface: Ability

Returns a bitmap describing the general classification of the skill (spell, skill, chant, or property, etc) and its domain. It is made up of the ACODE_* constants the Ability interface, and optionally the DOMAIN_* constants also defined in this interface.

Specified by:: classificationCode in interface Ability

Returns:: ACODE_* constant classification
See Also:: Ability

envStats

public EnvStats envStats()

Description copied from interface: Environmental

Object containing a set of current, modified, usable, mostly numeric fields. This object is based on the object from baseEnvStats() and then updated and modified by the recoverEnvStats() method. See the EnvStats interface for information on the fields herein.

Specified by:: envStats in interface Environmental

Returns:: the current set of state fields
See Also:: Environmental.baseEnvStats(), Environmental.recoverEnvStats(), EnvStats

baseEnvStats

public EnvStats baseEnvStats()

Description copied from interface: Environmental

Object containing a set of base, unmodified, mostly numeric fields. The values on the fields in this object will be as they were set by the builder. This object is used as a basis for the recoverEnvStats() method. See the EnvStats interface for information on the fields herein.

Specified by:: baseEnvStats in interface Environmental

Returns:: a set of state fields
See Also:: Environmental.envStats(), Environmental.recoverEnvStats(), EnvStats

expirationDate

public long expirationDate()

Description copied from interface: Environmental

If this object expires, it should have a timestamp saying when it expires, in real time. When it expires, a MSG_EXPIRE message will be sent to it.

Specified by:: expirationDate in interface Environmental

Returns:: the time stamp when this thing expires
See Also:: Environmental.setExpirationDate(long)

setExpirationDate

public void setExpirationDate(long time)

Description copied from interface: Environmental

If this object expires, it should have a timestamp saying when it expires, in real time. When it expires, a MSG_EXPIRE message will be sent to it.

Specified by:: setExpirationDate in interface Environmental

Parameters:: time - the time stamp when this thing expires
See Also:: Environmental.expirationDate()

isNowAnAutoEffect

public boolean isNowAnAutoEffect()

Description copied from interface: Ability

An autoinvocating ability is an ability which affects the mob just by having learned the ability. Dodge is an example of this. Returns whether this instance was added to a mobs affects for this reason.

Specified by:: isNowAnAutoEffect in interface Ability

Returns:: whether this skill is currently an autoinvoked effect

savable

public boolean savable()

Description copied from interface: Environmental

Whether, if this object is in a room, whether it is appropriate to save this object to the database as a permanent feature of its container. It always returns true except under unique circumstances.

Specified by:: savable in interface Environmental

Returns:: true, usually.

setSavable

public void setSavable(boolean truefalse)

Description copied from interface: Ability

Returns whether this skill may be saved to the database, or whether it is strictly a run-time thing that should not be saved.

Specified by:: setSavable in interface Ability

Parameters:: truefalse - whether this skill may be saved to the database

destroy

public void destroy()

Description copied from interface: Environmental

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 Environmental

amDestroyed

public boolean amDestroyed()

Description copied from interface: Environmental

Whether the destroy() method has been previousy called on this object.

Specified by:: amDestroyed in interface Environmental

Returns:: whether the object is destroy()ed.

setName

public void setName(java.lang.String newName)

Description copied from interface: Environmental

Sets the raw unmodified name of this object as stored in the database. This is the name set by builders and used as a basis for the name() method.

Specified by:: setName in interface Environmental

Parameters:: newName - the raw base name of this object on the map.
See Also:: Environmental.Name()

recoverEnvStats

public void recoverEnvStats()

Description copied from interface: Environmental

This method copies the baseEnvStats() object into the envStats() object, then makes repeated calls to all surrounding objects with affectEnvStats(Environmental,EnvStats) 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 envStats() object. When it returns, envStats() 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:: recoverEnvStats in interface Environmental

See Also:: Environmental.baseEnvStats(), Environmental.envStats(), Environmental.addEffect(Ability), Behavable.addBehavior(Behavior), EnvStats

setBaseEnvStats

public void setBaseEnvStats(EnvStats newBaseEnvStats)

Description copied from interface: Environmental

Re-sets the object containing a set of base, unmodified, mostly numeric fields. The values on the fields in this object will be as they were set by the builder. This object is used as a basis for the recoverEnvStats() method. See the EnvStats interface for information on the fields herein. This method is rarely called -- the fields therein are usually set using setter methods from the EnvStats interface on the object itself.

Specified by:: setBaseEnvStats in interface Environmental

Parameters:: newBaseEnvStats - a set of state fields
See Also:: Environmental.envStats(), Environmental.recoverEnvStats(), EnvStats

setDisplayText

public void setDisplayText(java.lang.String newDisplayText)

Description copied from interface: Environmental

Sets 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:: setDisplayText in interface Environmental

Parameters:: newDisplayText - the string describing how this object looks in the room

setDescription

public void setDescription(java.lang.String newDescription)

Description copied from interface: Environmental

Sets the basic description of this object, as shown when the item is directly LOOKed at.

Specified by:: setDescription in interface Environmental

Parameters:: newDescription - the basic detail description of this object

abilityCode

public int abilityCode()

Description copied from interface: Ability

Returns an optional numeric value whose purpose is entirely contextual. For many skills, this reflects some sort of enhancement. Default is 0.

Specified by:: abilityCode in interface Ability

Returns:: the current optional numeric value or enhancement

setAbilityCode

public void setAbilityCode(int newCode)

Description copied from interface: Ability

Sets an optional numeric value whose purpose is entirely contextual. For many skills, this reflects some sort of enhancement. Default is 0.

Specified by:: setAbilityCode in interface Ability

Parameters:: newCode - the optional numeric value or enhancement

externalFiles

public java.util.Vector externalFiles()

Description copied from interface: Ability

Any external files which may be required to make this ability work files returned by this method should not be base distrib files!

Specified by:: externalFiles in interface Ability

Returns:: a Vector of local path names

minCastWaitTime

protected long minCastWaitTime()

setMiscText

public void setMiscText(java.lang.String newMiscText)

Description copied from interface: Environmental

For objects which have false for their isGeneric method, this is used to set any internally coded strings to change the nature or behavior of the object. For objects which have true for their isGeneric method, this is used to set and parse the XML which will be used to fill out the fields in this object. Since Ability objects are never Generic, this will always be where parameters are read from an Ability instance.

Specified by:: setMiscText in interface Environmental

Parameters:: newMiscText - either an open internal text string, or XML

text

public java.lang.String text()

Description copied from interface: Environmental

Specified by:: text in interface Environmental

Returns:: either an open internal text string, or XML

proficiency

public int proficiency()

Description copied from interface: Ability

Returns a number from 0-100 representing the percent of proficiency the mob or player who has this instance in their Abilities list has in this skill. Is also used for other miscellaneous purposes by other non-skill Abilities, such as Drowning.

Specified by:: proficiency in interface Ability

Returns:: the proficiency from 0-100
See Also:: MOB.addAbility(Ability), Ability.setProficiency(int)

setProficiency

public void setProficiency(int newProficiency)

Description copied from interface: Ability

Sets a number from 0-100 representing the percent of proficiency the mob or player who has this instance in their Abilities list has in this skill. Is also used for other miscellaneous purposes by other non-skill Abilities, such as Drowning.

Specified by:: setProficiency in interface Ability

Parameters:: newProficiency - the proficiency from 0-100
See Also:: MOB.addAbility(Ability), Ability.proficiency()

addedTickTime

protected int addedTickTime(MOB invokerMOB,
                            int baseTickTime)

startTickDown

public void startTickDown(MOB invokerMOB,
                          Environmental affected,
                          int tickTime)

Description copied from interface: Ability

Adds this Ability object as an effect on the given affected target, and sets it to unInvoke after the given number of ticks. This method intelligently determines whether the target is already going to provide tick events to the Ability (like a mob) or whether the system should create a tick event for this ability (like on rooms or items).

Specified by:: startTickDown in interface Ability

Parameters:: invokerMOB - the invoker of the ability; affected - the object to be affected by this ability; tickTime - the number of ticks to keep the ability ticking.

disregardsArmorCheck

protected boolean disregardsArmorCheck(MOB mob)

adjustedLevel

public int adjustedLevel(MOB caster,
                         int asLevel)

Description copied from interface: Ability

This method calculates the strength level of this skill for the given mob, and taking into account the given override-level (asLevel). The level returned should be based on a minimum baseline level (usually the class level of the class that qualifies for this skill at the lowest level), and should take into account the number of levels the mob has over and above that in appropriate classes

Specified by:: adjustedLevel in interface Ability

Parameters:: caster - the mob to evaluate the skill level of; asLevel - if greater than 0, this method always returns it
Returns:: the level of power the given mob has in this skill.

experienceLevels

public int experienceLevels(MOB caster,
                            int asLevel)

canTarget

public boolean canTarget(int can_code)

Description copied from interface: Ability

Returns whether, when used as a skill, this ability can target itself at an object of the given type. This method derives its answer from the protected integer method canTargetCode(), and requires one of the Ability.CAN_* constants.

Specified by:: canTarget in interface Ability

Parameters:: can_code - a bitmap of one or more Ability.CAN_* constants
Returns:: whether the object type is a valid target
See Also:: canTargetCode()

canAffect

public boolean canAffect(int can_code)

Description copied from interface: Ability

Returns whether, when used as a property/effect, this ability can affect the given type of object. This method derives its answer from the protected integer method canAffectCode(), and requires one of the Ability.CAN_* constants.

Specified by:: canAffect in interface Ability

Parameters:: can_code - a bitmap of one or more Ability.CAN_* constants
Returns:: whether the object object type may have this as a property/effect
See Also:: Ability, canAffectCode()

canAffect

public boolean canAffect(Environmental E)

Description copied from interface: Ability

Returns whether, when used as a property/effect, this ability can affect the given object. This method derives its answer from the protected integer method canAffectCode()

Specified by:: canAffect in interface Ability

Parameters:: E - the potential object to have this as a property/effect
Returns:: whether E is a valid object to have this as a property/effect
See Also:: canAffectCode()

canTarget

public boolean canTarget(Environmental E)

Description copied from interface: Ability

Returns whether, when used as a skill, this ability can target itself at the given object. This method derives its answer from the protected integer method canTargetCode()

Specified by:: canTarget in interface Ability

Parameters:: E - the potential target of this skill
Returns:: whether E is a valid target
See Also:: canTargetCode()

getTarget

public MOB getTarget(MOB mob,
                     java.util.Vector commands,
                     Environmental givenTarget)

getTarget

public MOB getTarget(MOB mob,
                     java.util.Vector commands,
                     Environmental givenTarget,
                     boolean quiet,
                     boolean alreadyAffOk)

getAnyTarget

public Environmental getAnyTarget(MOB mob,
                                  java.util.Vector commands,
                                  Environmental givenTarget,
                                  int wornReqCode)

getAnyTarget

public Environmental getAnyTarget(MOB mob,
                                  java.util.Vector commands,
                                  Environmental givenTarget,
                                  int wornReqCode,
                                  boolean checkOthersInventory)

getAnyTarget

public Environmental getAnyTarget(MOB mob,
                                  java.util.Vector commands,
                                  Environmental givenTarget,
                                  int wornReqCode,
                                  boolean checkOthersInventory,
                                  boolean alreadyAffOk)

possibleContainer

protected static Item possibleContainer(MOB mob,
                                        java.util.Vector commands,
                                        boolean withStuff,
                                        int wornReqCode)

getTarget

public Item getTarget(MOB mob,
                      Room location,
                      Environmental givenTarget,
                      java.util.Vector commands,
                      int wornReqCode)

getTarget

public Item getTarget(MOB mob,
                      Room location,
                      Environmental givenTarget,
                      Item container,
                      java.util.Vector commands,
                      int wornReqCode)

compareTo

public int compareTo(CMObject o)

Specified by:: compareTo in interface java.lang.Comparable<CMObject>

cloneFix

protected void cloneFix(Ability E)

copyOf

public CMObject copyOf()

Description copied from interface: CMObject

Similar to Cloneable.clone(), but does its best to make sure that any internal objects to this class are also copyOfed.

Specified by:: copyOf in interface CMObject

Returns:: a clone of this object

proficiencyCheck

public boolean proficiencyCheck(MOB mob,
                                int adjustment,
                                boolean auto)

Description copied from interface: Ability

Returns whether the given mob passes their proficiency check in this skill at this time. Will accept a numeric adjustment, positive or negative, to their base proficiency. Will also accept an auto parameter, which forces this method to always return true.

Specified by:: proficiencyCheck in interface Ability

Parameters:: mob - the mob whose proficiency to check; adjustment - a positive or negative adjustment to the mobs base proficiency; auto - if true, this method returns true always
Returns:: whether the mob passes their proficiency check
See Also:: Ability.proficiency()

affecting

public Environmental affecting()

Description copied from interface: Ability

Returns a reference to the room, item, mob, or exit that is currently being affected by this skill. Does not apply to non-affecting skills like kick, but more to auto-invoking skills and spells that affect people like sleep.

Specified by:: affecting in interface Ability

Returns:: the room, mob, or item being affected
See Also:: Ability.setAffectedOne(Environmental)

setAffectedOne

public void setAffectedOne(Environmental being)

Description copied from interface: Ability

Sets a reference to the room, item, mob, or exit that is currently being affected by this skill. Does not apply to non-affecting skills like kick, but more to auto-invoking skills and spells that affect people like sleep, and especially to properties.

Specified by:: setAffectedOne in interface Ability

Parameters:: being - the room, mob, or item being affected
See Also:: Ability.affecting()

unInvoke

public void unInvoke()

Description copied from interface: Ability

If this skill is uninvokable, this method will uninvoke it, remove it as an effect on the target, and shut it down.

Specified by:: unInvoke in interface Ability

See Also:: Ability.canBeUninvoked()

canBeUninvoked

public boolean canBeUninvoked()

Description copied from interface: Ability

Whether this skill is allowed to be uninvoked. If it returns false, then it behaves as a permanent property of the object it is affecting. Not death, dispelling, or other negations will remove it.

Specified by:: canBeUninvoked in interface Ability

Returns:: whether this skill can be uninvoked.
See Also:: Ability.makeNonUninvokable()

affectEnvStats

public void affectEnvStats(Environmental affectedEnv,
                           EnvStats affectableStats)

Description copied from interface: StatsAffecting

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

Specified by:: affectEnvStats in interface StatsAffecting

Parameters:: affectedEnv - the host of the EnvStats object being affected; affectableStats - the particular EnvStats object being affected
See Also:: EnvStats, Environmental, Environmental.baseEnvStats(), Environmental.envStats(), Environmental.recoverEnvStats()

affectCharStats

public void affectCharStats(MOB affectedMob,
                            CharStats affectableStats)

Description copied from interface: StatsAffecting

This method is called by the recoverCharStats() method on other MOB objects. It is used to transform the MOB baseCharStats() object into a finished charStats() object, both of which are objects implementing the CharStats interface. See those methods for more information.

Specified by:: affectCharStats in interface StatsAffecting

Parameters:: affectedMob - the host of the CharStats object being affected; affectableStats - the particular CharStats object being affected
See Also:: CharStats, MOB, MOB.baseCharStats(), MOB.charStats(), MOB.recoverCharStats()

affectCharState

public void affectCharState(MOB affectedMob,
                            CharState affectableMaxState)

Description copied from interface: StatsAffecting

This method is called by the recoverCharState() method on other MOB objects. It is used to transform the MOB baseCharState() object into a finished charState() object, both of which are objects implementing the CharState interface. See those methods for more information.

Specified by:: affectCharState in interface StatsAffecting

Parameters:: affectedMob - the host of the CharState object being affected; affectableMaxState - the particular CharState object being affected
See Also:: CharState, MOB, MOB.baseState(), MOB.curState(), MOB.recoverMaxState()

invoker

public MOB invoker()

Description copied from interface: Ability

Always returns the mob that invoked or initiated the skill or effect.

Specified by:: invoker in interface Ability

Returns:: the invoker mob
See Also:: MOB, Ability.setInvoker(MOB)

setInvoker

public void setInvoker(MOB mob)

Description copied from interface: Ability

Sets or changes the mob that invoked or initated the skill or effect.

Specified by:: setInvoker in interface Ability

Parameters:: mob - the invoker mob
See Also:: MOB, Ability.invoker()

buildCostArray

protected int[] buildCostArray(MOB mob,
                               int consumed,
                               int minimum)

usageCost

public int[] usageCost(MOB mob,
                       boolean ignoreClassOverride)

Description copied from interface: Ability

Returns an integer array telling the system how much mana, movement, or hit points are required to invoke this skill. Use the Ability.USAGEINDEX_* constants to index the array. A value of 0-1000 is an absolute cost. A value of Integer.MAX_VALUE means to use all of the mana, movement, hit points. A value of Integer.MAXVALUE-100 and up represents a percentage of the cost. The values in this method MUST be accompanied by properly set usageType() bitmap.

Specified by:: usageCost in interface Ability

Parameters:: mob - the invoker of the skill; ignoreClassOverride - whether to ignore Class Overrides
Returns:: an array of costs, indexed by Ability.USAGEINDEX_*
See Also:: Ability.usageType(), Ability

helpProficiency

public void helpProficiency(MOB mob)

Description copied from interface: Ability

This method should, occassionally, add to the proficiency the given mob has in this skill. There are no guarentees about how often this method is called, but presumably it is called when the mob is doing something that exercises this skill in some way. How often proficiency is effected by this method is up to the method, but is typically time-based, and based on intelligence and other factors.

Specified by:: helpProficiency in interface Ability

Parameters:: mob - the mob whose proficiency in this skill to possibly advance
See Also:: Ability.proficiency()

preInvoke

public boolean preInvoke(MOB mob,
                         java.util.Vector commands,
                         Environmental givenTarget,
                         boolean auto,
                         int asLevel,
                         int secondsElapsed,
                         double actionsRemaining)

Description copied from interface: Ability

This method is only called when the mob invoking this skill does not have enough actions to complete it immediately. The method is called when the command is entered, and every second afterwards until the invoker has enough actions to complete it. At completion time, invoke is called.

Specified by:: preInvoke in interface Ability

Parameters:: mob - the player or mob invoking the skill; commands - the parameters entered for the skill (minus trigger word); givenTarget - null, unless being auto-invoked. Represents an override target.; auto - false if player enters command, true if system invokes the command; asLevel - -1, unless being auto-invoked, when it is the level to invoke it at.; secondsElapsed - 0 at first, and increments every second; actionsRemaining - number of free actions the player is defficient.
Returns:: whether the skill should be allowed to invoke. false cancels altogether.
See Also:: Ability.invoke(MOB, Vector, Environmental, boolean, int)

invoke

public boolean invoke(MOB mob,
                      Environmental target,
                      boolean auto,
                      int asLevel)

Description copied from interface: Ability

This method is called when a player or the system invokes this skill, casts this spell, etc. Calls the more complete invoke method without an empty command strings vector unless target is non-null, in which case the vector will contain the name of the target.

Specified by:: invoke in interface Ability

Parameters:: mob - the player or mob invoking the skill; target - null, unless being auto-invoked. Represents an override target.; auto - false if player enters command, true if system invokes the command; asLevel - -1, unless being auto-invoked, when it is the level to invoke it at.
Returns:: whether the skill successfully invoked.
See Also:: Ability.invoke(MOB, Vector, Environmental, boolean, int)

invoke

public boolean invoke(MOB mob,
                      java.util.Vector commands,
                      Environmental target,
                      boolean auto,
                      int asLevel)

Description copied from interface: Ability

Specified by:: invoke in interface Ability

Parameters:: mob - the player or mob invoking the skill; commands - the parameters entered for the skill (minus trigger word); target - null, unless being auto-invoked. Represents an override target.; auto - false if player enters command, true if system invokes the command; asLevel - -1, unless being auto-invoked, when it is the level to invoke it at.
Returns:: whether the skill successfully invoked.

checkComponents

public boolean checkComponents(MOB mob)

properTargets

public java.util.HashSet properTargets(MOB mob,
                                       Environmental givenTarget,
                                       boolean auto)

getMaliciousTickdownTime

public int getMaliciousTickdownTime(MOB mob,
                                    Environmental target,
                                    int tickAdjustmentFromStandard,
                                    int asLevel)

maliciousAffect

public boolean maliciousAffect(MOB mob,
                               Environmental target,
                               int asLevel,
                               int tickAdjustmentFromStandard,
                               int additionAffectCheckCode)

beneficialWordsFizzle

public boolean beneficialWordsFizzle(MOB mob,
                                     Environmental target,
                                     java.lang.String message)

beneficialVisualFizzle

public boolean beneficialVisualFizzle(MOB mob,
                                      Environmental target,
                                      java.lang.String message)

maliciousFizzle

public boolean maliciousFizzle(MOB mob,
                               Environmental target,
                               java.lang.String message)

getBeneficialTickdownTime

public int getBeneficialTickdownTime(MOB mob,
                                     Environmental target,
                                     int tickAdjustmentFromStandard,
                                     int asLevel)

beneficialAffect

public boolean beneficialAffect(MOB mob,
                                Environmental target,
                                int asLevel,
                                int tickAdjustmentFromStandard)

spreadImmunity

public void spreadImmunity(MOB mob)

autoInvocation

public boolean autoInvocation(MOB mob)

Description copied from interface: Ability

An autoinvocating ability is an ability which affects the mob just by having learned the ability. Dodge is an example of this. This method is called to initiate this, and is called whenever a mob gains this skill as a new Ability. This method will add the ability to the mob as an effect.

Specified by:: autoInvocation in interface Ability

Parameters:: mob - the player or npc mob who has this ability
Returns:: whether the ability autoinvoked correctly
See Also:: Ability.isAutoInvoked(), Ability.isNowAnAutoEffect()

makeNonUninvokable

public void makeNonUninvokable()

Description copied from interface: Ability

Designates that this skill should never be uninvoked. Designates that this skill is a permanent property of the object it is affecting. Is normally called by addNonUninvokableAffect

Specified by:: makeNonUninvokable in interface Ability

See Also:: Environmental.addNonUninvokableEffect(Ability), Ability.canBeUninvoked()

accountForYourself

public java.lang.String accountForYourself()

Description copied from interface: Ability

For use by the identify spell, this should return a nice description of any properties incorporated by this effect.

Specified by:: accountForYourself in interface Ability

Returns:: a description of properties incorporated

getTickDownRemaining

public int getTickDownRemaining()

setTickDownRemaining

public void setTickDownRemaining(int newTick)

getTickStatus

public long getTickStatus()

Description copied from interface: Tickable

A coded status for this object during the period where its tick method is being called. The statis is defined, at least in part, by constants in this interface STATUS_*. STATUS_NOT should be returned when the objects tick method is not currently in execution. It should never return STATUS_NOT when the objects tick method is in execution.

Specified by:: getTickStatus in interface Tickable

Returns:: the numeric status of this object
See Also:: Tickable.tick(Tickable, int)

canBeTaughtBy

public boolean canBeTaughtBy(MOB teacher,
                             MOB student)

Description copied from interface: Ability

Returns whether the given teacher mob is able and allowed to teach this skill to the given student. Error messages should be directed to both. This method should focus exclusively on the qualifications of the teacher.

Specified by:: canBeTaughtBy in interface Ability

Parameters:: teacher - the potential teacher of this skill; student - the potential learner of this skill
Returns:: whether the teacher can teach the skill to the student
See Also:: Ability.canBeLearnedBy(MOB, MOB), Ability.teach(MOB, MOB)

ableOk

protected boolean ableOk(MOB mob,
                         MOB target,
                         CMMsg msg)

ableSend

protected void ableSend(MOB mob,
                        MOB target,
                        CMMsg msg)

requirements

public java.lang.String requirements()

Description copied from interface: Ability

Returns a string describing the requirements and qualifications that are required to learn this skill.

Specified by:: requirements in interface Ability

Returns:: a description of the learning requirements of this skill.

canBeLearnedBy

public boolean canBeLearnedBy(MOB teacher,
                              MOB student)

Description copied from interface: Ability

Returns whether the given student mob is able and allowed to learn this skill from the given teacher. Error messages should be directed to both. This method should focus exclusively on the qualifications of the student.

Specified by:: canBeLearnedBy in interface Ability

Parameters:: teacher - the potential teacher of this skill; student - the potential learner of this skill
Returns:: whether the student can learn the skill from the teacher
See Also:: Ability.canBeTaughtBy(MOB, MOB), Ability.teach(MOB, MOB)

verbalCastCode

protected int verbalCastCode(MOB mob,
                             Environmental target,
                             boolean auto)

verbalCastMask

protected int verbalCastMask(MOB mob,
                             Environmental target,
                             boolean auto)

somanticCastCode

protected int somanticCastCode(MOB mob,
                               Environmental target,
                               boolean auto)

somanticCastMask

protected int somanticCastMask(MOB mob,
                               Environmental target,
                               boolean auto)

canBePracticedBy

public boolean canBePracticedBy(MOB teacher,
                                MOB student)

Description copied from interface: Ability

Returns whether the given teacher mob is able and allowed to practice this skill with the given student *and* whether the student is able and allowed to practice this skill. Error messages should be directed to both.

Specified by:: canBePracticedBy in interface Ability

Parameters:: teacher - the potential practice teacher of this skill; student - the potential practicer of this skil
Returns:: whether the teacher and student are capable of practicing together
See Also:: Ability.practice(MOB, MOB)

teach

public void teach(MOB teacher,
                  MOB student)

Description copied from interface: Ability

Teaches this skill to the student mob, presumably from the teacher mob. This method assumes that both the teacher and student are authorized. Authorization comes from canBeTaughtBy and canBeLearnedBy

Specified by:: teach in interface Ability

Parameters:: teacher - the teacher of this skill; student - the learner of this skill
See Also:: Ability.canBeTaughtBy(MOB, MOB), Ability.canBeLearnedBy(MOB, MOB)

practice

public void practice(MOB teacher,
                     MOB student)

Description copied from interface: Ability

Causes the student to practice this skill, presumably with the teacher mob. This method assumes that both the teacher and student are authorized. Authorization comes from canBePracticedBy

Specified by:: practice in interface Ability

Parameters:: teacher - the teacher of this skill; student - the practicer of this skill
See Also:: Ability.canBePracticedBy(MOB, MOB)

makeLongLasting

public void makeLongLasting()

Description copied from interface: Ability

If this ability has been added as as temporary effect, like sleep, or trip, or other typical spells, calling this method will make it so thatit will not do so on its own for a long long time. This method does not make it UNinvokable, but only makes it last a long time.

Specified by:: makeLongLasting in interface Ability

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

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

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

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

tick

public boolean tick(Tickable ticking,
                    int tickID)

Description copied from interface: Tickable

this is the method which is called periodically by the threading engine. How often it is called depends on the parameters passed to the threadding engine when it is submitted for thread access. Typically the period is once per TIME_TICK period, but that is determined when the object is submitted to the thread engine.

Specified by:: tick in interface Tickable

Parameters:: ticking - a reference to this Tickable object; tickID - the TICKID_ constant describing this periodic call, as defined in Tickable
Returns:: true always, unless this object no longer wishes to ever tick again, in which case false
See Also:: Tickable, ServiceEngine, TickableGroup

appropriateToMyFactions

public boolean appropriateToMyFactions(MOB mob)

Description copied from interface: Ability

Returns whether there are any Faction reasons why the given mob should not use this skill. Used primarily for alignment checks of Prayers.

Specified by:: appropriateToMyFactions in interface Ability

Parameters:: mob - the mob whose factions to check
Returns:: whether there are any faction reasons not to cast this.
See Also:: Prayer, Faction

addEffect

public void addEffect(Ability to)

Description copied from interface: Environmental

Add a new effect to this object, whether permanent or temporary. After calling this method, recoverEnvStats() should be called next in case this ability object modifies the stats. An Ability with a given ID() can only be added once per object.

Specified by:: addEffect in interface Environmental

Parameters:: to - The ability object to add as an effect.
See Also:: Ability, Environmental.recoverEnvStats()

addNonUninvokableEffect

public void addNonUninvokableEffect(Ability to)

Description copied from interface: Environmental

Same as addEffect(Ability), but will set the Ability object as never being able to be uninvoked. recoverEnvStats() method should be called next. An Ability with a given ID() can only be added once per object.

Specified by:: addNonUninvokableEffect in interface Environmental

Parameters:: to - The ability object to add as an effect.
See Also:: Ability, Environmental.recoverEnvStats()

delEffect

public void delEffect(Ability to)

Description copied from interface: Environmental

Delete an effect from this object, whether permanent or temporary. After calling this method, recoverEnvStats() should be called next in case this ability object modified the stats.

Specified by:: delEffect in interface Environmental

Parameters:: to - The ability object to remove as an effect on this object
See Also:: Ability, Environmental.recoverEnvStats()

numEffects

public int numEffects()

Description copied from interface: Environmental

Returns the number of ability objects listed as effects on this object.

Specified by:: numEffects in interface Environmental

Returns:: the number of effects this object has
See Also:: Ability

fetchEffect

public Ability fetchEffect(int index)

Description copied from interface: Environmental

Returns an ability object listed as an effect on this object. May return null even if the index is correct to mark a race condition.

Specified by:: fetchEffect in interface Environmental

Parameters:: index - which object to return
Returns:: the ability object effecting this object
See Also:: Ability, Environmental.numEffects()

fetchEffect

public Ability fetchEffect(java.lang.String ID)

Description copied from interface: Environmental

Returns an ability object listed as an effect on this object. The object will be the one with the same ID() string as passed in.

Specified by:: fetchEffect in interface Environmental

Returns:: the ability object effecting this object
See Also:: Ability, CMObject.ID()

addBehavior

public void addBehavior(Behavior to)

Description copied from interface: Behavable

Add a new behavior to this object. After calling this method, recoverEnvStats() should be called next in case this behavior object modifies the stats. A Behavior with a given ID() can only be added once per object.

Specified by:: addBehavior in interface Behavable

Parameters:: to - The behavior object to add.
See Also:: Behavior, Environmental.recoverEnvStats()

delBehavior

public void delBehavior(Behavior to)

Description copied from interface: Behavable

Delete a behavior from this object. After calling this method, recoverEnvStats() should be called next in case this behavior object modified the stats.

Specified by:: delBehavior in interface Behavable

Parameters:: to - The behavior object to remove.
See Also:: Behavior, Environmental.recoverEnvStats()

numBehaviors

public int numBehaviors()

Description copied from interface: Behavable

The number of behaviors this object has.

Specified by:: numBehaviors in interface Behavable

Returns:: the number of behaviors
See Also:: Behavior

fetchBehavior

public Behavior fetchBehavior(int index)

Description copied from interface: Behavable

Returns a behavior object on this object. May return null even if the index is correct to mark a race condition.

Specified by:: fetchBehavior in interface Behavable

Parameters:: index - which object to return
Returns:: the behavior object
See Also:: Behavior, Behavable.numBehaviors()

fetchBehavior

public Behavior fetchBehavior(java.lang.String ID)

Description copied from interface: Behavable

Returns a behavior object listed on this object. The object will be the one with the same ID() string as passed in.

Specified by:: fetchBehavior in interface Behavable

Returns:: the behavior object
See Also:: Behavior, CMObject.ID()

addScript

public void addScript(ScriptingEngine S)

Description copied from interface: Behavable

Add a new runnable script to this object. Objects which are not mobs or areas will gain a temporary tick service for this script.

Specified by:: addScript in interface Behavable

Parameters:: S - the scripting engine, fully populated, to add
See Also:: ScriptingEngine

delScript

public void delScript(ScriptingEngine S)

Description copied from interface: Behavable

Remove a running script from this object.

Specified by:: delScript in interface Behavable

Parameters:: S - the specific scripting engine to remove
See Also:: ScriptingEngine

numScripts

public int numScripts()

Description copied from interface: Behavable

Return the number of scripts running on this object

Specified by:: numScripts in interface Behavable

Returns:: number of scripts

fetchScript

public ScriptingEngine fetchScript(int x)

Description copied from interface: Behavable

Retreive one of the enumerated scripts running on this object

Specified by:: fetchScript in interface Behavable

Parameters:: x - which script to return
Returns:: the scripting engine
See Also:: ScriptingEngine

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

Returns:: whether this item is modifiable by builders
See Also:: Environmental.text()

getSaveStatIndex

public int getSaveStatIndex()

Description copied from interface: CMModifiable

Returns the index into the stat codes array where extra savable fields begins. This number is always the same as getStatCodes().length unless there are extra fields which need to be saved in xml for generic objects. This method is used by editors for post-build user-defined fields.

Specified by:: getSaveStatIndex in interface CMModifiable

Returns:: the index into getStatCodes()
See Also:: CMModifiable.getStatCodes(), CMModifiable.getStat(String), CMModifiable.setStat(String, String)

getStatCodes

public java.lang.String[] getStatCodes()

Description copied from interface: CMModifiable

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 CMModifiable

Returns:: list of the fields which may be set.
See Also:: CMModifiable.getStat(String), CMModifiable.setStat(String, String)

isStat

public boolean isStat(java.lang.String code)

Description copied from interface: CMModifiable

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:: isStat in interface CMModifiable

Parameters:: code - the name of the field to read.
Returns:: true if the code is a real value, false otherwise
See Also:: CMModifiable.getStatCodes()

getCodeNum

protected int getCodeNum(java.lang.String code)

getStat

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

Description copied from interface: CMModifiable

Specified by:: getStat in interface CMModifiable

Parameters:: code - the name of the field to read.
Returns:: the value of the field read
See Also:: CMModifiable.getStatCodes()

setStat

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

Description copied from interface: CMModifiable

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 CMModifiable

Parameters:: code - the name of the field to set; val - the value to set the field to
See Also:: CMModifiable.getStatCodes()

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

Parameters:: E - the object to compare this one to
Returns:: whether this object is the same as the one passed in
See Also:: CMModifiable.getStatCodes(), CMModifiable.getStat(String)

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.planet_ink.coffee_mud.Abilities Class StdAbility

empty

expertise

isAnAutoEffect

proficiency

savable

miscText

invoker

affected

canBeUninvoked

unInvoked

tickDown

lastCastHelp

envStats

amDestroyed

StdAbility

ID

Name

name

description

displayText

image

rawImage

setImage

triggerStrings

maxRange

minRange

castingTime

combatCastingTime

putInCommandlist

isAutoInvoked

bubbleAffect

iniTrainsRequired

iniPracticesRequired

trainsRequired

practicesRequired

practicesToPractice

iniPracticesToPractice

miscTextFormat

flags

usageType

overrideMana

abstractQuality

enchantQuality

initializeClass

castingQuality

castingQuality

expertise

getX1Level

getX2Level

getX3Level

getX4Level

getX5Level

getXLEVELLevel

getXLOWCOSTLevel

getXMAXRANGELevel

getXTIMELevel

getXPCOSTLevel

getXPCOSTAdjustment

adjustedMaxInvokerRange

canAffectCode

canTargetCode

finalize

newInstance

classificationCode

envStats

baseEnvStats

expirationDate

setExpirationDate

isNowAnAutoEffect

savable

setSavable

destroy

amDestroyed

setName

recoverEnvStats

setBaseEnvStats

setDisplayText

setDescription

abilityCode

com.planet_ink.coffee_mud.Abilities
Class StdAbility