Package com.planet_ink.coffee_mud.Commands

Class Dig

java.lang.Object

com.planet_ink.coffee_mud.Commands.StdCommand

com.planet_ink.coffee_mud.Commands.Dig

All Implemented Interfaces:

Command, CMObject, java.lang.Cloneable, java.lang.Comparable<CMObject>

public class Dig
extends StdCommand

Field Summary

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

idConverter

Fields inherited from class com.planet_ink.coffee_mud.Commands.StdCommand

ID, noCoinFilter

Constructor Summary

Constructors

Constructor	Description
Dig()

Method Summary

Modifier and Type	Method	Description
double	actionsCost(MOB mob, java.util.List<java.lang.String> cmds)	Returns the number of actions required to completely activate this command.
boolean	canBeCancelled()	Returns true if the command will not be executed if all are true: 1.
boolean	canBeOrdered()	Whether a group leader or charmer can order their followers to do this command.
double	combatActionsCost(MOB mob, java.util.List<java.lang.String> cmds)	Returns the number of actions required to completely activate this command.
boolean	execute(MOB mob, java.util.List<java.lang.String> commands, int metaFlags)	This method actually performs the command, when the given parsed set of command-line words.
java.lang.String[]	getAccessWords()	Returns the set of command words, with the most public one first, that are entered by the user to initiate this command.
int	getDiggingDepth(Item item)
boolean	preExecute(MOB mob, java.util.List<java.lang.String> commands, int metaFlags, int secondsElapsed, double actionsRemaining)	This method is only called when the mob invoking this command does not have enough actions to complete it immediately.

Methods inherited from class java.lang.Object

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

Methods inherited from class com.planet_ink.coffee_mud.Commands.StdCommand

checkArguments, checkedActionsCost, compareTo, copyOf, executeInternal, getArgumentSetIndex, getVisibleRoomTarget, I, ID, initializeClass, isOccupiedWithOtherWork, L, name, newInstance, putInCommandlist, securityCheck

Constructor Detail

Dig

public Dig()

Method Detail

getAccessWords

public java.lang.String[] getAccessWords()

Description copied from interface: Command

Returns the set of command words, with the most public one first, that are entered by the user to initiate this command.

Specified by:

getAccessWords in interface Command

Overrides:

getAccessWords in class StdCommand

Returns:

the set of command words that the user enters

getDiggingDepth

public int getDiggingDepth(Item item)

preExecute

public boolean preExecute(MOB mob,
                          java.util.List<java.lang.String> commands,
                          int metaFlags,
                          int secondsElapsed,
                          double actionsRemaining)
                   throws java.io.IOException

Description copied from interface: Command

This method is only called when the mob invoking this command 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, execute is called. It is called with -1 seconds elapsed if it is cancelled.

Specified by:

preExecute in interface Command

Overrides:

preExecute in class StdCommand

Parameters:

mob - the player or mob invoking the command

commands - the parameters entered for the command (including the trigger word)

metaFlags - flags denoting how the command is being executed

secondsElapsed - 0 at first, and increments every second

actionsRemaining - number of free actions the player is defficient.

Returns:

whether the command should be allowed to go forward. false cancels altogether.

Throws:

java.io.IOException - usually means the player has dropped carrier

See Also:

Command.execute(MOB, List, int), Command.canBeCancelled()

execute

public boolean execute(MOB mob,
                       java.util.List<java.lang.String> commands,
                       int metaFlags)
                throws java.io.IOException

Description copied from interface: Command

This method actually performs the command, when the given parsed set of command-line words. The commands list is almost always the set of strings, starting with the access word that triggered the command. Some commands have custom APIs however, that allow almost anything to be in the commands list, or even for the commands to be null. This method is not allowed to be called until the player or mob has satisfied the actionsCost requirements and the securityCheck

Specified by:

execute in interface Command

Overrides:

execute in class StdCommand

Parameters:

mob - the mob or player issueing the command

commands - usually the command words and parameters; a set of strings

metaFlags - flags denoting how the command is being executed

Returns:

whether the command was successfully executed. Is almost meaningless.

Throws:

java.io.IOException - usually means the player has dropped carrier

See Also:

Command.actionsCost(MOB, List), Command.securityCheck(MOB)

combatActionsCost

public double combatActionsCost(MOB mob,
                                java.util.List<java.lang.String> cmds)

Description copied from interface: Command

Returns the number of actions required to completely activate this command. A value of 0.0 means perform instantly. This method only applies when the user is fighting in combat.

Specified by:

combatActionsCost in interface Command

Overrides:

combatActionsCost in class StdCommand

Parameters:

mob - the mob executing the command, if any

cmds - the parameters to be passed to the command, if any

Returns:

the number of player free actions required to do this

See Also:

Command.actionsCost(MOB, List), Command.checkedActionsCost(MOB, List)

actionsCost

public double actionsCost(MOB mob,
                          java.util.List<java.lang.String> cmds)

Description copied from interface: Command

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

Specified by:

actionsCost in interface Command

Overrides:

actionsCost in class StdCommand

Parameters:

mob - the mob executing the command, if any

cmds - the parameters to be passed to the command, if any

Returns:

the number of player free actions required to do this

See Also:

Command.combatActionsCost(MOB, List), Command.checkedActionsCost(MOB, List)

canBeOrdered

public boolean canBeOrdered()

Description copied from interface: Command

Whether a group leader or charmer can order their followers to do this command.

Specified by:

canBeOrdered in interface Command

Overrides:

canBeOrdered in class StdCommand

Returns:

whether this command can be ordered.

canBeCancelled

public boolean canBeCancelled()

Description copied from interface: Command

Returns true if the command will not be executed if all are true: 1. the player lacks the actions to complete the command in one tick 2. the player has an queued command whose action cost gr. 0.0 When cancelled, preExecute is called with a secondsElapsed of -1

Specified by:

canBeCancelled in interface Command

Overrides:

canBeCancelled in class StdCommand

Returns:

true if the command can be cancelled, false otherwise

See Also:

Command.preExecute(MOB, List, int, int, double)