Method Detail

• pray

  public static IAction pray(IGame game)

  Pray if it is likely to succeed, otherwise returns null.

  See Also:

  IGame.canPray()

• kick

  public static IAction kick(IGame game,
             Direction dir)

  Kick in the given direction if the player is capable of kicking and there don't seem to be heavy objects. Auto-removes levitation items, if the player has hurt legs does Search instead, if trapped moves out of the trap.

• unbag

  public static IAction unbag(IGame game,
              Map.Entry<Character,IItem> item)

  If the slot of the item MapEntry is a bag, take one of item out of the bag, otherwise returns null. Meant for use with entries returned by IGame#have or IGame#haveAll with the BAGGED option

• wield

  public static IAction wield(IGame game,
              Character slot)

  If it is possible for the player, wield item at slot as a weapon, otherwise returns null. Removes any shield if the weapon is two-handed.

• makeUse

  public static IAction makeUse(IGame game,
                Character slot)

  If it is possible for the player, use the item at slot in the usual way: This means wearing armor (removing any blocking armor) or putting on jewelry.

• removeUse

  public static IAction removeUse(IGame game,
                  Character slot)

  If it is possible for the player, stop using the item at slot. This means removing armor (with blockers), unwielding a weapon or removing jewelry or accessories.

• enhanceAll

  public static IAction enhanceAll(IGame game)

  Enhance any skill that can be enhanced or return null.

• descend

  public static IAction descend(IGame game)

  Remove levitation item or Descend. Returns null if levitation cannot be removed.

• untrapMove

  public static IAction untrapMove(IGame game)

  Move in any direction to escape a trap.

• doSokoban

  public static IAction doSokoban(IGame game)

  Returns an action that will lead to solving the sokoban puzzle or null if sokoban is already solved or given up on.

  This means seeking out the sokoban branch, pushing boulders to solve the puzzle and eventually reaching the zoo on the last level.

  The bot needs to take over at times and actively kill any monsters that interfere or get stuck behind a boulder, otherwise the bot itself will likely get stuck.

  Sokoban is considered solved when the bot reaches the prize tile in the zoo (with perma-engraved Elbereth). If more boulders appear on the level the bot will give up (and may get stuck on the level).

• withoutLevitation

  public static IAction withoutLevitation(IGame game,
                          IAction action)

  Action modifier – if the player is levitating, replaces the given action with removal of the levitation item, otherwise returns the action unmodified. If removal of levitation is not possible, returns null. If the action is null, returns null. Doesn't handle intrinsic levitation (eg. from a potion)

  See Also:

  IGame.haveLevitationItemOn()

• withReason

  public static IAction withReason(IAction action,
                   String reason)

  Action modifier – attach a human-understandable reason to the given action. This will be seen in the logs when the action is triggered and may help with debugging. If the action is null, returns null. Reasons are stacked, all reasons will be logged when used repeatedly.

  Parameters:

  reason - Human readable text that will be logged when the action triggers