package cz.cuni.amis.pogamut.ut2004.agent.module.sensor;
   
   import java.util.logging.Level;
   import java.util.logging.Logger;
   
   import cz.cuni.amis.pogamut.base.agent.module.SensorModule;
   import cz.cuni.amis.pogamut.base.communication.worldview.IWorldView;
   import cz.cuni.amis.pogamut.base.communication.worldview.event.IWorldEventListener;
   import cz.cuni.amis.pogamut.base.communication.worldview.object.IWorldObjectEvent;
  import cz.cuni.amis.pogamut.base.communication.worldview.object.IWorldObjectEventListener;
  import cz.cuni.amis.pogamut.base.communication.worldview.object.event.WorldObjectUpdatedEvent;
  import cz.cuni.amis.pogamut.base.utils.math.DistanceUtils;
  import cz.cuni.amis.pogamut.base3d.worldview.object.ILocated;
  import cz.cuni.amis.pogamut.base3d.worldview.object.Location;
  import cz.cuni.amis.pogamut.base3d.worldview.object.Rotation;
  import cz.cuni.amis.pogamut.base3d.worldview.object.Velocity;
  import cz.cuni.amis.pogamut.unreal.communication.messages.UnrealId;
  import cz.cuni.amis.pogamut.ut2004.agent.module.sensomotoric.Weaponry;
  import cz.cuni.amis.pogamut.ut2004.bot.IUT2004BotController;
  import cz.cuni.amis.pogamut.ut2004.bot.impl.UT2004Bot;
  import cz.cuni.amis.pogamut.ut2004.communication.messages.ItemType;
  import cz.cuni.amis.pogamut.ut2004.communication.messages.gbinfomessages.BotKilled;
  import cz.cuni.amis.pogamut.ut2004.communication.messages.gbinfomessages.ConfigChange;
  import cz.cuni.amis.pogamut.ut2004.communication.messages.gbinfomessages.InitedMessage;
  import cz.cuni.amis.pogamut.ut2004.communication.messages.gbinfomessages.Item;
  import cz.cuni.amis.pogamut.ut2004.communication.messages.gbinfomessages.NavPoint;
  import cz.cuni.amis.pogamut.ut2004.communication.messages.gbinfomessages.Player;
  import cz.cuni.amis.pogamut.ut2004.communication.messages.gbinfomessages.PlayerKilled;
  import cz.cuni.amis.pogamut.ut2004.communication.messages.gbinfomessages.PlayerScore;
  import cz.cuni.amis.pogamut.ut2004.communication.messages.gbinfomessages.Self;
  import cz.cuni.amis.pogamut.ut2004.communication.messages.gbinfomessages.VolumeChanged;
  import cz.cuni.amis.utils.NullCheck;
  
  /**
   * Memory module specialized on general info about the agent whereabouts.
   * <p><p>
   * It is designed to be initialized inside {@link IUT2004BotController#prepareBot(UT2004Bot)} method call
   * and may be used since first {@link Self} message is received, i.e, since the first {@link IUT2004BotController#botFirstSpawn(cz.cuni.amis.pogamut.ut2004.communication.messages.gbinfomessages.GameInfo, ConfigChange, InitedMessage, Self)} 
   * is called.
   *
   * @author Juraj 'Loque' Simlovic
   * @author Jimmy
   */
  public class AgentInfo extends SensorModule<UT2004Bot>
  {
  	public static final String NONE_WEAPON_ID = "None";
  
  	/**
  	 * Retreives a unique ID of the agent in the game.
  	 *
  	 * <p>Note: This ID does not change and can be relied upon during entire
  	 * match. However, be aware that the ID may change between different matches
  	 * and/or sessions.
  	 *
  	 * @return ID of the agent in the game.
  	 */
  	public UnrealId getId()
  	{
  		// retreive from self object
      if (self == null) return null;
      if (self.getBotId() != null) return self.getBotId();
  		return self.getId();
  	}
  
  	/**
  	 * Retreives current name of the agent in the game.
  	 *
  	 * <p>Note: The agent may choose and change it's name during a match and it
  	 * does not need to be unique among players. Even an empty string might be
  	 * a valid name.
  	 *
  	 * @return Name of the agent in the game.
  	 */
  	public String getName()
  	{
  		// retreive from self object
                  if (self == null) return null;
  		return self.getName();
  	}
  
  	/*========================================================================*/
  
  	/** Red team number. */
  	public static final int TEAM_RED = 0;
  	/** Blue team number. */
  	public static final int TEAM_BLUE = 1;
  	/** Green team number. */
  	public static final int TEAM_GREEN = 2;
  	/** Gold team number. */
  	public static final int TEAM_GOLD = 3;
  	/** No-team number. */
  	public static final int TEAM_NONE = 255;
  
  	/**
  	 * Retreives team number the agent is on.
  	 *
  	 * @return Team number the player is on.
  	 *
  	 * @see #TEAM_RED
 	 * @see #TEAM_BLUE
 	 * @see #TEAM_GREEN
 	 * @see #TEAM_GOLD
 	 * @see #TEAM_NONE
 	 *
 	 * @see isEnemy(int)
 	 * @see isEnemy(Player)
 	 * @see isFriend(int)
 	 * @see isFriend(Player)
 	 */
 	public Integer getTeam()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.getTeam();
 	}
 
 	/**
 	 * Tells, whether a given team is an enemy team to the agent.
 	 *
 	 * @param team Team number to be tested.
 	 * @return True, if the given team is an enemy team.
 	 *
 	 * @see getTeam()
 	 * @see isFriend(int)
 	 */
 	public boolean isEnemy(int team)
 	{
 		// freelancers' team or different team
 		return (team == TEAM_NONE) || (team != getTeam());
 	}
 
 	/**
 	 * Tells, whether a given player is an enemy to the agent.
 	 *
 	 * @param player Player to be tested.
 	 * @return True, if the given player is an enemy.
 	 *
 	 * @see getTeam()
 	 * @see isFriend(Player)
 	 */
 	public boolean isEnemy(Player player)
 	{
 		// test the enemy team number
 		return isEnemy(player.getTeam());
 	}
 
 	/**
 	 * Tells, whether a given team is a friend team to the agent.
 	 *
 	 * @param team Team number to be tested.
 	 * @return True, if the given team is a friend team.
 	 *
 	 * @see getTeam()
 	 * @see isEnemy(int)
 	 */
 	public boolean isFriend(int team)
 	{
 		// same team only
 		return (team == getTeam());
 	}
 
 	/**
 	 * Tells, whether a given player is a friend to the agent.
 	 *
 	 * @param player Player to be tested.
 	 * @return True, if the given player is a friend.
 	 *
 	 * @see getTeam()
 	 * @see isEnemy(Player)
 	 */
 	public boolean isFriend(Player player)
 	{
 		// test the friend team number
 		return isFriend(player.getTeam());
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Which distance to a location is considered the same as specified location. Note
 	 * that UT units are rather small.
 	 */
 	public static final double AT_LOCATION_EPSILON = 120;
 
     /**
      * What angle is considered to be maximum facing angle by default (in degrees).
      */
     public static final double IS_FACING_ANGLE = 6;
     
     /**
      * EXACT at location (in UT units).
      */
 	public static final double CLOSE_ENOUGH_EPSILON = 50;
 
 	/**
 	 * Retreives absolute location of the agent within the map.
 	 *
 	 * @return Location of the agent within the map.
 	 *
 	 * @see getDistance(Location)
 	 * @see Location#getDistance(Location)
 	 * @see Location#getDistanceL1(Location)
 	 * @see Location#getDistanceLinf(Location)
 	 * @see Location#getDistancePlane(Location)
 	 * @see Location#getDistanceSquare(Location)
 	 */
 	public Location getLocation()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.getLocation();
 	}
 	
 	/**
 	 * Tells whether the bot is at navpoint/item/... (anything {@link ILocated}) of id 'objectId'. Note that IDs are case sensitive! UT2004 is usually using camel-case.
 	 * @param objectId
 	 * @return
 	 */
 	public boolean atLocation(String objectId) {
 		Object obj = agent.getWorldView().get(UnrealId.get(objectId));
 		if (obj == null) {
 			if (log != null && log.isLoggable(Level.WARNING)) log.warning("atLocation(): Object with id '" + objectId + "' does not exist in the worldview!"); 
 			return false;
 		}
 		if (!(obj instanceof ILocated)) {
 			if (log != null && log.isLoggable(Level.WARNING)) log.warning("atLocation(): Object with id '" + objectId + "' is not implementing ILocated, it is " + obj.getClass().getSimpleName() + ".");
 			return false;
 		}
 		return atLocation((ILocated)obj);
 	}
 	
 	/**
 	 * Tells whether the bot is at navpoint/item/... (anything {@link ILocated}) of id 'objectId'. Note that IDs are case sensitive! UT2004 is usually using camel-case.
 	 * @param objectId
 	 * @param epsilon
 	 * @return
 	 */
 	public boolean atLocation(String objectId, double epsilon) {
 		Object obj = agent.getWorldView().get(UnrealId.get(objectId));
 		if (obj == null) {
 			if (log != null && log.isLoggable(Level.WARNING)) log.warning("atLocation(): Object with id '" + objectId + "' does not exist in the worldview!"); 
 			return false;
 		}
 		if (!(obj instanceof ILocated)) {
 			if (log != null && log.isLoggable(Level.WARNING)) log.warning("atLocation(): Object with id '" + objectId + "' is not implementing ILocated, it is " + obj.getClass().getSimpleName() + ".");
 			return false;
 		}
 		return atLocation((ILocated)obj, epsilon);
 	}
 	
 	/**
 	 * Returns whether the bot is at 'location'.
 	 * <p><p>
 	 * Synonym for {@link AgentInfo#atLocation(Location)}.
 	 * 
 	 * @return bot is at lcoation
 	 */
 	public boolean isAtLocation(ILocated location) {
 		return atLocation(location);
 	}
 
 	/**
 	 * Returns whether the bot is at 'location', using {@link AgentInfo#AT_LOCATION_EPSILON}.
 	 * 
 	 * @return bot is at lcoation
 	 */
 	public boolean atLocation(ILocated location) {		
 		return atLocation(location, AT_LOCATION_EPSILON);
 	}
 
 	/**
 	 * Returns whether the bot is at 'location', using 'epsilon' as a distance tolerance
 	 * @param location
 	 * @param epsilon
 	 * @return bot is at lcoation with desired epsilon tolerance
 	 */
 	public boolean atLocation(ILocated location, double epsilon) {
 		if (location == null || getLocation() == null) return false;
 		return getLocation().getPoint3d().distance(location.getLocation().getPoint3d()) < epsilon;
 	}
 
 	/**
 	 * Computes crow-fly distance of the agent from given location.
 	 *
 	 * @param location Location within the map.
 	 * @return Crow-fly distance of the agent and the location.
 	 *
 	 * @see getLocation()
 	 */
 	public Double getDistance(ILocated location)
 	{
 		// retreive from self object
                 if (self == null) return null;
                 if (location == null) return null;
 		return self.getLocation().getDistance(location.getLocation());
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Retreives absolute rotation of the agent within the map.
 	 *
 	 * @return Rotation of the agent within the map.
 	 */
 	public Rotation getRotation()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.getRotation();
 	}
 	
 	/**
 	 * Retreives absolute rotation of the agent within the map.
 	 *
 	 * @return Rotation of the agent within the map.
 	 */
 	public Rotation getHorizontalRotation()
 	{
 		// retreive from self object
         if (self == null) return null;
         Rotation rot = new Rotation(self.getRotation());
         rot.pitch = 0;
         rot.roll = 0;
 		return rot;
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Retreives current velocity of the agent as a vector of movement.
 	 *
 	 * @return Current velocity of the agent in the map.
 	 *
 	 * @see isMoving()
 	 */
 	public Velocity getVelocity()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.getVelocity();
 	}
 
 	/**
 	 * Tells, whether the agent is moving. The agent is moving, when his
 	 * actual velocity is non-zero.
 	 *
 	 * @return True, if the agent is moving.
 	 *
 	 * @see getVelocity()
 	 */
 	public Boolean isMoving()
 	{
 		// check the size of the velocity
                 if (getVelocity() == null) return null;
 		return !getVelocity().isZero();
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Tells, whether the agent is crouched. When crouched, the height of the
 	 * agent is smaller and thus harder to spot/hit.
 	 *
 	 * @return True, if the agent is crouched.
 	 */
 	public Boolean isCrouched()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.isCrouched();
 	}
 
 	/**
 	 * Tells, whether the agent is walking. When walking, the agent does not
 	 * fall off the edges before notification about such edge can be sent to
 	 * the agent. The agent's movement is, however, much slower.
 	 *
 	 * @return True, if the agent is walking.
 	 */
 	public Boolean isWalking()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.isWalking();
 	}
         /*========================================================================*/
 
 	/**
 	 * Tells if the agent is currently facing input location.
          *
          * @param location input location.
 	 * @return True, if the bot is facing input location.
 	 */
 	public Boolean isFacing(ILocated location)
 	{
                 if (location == null || getRotation() == null) return null;
                 Location directionVector = location.getLocation().sub(this.getLocation()).getNormalized();
                 Location agentFaceVector = this.getRotation().toLocation().getNormalized();
 
                 if (Math.acos(directionVector.dot(agentFaceVector)) <= Math.toRadians(IS_FACING_ANGLE))
                     return true;
 
                 return false;
 	}
 
 
 	/**
 	 * Tells if the agent is currently facing input location.
          *
          * @param location input location.
          * @param angle specifies maximum angle (in degrees) that will be still considered as facing angle.
 	 * @return True, if the angle between agent facing vector and input location is smaller or equal to input angle.
 	 */
 	public Boolean isFacing(ILocated location, double angle)
 	{
                 if (location == null || getRotation() == null) return null;
                 Location directionVector = location.getLocation().sub(this.getLocation()).getNormalized();
                 Location agentFaceVector = this.getRotation().toLocation().getNormalized();
 
                 if (Math.acos(directionVector.dot(agentFaceVector)) <= Math.toRadians(angle))
                     return true;
 
                 return false;
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Retreives location of the nearest map geometry directly beneath the
 	 * agent. This can be used to determine how far the agent is above the
 	 * ground, etc.
 	 *
 	 * @return Location of <i>the ground</i> beneath the agent.
 	 */
 	public Location getFloorLocation()
 	{
                 if (self == null) return null;
 		// retreive from self object
 		return self.getFloorLocation();
 	}
 
 	/**
 	 * Tells, whether the agent is currently touching the groud with his feets.
 	 * When not touching ground, the agent might be either jumping, or falling,
 	 * or hanging from a ledge, or otherwise flying above the ground.
 	 *
 	 * @return True, if the agent is touching ground with his feets.
 	 */
 	public Boolean isTouchingGround()
 	{
 		// compare locations of agent and floor (beware of being crouched)
 		// FIXME[jimmy]: Test the values..
                 if (getLocation() == null || getFloorLocation() == null) return null;
 		return (getLocation().z - getFloorLocation().z)
 			   < (isCrouched() ? 50 : 80);
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Tells whether the agent has the damage multiplier (UDamage) bonus boost
 	 * activated and how long will the UDamage boost remain active.
 	 *
 	 * <p>When UDamage is activated, the agent is  causing double (or tripple,
 	 * or even more) damage to other players. The multiplying factor depends
 	 * on game settings and mutators.
 	 *
 	 * @return Time remaining for UDamage bonus boost. When this value is
 	 * positive, the agent has the UDamage bonus boost currently activated.
 	 * When this value is negative, the agent does not have UDamage activated.
 	 *
 	 * @see hasUDamage()
 	 */
 	public Double getRemainingUDamageTime()
 	{
 		// calculate remaining time by substracting current time
                 if (self == null) return null;
 		return self.getUDamageTime() - getTime();
 	}
 
 	/**
 	 * Tells whether the agent has the damage multiplier (UDamage) bonus boost
 	 * activated.
 	 *
 	 * <p>When UDamage is activated, the agent is  causing double (or tripple,
 	 * or even more) damage to other players. The multiplying factor depends
 	 * on game settings and mutators.
 	 *
 	 * @return True, if the agent has damage multiplier bonus action activated.
 	 *
 	 * @see getRemainingUDamageTime()
 	 */
 	public Boolean hasUDamage()
 	{
         if (getRemainingUDamageTime() == null) return null;
 		// is there any remaining time?
 		return getRemainingUDamageTime() > 0;
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Tells, whether the agent has special bonus action activated: the
 	 * invisibility. When invisibility is activated, the agent is almost
 	 * invisible to other players. When moving, outline of the agent is
 	 * glittering a bit. When standing still, he is very hard to spot.
 	 *
 	 * <p>To learn, for how long the bonus action will remain activated, check
 	 * the remaining amount of adrenaline. When level of adrenaline reaches
 	 * zero, the bonus action is deactivated. See {@link getAdrenaline()}.
 	 *
 	 * @return True, if the agent has invisibility bonus action activated.
 	 *
 	 * @see getAdrenaline()
 	 */
 	public Boolean hasInvisibility()
 	{
 		// check with the self object
                 if (self == null) return null;
 		return self.getCombo().equals("xGame.ComboInvis");
 	}
 
 	/**
 	 * Tells, whether the agent has special bonus action activated: the
 	 * fast firing rate. When fast firing rate is activated, the agent is
 	 * firing his weapon at a faster rate, eating more ammo, but launching
 	 * more projectiles into air.
 	 *
 	 * <p>To learn, for how long the bonus action will remain activated, check
 	 * the remaining amount of adrenaline. When level of adrenaline reaches
 	 * zero, the bonus action is deactivated. See {@link getAdrenaline()}.
 	 *
 	 * @return True, if the agent has fast firing rate bonus action activated.
 	 *
 	 * @see getAdrenaline()
 	 */
 	public Boolean hasFastFire()
 	{
 		// check with the self object
                 if (self == null) return null;
 		return self.getCombo().equals("xGame.ComboBerserk");
 	}
 
 	/**
 	 * Tells, whether the agent has special bonus action activated: the
 	 * regenration, which is also called booster. When booster is activated,
 	 * the agent regenerates health slowly. Note: The agent's health never
 	 * rises above the maximum health level.
 	 *
 	 * <p>To learn, for how long the bonus action will remain activated, check
 	 * the remaining amount of adrenaline. When level of adrenaline reaches
 	 * zero, the bonus action is deactivated. See {@link getAdrenaline()}.
 	 *
 	 * @return True, if the agent has regenration bonus action activated.
 	 *
 	 * @see getAdrenaline()
 	 */
 	public Boolean hasRegeneration()
 	{
 		// check with the self object
                 if (self == null) return null;
 		return self.getCombo().equals("xGame.ComboDefensive");
 	}
 
 	/**
 	 * Tells, whether the agent has special bonus action activated: the
 	 * speed. When speed is activated, the agent can move much faster than
 	 * other players. Note: Firing rate does not change with speed.
 	 *
 	 * <p>To learn, for how long the bonus action will remain activated, check
 	 * the remaining amount of adrenaline. When level of adrenaline reaches
 	 * zero, the bonus action is deactivated. See {@link getAdrenaline()}.
 	 *
 	 * @return True, if the agent has speed bonus action activated.
 	 *
 	 * @see getAdrenaline()
 	 */
 	public Boolean hasSpeed()
 	{
 		// check with the self object
                 if (self == null) return null;
 		return self.getCombo().equals("xGame.ComboSpeed");
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Tells, how much health the agent has.
 	 *
 	 * <p>The health usually starts at 100, and ranges from 0 to 199. These
 	 * values, however, can be changed by various mutators.
 	 *
 	 * @return Current health status.
 	 *
 	 * @see isHealthy()
 	 * @see isSuperHealthy()
 	 */
 	public Integer getHealth()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.getHealth();
 	}
 
 	/**
 	 * Tells, whether the agent is healthy, i.e. not wounded.
 	 *
 	 * @return True, if the agent has at least standard amount of health.
 	 *
 	 * @see getHealth()
 	 * @see isSuperHealthy()
 	 */
 	public Boolean isHealthy()
 	{
 		// compare self object and game info
                 if (getHealth() == null || game == null) return null;
 		return (getHealth() >= game.getFullHealth());
 	}
 
 	/**
 	 * Tells, whether the agent is healthy to the maximum boostable extent.
 	 *
 	 * @return True, if the agent has maximum amount of health.
 	 *
 	 * @see getHealth()
 	 * @see isHealthy()
 	 */
 	public Boolean isSuperHealthy()
 	{
 		// compare self object and game info
                 if (getHealth() == null || game == null) return null;
 		return (getHealth() >= game.getMaxHealth());
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Tells, how much of combined armor the agent is wearing.
 	 *
 	 * <p>The combined armor usually starts at 0, and ranges from 0 to 150.
 	 * These values, however, can be changed by various mutators.
 	 *
 	 * <p>Note: The armor consist of two parts, which are summed together into
 	 * combined armor value. However, each part is powered-up by different item
 	 * (low armor by <i>small shield</i>; high armor by <i>super-shield</i>).
 	 *
 	 * @return Current armor status.
 	 *
 	 * @see hasArmor()
 	 * @see getLowArmor()
 	 * @see getHighArmor()
 	 */
 	public Integer getArmor()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.getArmor();
 	}
 
 	/**
 	 * Tells, whether the agent is armored to the maximum extent.
 	 *
 	 * @return True, if the agent has maximum amount of armor.
 	 *
 	 * @see getArmor()
 	 * @see hasLowArmor()
 	 * @see hasHighArmor()
 	 */
 	public Boolean hasArmor()
 	{
 		// compare self object and game info
                 if (getArmor() == null) return null;
 		return (getArmor() >= game.getMaxArmor());
 	}
 
 	/**
 	 * Tells, how much of low armor the agent is wearing.
 	 *
 	 * <p>The low armor usually starts at 0, and ranges from 0 to 50.
 	 * These values, however, can be changed by various mutators.
 	 *
 	 * <p>Note: The armor consist of two parts, which are summed together into
 	 * combined armor value. However, each part is powered-up by different item
 	 * (low armor by <i>small shield</i>; high armor by <i>super-shield</i>).
 	 *
 	 * @return Current low armor status.
 	 *
 	 * @see hasLowArmor()
 	 * @see getArmor()
 	 * @see getHighArmor()
 	 */
 	public Integer getLowArmor()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.getSmallArmor();
 	}
 
 	/**
 	 * Tells, whether the agent is armored to the maximum of low-armor extent.
 	 *
 	 * @return True, if the agent has maximum amount of low-armor.
 	 *
 	 * @see getLowArmor()
 	 * @see hasArmor()
 	 * @see hasHighArmor()
 	 */
 	public Boolean hasLowArmor()
 	{
 		// compare self object and game info
                 if (getLowArmor() == null || game == null) return null;
 		return (getLowArmor() >= game.getMaxLowArmor());
 	}
 
 	/**
 	 * Tells, how much of high armor the agent is wearing.
 	 *
 	 * <p>The high armor usually starts at 0, and ranges from 0 to 100.
 	 * These values, however, can be changed by various mutators.
 	 *
 	 * <p>Note: The armor consist of two parts, which are summed together into
 	 * combined armor value. However, each part is powered-up by different item
 	 * (low armor by <i>small shield</i>; high armor by <i>super-shield</i>).
 	 *
 	 * @return Current high armor status.
 	 *
 	 * @see hasHighArmor()
 	 * @see getArmor()
 	 * @see getLowArmor()
 	 */
 	public Integer getHighArmor()
 	{
 		// calculate from armor and small armor in self object
                 if (self == null) return null;
 		return self.getArmor() - self.getSmallArmor();
 	}
 
 	/**
 	 * Tells, whether the agent is armored to the maximum of high-armor extent.
 	 *
 	 * @return True, if the agent has maximum amount of high-armor.
 	 *
 	 * @see getHighArmor()
 	 * @see hasArmor()
 	 * @see hasLowArmor()
 	 */
 	public Boolean hasHighArmor()
 	{
 		// compare self object and game info
                 if (getHighArmor() == null) return null;
 		return (getHighArmor() >= game.getMaxHighArmor());
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Tells, how much adrenaline the agent has.
 	 *
 	 * <p>Adrenaline can be gained through fulfilling various game tasks, such
 	 * as killing opponents, capturing flags, controlling domination points,
 	 * picking up adrenaline pills, etc. Note: More adrenaline is gained when
 	 * the agent fulfill these tasks in combos (e.g. by scoring a double-kill
 	 * the agent receives significantly more adrenaline than by scoring two
 	 * single-kills).
 	 *
 	 * <p>Once the adrenaline reaches a designated level, it can be used to
 	 * start special bonus actions like <i>booster</i>, <i>invisibility</i>,
 	 * <i>speed</i>, etc. The adrenaline is then spent on the action. The more
 	 * adrenaline the agent has, the longer the action lasts. Note: The agent
 	 * may gain new adrenaline during the bonus action, which prolongs the
 	 * action duration. See {@link isAdrenalineFull() } to determine, when the
 	 * necessary adrenaline level is reached.
 	 *
 	 * <p>The adrenaline usually starts at 0, and ranges from 0 to 100. These
 	 * values, however, can be changed by various mutators.
 	 *
 	 * @return Current armor status.
 	 *
 	 * @see isAdrenalineFull()
 	 */
 	public Integer getAdrenaline()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.getAdrenaline();
 	}
 
 	/**
 	 * Tells, whether the agent gained enough adrenaline to use it for special
 	 * adrenaline-based action, e.g. <i>booster</i>, <i>invisibility</i>, etc.
 	 *
 	 * @return True, if the adrenaline level is high enough for bonus action.
 	 *
 	 * @see getAdrenaline()
 	 */
 	public Boolean isAdrenalineSufficient()
 	{
 		// compare self object and game info
                 if (getAdrenaline() == null) return null;
 		return (getAdrenaline() >= game.getTargetAdrenaline());
 	}
 
 	/**
 	 * Tells, whether the agent has full adrenaline.
 	 *
 	 * @return True, if the adrenaline level is at maximum.
 	 *
 	 * @see getAdrenaline()
 	 */
 	public Boolean isAdrenalineFull()
 	{
 		// compare self object and game info
                 if (getAdrenaline() == null) return null;
 		return (getAdrenaline() >= game.getMaxAdrenaline());
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Retreives UnrealId of the weapon the agent is currently holding. This
 	 * UnrealId is a unique identifier of weapon from the agent's inventory.
 	 * Note that this UnrealId is different from UnrealId of item the agent
 	 * seen or picked up from the ground earlier.
 	 *
 	 * <p>The UnrealId might contains a substring, which identifies the type
 	 * of the weapon. However, this is not guaranteed by definition. Therefore,
 	 * you shoud use inventory to retreive the appropriate weapon object, to
 	 * further retreive correct type of weapon.
 	 *
 	 * @return UnrealId of the weapon the agent is currently holding in hands.
 	 *
 	 * @see getCurrentAmmo()
 	 * @see getCurrentSecondaryAmmo()
 	 * @see Weaponry#getCurrentWeapon()
 	 * @see Weaponry#getWeapon(UnrealId)
 	 */
 	public UnrealId getCurrentWeapon()
 	{
 		// retreive from self object
         if (self == null) return null;
 		return UnrealId.get(self.getWeapon());
 	}
 	
 	/**
 	 * Returns name of the currently wielded weapon (or null if no such weapon exists). 
 	 * 
 	 * @see getCurrentWeapon
 	 * @return
 	 */
 	public String getCurrentWeaponName() {
 		if (getCurrentWeapon() == null) return null;
 		return self.getWeapon().substring(self.getWeapon().indexOf(".")+1);
 	}
 	
 	/**
 	 * Returns type of the weapon the agent is currently holding (or null if no such weapon exists).
 	 * @return
 	 */
 	public ItemType getCurrentWeaponType() {
 		if (self == null) return null;
 		return ItemType.getItemType(getCurrentWeaponName());
 	}
 	
 	/**
 	 * Tells whether the bot is holding some weapon or not.
 	 * <p><p>
 	 * Note that {@link AgentInfo#getCurrentWeapon()} always returns some id. But there is a special id that marks 'no weapon'
 	 * @return
 	 */
 	public Boolean hasWeapon() {
                 if (self == null) return null;
 		return !self.getWeapon().equalsIgnoreCase(NONE_WEAPON_ID);	
 	}
 
 	/**
 	 * Tells, how much ammunition the agent has left for the current weapon
 	 * in its primary firing mode.
 	 *
 	 * @return Amount of ammunition for the primary firing mode.
 	 *
 	 * @see getCurrentSecondaryAmmo()
 	 * @see Inventory#getCurrentPrimaryAmmo()
 	 */
 	public Integer getCurrentAmmo()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.getPrimaryAmmo();
 	}
 
 	/**
 	 * Tells, how much ammunition the agent has left for the current weapon
 	 * in its alternate (secondary) firing mode. Note that many weapons use primary ammo
 	 * for the alternate (secondary) firing mode as well. In such cases, the amount of
 	 * ammo for primary mode is returned.
 	 *
 	 * @return Amount of ammunition for the secondary firing mode.
 	 *
 	 * @see getCurrentAmmo()
 	 * @see Inventory#getCurrentSecondaryAmmo()
 	 */
 	public Integer getCurrentSecondaryAmmo()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.getSecondaryAmmo();
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Tells, whether the agent is shooting or not.
 	 *
 	 * <p>This method reports shooting with either primary or secondary fire
 	 * mode. To distinguish between the fire modes, see {@link isPriShooting()},
 	 * {@link isAltShooting()}.
 	 *
 	 * @return Returns true, if the agent is shooting his weapon.
 	 *
 	 * @see isPrimaryShooting()
 	 * @see isSecondaryShooting()
 	 */
 	public Boolean isShooting()
 	{
 		// retreive from self object
                 if (self == null) return null;
 		return self.isShooting();
 	}
 
 	/**
 	 * Tells, whether the agent is shooting with primary fire mode.
 	 *
 	 * <p>This method reports shooting with primary fire mode only. See
 	 * {@link isAltShooting()} method to determine, whether the agent shoots
 	 * with alternate firing mode. See {@link isShooting()} to determine,
 	 * whether the agent shoots with either primary or alternate firing mode.
 	 *
 	 * @return True, if the agent is shooting weapon in primary firing mode.
 	 *
 	 * @see isShooting()
 	 * @see isSecondaryShooting()
 	 */
 	public Boolean isPrimaryShooting()
 	{
 		// shooting but not in altrenate fire mode
                 if (self == null) return null;
 		return isShooting() && !isSecondaryShooting();
 	}
 
 	/**
 	 * Tells, whether the agent is shooting with alternate (secondary) fire mode.
 	 *
 	 * <p>This method reports shooting with alternate (secondary) fire mode only. See
 	 * {@link isPriShooting()} method to determine, whether the agent shoots
 	 * with primary firing mode. See {@link isShooting()} to determine,
 	 * whether the agent shoots with either primary or alternate (secondary) firing mode.
 	 *
 	 * @return True, if the agent is shooting his weapon in alternate (secondary) firing
 	 * mode.
 	 *
 	 * @see isShooting()
 	 * @see isPrimaryShooting()
 	 */
 	public Boolean isSecondaryShooting()
 	{
 		// retreive from self object
         if (self == null) return null;
 		return self.isAltFiring();
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Retreives number of kills the agent scored.
 	 *
 	 * <p>A kill is counted, whenever the agent kills an opponent.
 	 *
 	 * @return Number of kills the agent scored.
 	 */
 	public int getKills()
 	{
 		// returns number of kills, counted in PlayerKilledListener
 		return kills;
 	}
 
 	/**
 	 * Retreives number of deaths the agent took.
 	 *
 	 * <p>A death is counted, whenever the agent dies.
 	 * 
 	 * <p><p>
 	 * Note that if {@link Integer#MIN_VALUE} is returned, than the number of deaths is unknown. This happens only
 	 * if you call this method before the first logic iteration of the agent (i.e., before first {@link PlayerScore} messages
 	 * are exported by GameBots).
 	 *
 	 * @return Number of deaths the agent took.
 	 */
 	public int getDeaths()
 	{
 		if (self == null) return Integer.MIN_VALUE;
 		// retreive from PlayerScore object
 		return game.getPlayerDeaths(getId());
 	}
 
 	/**
 	 * Retreives number of suicides the agent commited.
 	 *
 	 * <p>A suicide is counted, whenever the agent dies by his own weapon, or
 	 * by damaging himself by falling into pits, lava, acid, etc.
 	 *
 	 * <p>It can also be said that suicide is every agent's death, which could
 	 * not be credited to any other player in the map.
 	 *
 	 * <p>Each suicide is also counted as death. See {@link getDeaths()}.
 	 *
 	 * @return Number of suicides the agent commited.
 	 */
 	public int getSuicides()
 	{
 		// returns number of suicides, counted in BotKilledListener
 		return suicides;
 	}
 
 	/**
 	 * Retreives current agent score.
 	 *
 	 * <p>Agent score is usually rising by achieving some goals, e.g. killing
 	 * opponents, capturing flags, controlling domination points, etc. Note:
 	 * Agent score might decrease upon suicides, based on map, game type and
 	 * game settings.
 	 * 
 	 * <p><p>
 	 * Note that if {@link Integer#MIN_VALUE} is returned, than the score is unknown. This happens only
 	 * if you call this method before the first logic iteration of the agent (i.e., before first {@link PlayerScore} messages
 	 * are exported by GameBots).
 	 *
 	 * @return Current agent score.
 	 */
 	public int getScore()
 	{
 		if (self == null) return Integer.MIN_VALUE;
 		return game.getPlayerScore(getId());
 	}
 
 	/**
 	 * Retreives current agent's team score.
 	 *
 	 * <p>Agent's team score is usually rising by achieving team goals, e.g.
 	 * killing opponents, capturing flags, controlling domination points, etc.
 	 * Note: Agent's team score might decrease, when oposing teams score points
 	 * themselves, based on map, game type and game settings.
 	 *
 	 * @return Current agent's team score.
 	 */
 	public int getTeamScore()
 	{
 		// retreive from TeamScore object
 		return game.getTeamScore(getTeam());
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Pulling velocity in this map zone. Such pulling velocity effectively
 	 * draws the player towards a specific direction or even lifts him upwards.
 	 *
 	 * @return Pulling velocity in this zone.
 	 */
 	public Velocity getCurrentZoneVelocity()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.getZoneVelocity();
 	}
 
 	/**
 	 * Gravity in this map zone. Gravity might differ throughout different
 	 * parts of the map. The gravity is expressed as a velocity vector. This
 	 * vector is used an acceleration. The fall speed may ramp up, to as much
 	 * as {@link getFallSpeed()}.
 	 *
 	 * @return Gravity in this zone.
 	 */
 	public Velocity getCurrentZoneGravity()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.getZoneGravity();
 	}
 
 	/**
 	 * Friction of the floor in this map volume. Friction of the floor works
 	 * towards movement, slowing down the acceleration and speed of the agent
 	 * in any direction.
 	 *
 	 * @return Friction of the floor.
 	 */
 	public Double getCurrentVolumeGroundFriction()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.getGroundFriction();
 	}
 
 	/**
 	 * Friction of the fluid in this map volume. Friction of the fluid works
 	 * towards movement, slowing down the acceleration and speed of the agent
 	 * in any direction.
 	 *
 	 * @return Friction of the fluid.
 	 */
 	public Double getCurrentVolumeFluidFriction()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.getFluidFriction();
 	}
 
 	/**
 	 * FIXME[js]: What the hell is this good for?
 	 *
 	 * @return TerminalVelocity of the CurrentVolume.
 	 */
 	public Double _getCurrentVolumeTerminalVelocity()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.getTerminalVelocity();
 	}
 
 	/**
 	 * Tells, whether the current volume is water. When the agent is in water,
 	 * {@link getCurrentVolumeFluidFriction()} and {@link getWaterSpeed()} can
 	 * help to determine changes to movement and speed of the agent. Also note
 	 * that {@link getCurrentZoneVelocity()}, {@link getCurrentZoneGravity()},
 	 * and others may change (and usually does) in water.
 	 *
 	 * @return True, if the current volume is water.
 	 */
 	public Boolean isCurrentVolumeWater()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.isWaterVolume();
 	}
 
 	/**
 	 * Tells, whether the current volume is causing damage. Such damage is
 	 * applied to the agent's health every second. The amount of damage taken
 	 * per each second spent in this volume can be determined by
 	 * {@link getCurrentVolumeDamagePerSec()}. When the volume damages the
 	 * agent to the death, the death is counted as a suicide.
 	 *
 	 * @return True, if the current volume is causing damage.
 	 *
 	 * @see isCurrentVolumeDestructive()
 	 * @see getCurrentVolumeDamagePerSec()
 	 */
 	public Boolean isCurrentVolumePainCausing()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.isPainCausing();
 	}
 
 	/**
 	 * Amount of damage taken for spending time in the current volume. Such
 	 * damage is applied to the agent's health every second. When the volume
 	 * damages the agent to the death, the death is counted as a suicide.
 	 *
 	 * @return Amount of damage taken for spending time in the current volume.
 	 *
 	 * @see isCurrentVolumePainCausing()
 	 */
 	public Double getCurrentVolumeDamagePerSec()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.getDamagePerSec();
 	}
 
 	/**
 	 * Tells, whether the current volume kills the actors (almost) instantly.
 	 * Death in such destructive volume is counted as a suicide.
 	 *
 	 * @return True, if the current volume kills (almost) instantly.
 	 *
 	 * @see isCurrentVolumePainCausing()
 	 */
 	public Boolean isCurrentVolumeDestructive()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.isDestructive();
 	}
 
 	/**
 	 * Retreives type of damage the current volume inflicts to the agent while
 	 * he spends time in this volume.
 	 *
 	 * <p>FIXME[js]: Is is possible to provide an enum here?
 	 *
 	 * @return Type of the damage the current volume inflicts to the agent.
 	 */
 	public String getCurrentVolumeDamageType()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.getDamageType();
 	}
 
 	/**
 	 * Tells, whether the current volume (the one the agent is within) forbids
 	 * usage of the inventory. If so, no weapons or items can be used, changed,
 	 * or picked up.
 	 *
 	 * @return True, if the current volume forbids usage of the inventory.
 	 */
 	public Boolean isCurrentVolumeBanningInventory()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.isNoInventory();
 	}
 
 	/**
 	 * Tells, whether the current volume imparts its velocity to projectiles.
 	 * E.g. A volume might impart velocity to players to emulate <i>wind</i>.
 	 * This settings tells, whether the same applies to projectiles. If so,
 	 * Their trajectory will be affected by this volume velocity.
 	 *
 	 * @return True, if the current volume imparts its velocity to projectiles.
 	 */
 	public Boolean isCurrentVolumeAffectingProjectiles()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.isMoveProjectiles();
 	}
 
 	/**
 	 * Tells, whether the current zone is a neutral zone. In neutral zone,
 	 * players can't take damage.
 	 *
 	 * @return True, if the current zone is a neutral zone.
 	 */
 	public Boolean isCurrentZoneNeutral()
 	{
 		// retreive from VolumeChanged object
                 if (lastVolumeChanged == null) return null;
 		return lastVolumeChanged.isNeutralZone();
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Retreives scaling factor for damage dealt by the agent. All damage
 	 * dealt by the agent is reduced (or increased) by this value.
 	 *
 	 * @return Scaling factor for damage dealt by the agent.
 	 */
 	public Double getDamageScaling()
 	{
 		// retreive from InitedMessage object
                 if (lastInitedMessage == null) return null;
 		return lastInitedMessage.getDamageScaling();
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Retreives maximum base speed of the agent.
 	 *
 	 * @return Maximum base speed of the agent.
 	 */
 	public Double getBaseSpeed()
 	{
 		// retreive from InitedMessage object
                 if (lastInitedMessage == null) return null;
 		return lastInitedMessage.getGroundSpeed();
 	}
 
 	/**
 	 * Retreives maximum speed of the agent while moving in the air.
 	 *
 	 * @return Maximum speed of the agent while moving in the air.
 	 */
 	public Double getAirSpeed()
 	{
 		// retreive from InitedMessage object
                 if (lastInitedMessage == null) return null;
 		return lastInitedMessage.getAirSpeed();
 	}
 
 	/**
 	 * Retreives maximum speed of the agent while moving on a ladder.
 	 *
 	 * @return Maximum speed of the agent while moving on a ladder.
 	 */
 	public Double getLadderSpeed()
 	{
 		// retreive from InitedMessage object
                 if (lastInitedMessage == null) return null;
 		return lastInitedMessage.getLadderSpeed();
 	}
 
 	/**
 	 * Retreives maximum speed of the agent while moving in water.
 	 *
 	 * @return Maximum speed of the agent while moving in water.
 	 */
 	public Double getWaterSpeed()
 	{
 		// retreive from InitedMessage object
                 if (lastInitedMessage == null) return null;
 		return lastInitedMessage.getWaterSpeed();
 	}
 
 	/**
 	 * Retreives maximum speed of the agent while falling.
 	 *
 	 * @return Maximum speed of the agent while falling.
 	 */
 	public Double getFallSpeed()
 	{
 		// retreive from InitedMessage object
                 if (lastInitedMessage == null) return null;
 		return lastInitedMessage.getMaxFallSpeed();
 	}
 
 	/**
 	 * Retreives maximum speed of the agent while using dodge.
 	 *
 	 * <p>FIXME[js]: Check about the name depending on the meaning/value.
 	 *
 	 * @return Maximum speed of the agent while using dodge.
 	 */
 	public Double getDodgeSpeedFactor()
 	{
 		// retreive from InitedMessage object
                 if (lastInitedMessage == null) return null;
 		return lastInitedMessage.getDodgeSpeedFactor();
 	}
 
 	/**
 	 * Retreives acceleration rate of the agent.
 	 *
 	 * @return Acceleration rate of the agent.
 	 */
 	public Double getAccelerationRate()
 	{
 		// retreive from InitedMessage object
                 if (lastInitedMessage == null) return null;
 		return lastInitedMessage.getAccelRate();
 	}
 
 	/**
 	 * Retreives agent's control of movement while in the air.
 	 * This value ranges from 0 (none) to 1 (full control).
 	 *
 	 * @return Agent's control of movement while in the air.
 	 */
 	public Double getAirControl()
 	{
 		// retreive from InitedMessage object
                 if (lastInitedMessage == null) return null;
 		return lastInitedMessage.getAirControl();
 	}
 
 	/**
 	 * Retreives boost of the agent in the Z axis while jumping.
 	 *
 	 * @return Jumping boost of the agent in the Z axis.
 	 */
 	public Double getJumpZBoost()
 	{
 		// retreive from InitedMessage object
                 if (lastInitedMessage == null) return null;
 		return lastInitedMessage.getJumpZ();
 	}
 
 	/**
 	 * Retreives boost of the agent in the Z axis while using dodge.
 	 *
 	 * @return Dodge boost of the agent in the Z axis.
 	 */
 	public Double getDodgeZBoost()
 	{
 		// retreive from InitedMessage object
                 if (lastInitedMessage == null) return null;
 		return lastInitedMessage.getDodgeSpeedZ();
 	}
 
 	/*========================================================================*/
 
 	/**
 	 * Retreives current game time, since the game started.
 	 *
 	 * @return Current game timestamp. IN SECONDS!
 	 */
 	public double getTime()
 	{
                 if (game == null) return 0;
 		return game.getTime();
 	}
 
 	/*========================================================================*/
 	
 	/**
 	 * Retrieves the configuration of the bot inside UT2004.
 	 * @return Configuration of the bot.
 	 */
 	public ConfigChange getConfig() {
 		return lastConfig;
 	}
 	
 	/*========================================================================*/
 	
 	
 	/**
 	 * Retrieves nearest known navpoint to current agent location.
 	 * <p><p>
 	 * WARNING: O(n) complexity.
 	 * 
 	 * @return nearest navpoint
 	 */
 	public NavPoint getNearestNavPoint() {
 		if (getLocation() == null) return null;
 		return DistanceUtils.getNearest(agent.getWorldView().getAll(NavPoint.class).values(), getLocation());
 	}
 	
 	/**
 	 * Retrieve nearest known navpoint to some location.
 	 * @param location
 	 * @return
 	 */
 	public NavPoint getNearestNavPoint(ILocated location) {
 		if (location == null) return null;
     	if (location instanceof NavPoint) return (NavPoint)location;
     	if (location instanceof Item) {
     		if (((Item)location).getNavPoint() != null) return ((Item)location).getNavPoint();
     	}
     	return DistanceUtils.getNearest(agent.getWorldView().getAll(NavPoint.class).values(), location);        
     }
 	
 	/**
 	 * Check whether the bot is on navigation graph, more precisly, near some navigation point.
 	 * <p><p>
 	 * WARNING: O(n) complexity.
 	 * 
 	 * @return
 	 */
 	public boolean isOnNavGraph() {
 		return self.getLocation().getDistance(getNearestNavPoint().getLocation()) < CLOSE_ENOUGH_EPSILON;
 	}
 	
 	/**
 	 * Retrieves nearest visible navpoint to current agent location.
 	 * <p><p>
 	 * WARNING: O(n) complexity.
 	 * 
 	 * @return nearest visible navpoint
 	 */
 	public NavPoint getNearestVisibleNavPoint() {
                 if (getLocation() == null) return null;
 		return DistanceUtils.getNearestVisible(agent.getWorldView().getAll(NavPoint.class).values(), getLocation());
 	}
 	
 	/**
 	 * Retrieves nearest known item to current agent location.
 	 * <p><p>
 	 * WARNING: O(n) complexity.
 	 * 
 	 * @return nearest item
 	 */
 	public Item getNearestItem() {
                 if (getLocation() == null) return null;
 		return DistanceUtils.getNearest(agent.getWorldView().getAll(Item.class).values(), getLocation());
 	}
 	
 	/**
 	 * Retrieves nearest visible item to current agent location.
 	 * <p><p>
 	 * WARNING: O(n) complexity.
 	 * 
 	 * @return nearest visible item
 	 */
 	public Item getNearestVisibleItem() {
                 if (getLocation() == null) return null;
 		return DistanceUtils.getNearestVisible(agent.getWorldView().getAll(Item.class).values(), getLocation());
 	}
 	
 	/**
 	 * Retrieves nearest known player to current agent location.
 	 * <p><p>
 	 * WARNING: O(n) complexity.
 	 * 
 	 * @return nearest player
 	 */
 	public Player getNearestPlayer() {
                 if (getLocation() == null) return null;
 		return DistanceUtils.getNearest(agent.getWorldView().getAll(Player.class).values(), getLocation());
 	}
 	
 	/**
 	 * Retrieves nearest visible player to current agent location.
 	 * <p><p>
 	 * WARNING: O(n) complexity.
 	 * 
 	 * @return nearest visible player
 	 */
 	public Player getNearestVisiblePlayer() {
         if (getLocation() == null) return null;
 		return DistanceUtils.getNearestVisible(agent.getWorldView().getAll(Player.class).values(), getLocation());
 	}
 	
 	/*========================================================================*/
 	
 	/** Most rescent message containing info about the agent. */
 	Self self = null;
 	
 	/** How many suicides the bot commited. */
 	int suicides = 0;
 	
 	/** How many player we have killed so far. */
 	int kills = 0;
 	
 	/** Most rescent message containing info about the game frame. */
 	InitedMessage lastInitedMessage = null;
 
 	/** Most rescent message containing info about the volume the player is in. */
 	VolumeChanged lastVolumeChanged = null;
 	
 	/** Configuration of the bot inside UT2004. */
 	ConfigChange lastConfig = null;
 
 	/*========================================================================*/
 	
 	/**
 	 * {@link BotKilled} listener counting the number of suicides.
 	 */
 	private class BotKilledListener implements IWorldEventListener<BotKilled> {
 
 		public BotKilledListener(IWorldView worldView) {
 			worldView.addEventListener(BotKilled.class, this);
 		}
 		
 		@Override
 		public void notify(BotKilled event) {
 			if (self == null) return;
 			// TODO: [jimmy] is it correct?
 			if (event.getKiller() == null || event.getKiller().equals(getId())) {
 				++suicides;
 			}
 		}
 		
 	}
 	
 	/** {@link BotKilled} listener. */
 	BotKilledListener botKilledListener;
 	
 	/*========================================================================*/
 	
 	private class PlayerKilledListener implements IWorldEventListener<PlayerKilled> {
 
 		public PlayerKilledListener(IWorldView worldView) {
 			worldView.addEventListener(PlayerKilled.class, this);
 		}
 		
 		@Override
 		public void notify(PlayerKilled event) {
 			if (self == null) return;
 			if (event.getKiller() != null && event.getKiller().equals(getId())) {
 				++kills;
 			}		
 		}
 		
 	}
 	
 	/** {@link PlayerKilled} listener. */
 	PlayerKilledListener playerKilledListener;
 	
 	/*========================================================================*/
 
 	/**
 	 * InitedMessage listener.
 	 */
 	private class InitedMessageListener implements IWorldObjectEventListener<InitedMessage, WorldObjectUpdatedEvent<InitedMessage>>
 	{
 		@Override
 		public void notify(WorldObjectUpdatedEvent<InitedMessage> event)
 		{
 			lastInitedMessage = event.getObject();
 		}
 
 		/**
 		 * Constructor. Registers itself on the given WorldView object.
 		 * @param worldView WorldView object to listent to.
 		 */
 		public InitedMessageListener(IWorldView worldView)
 		{
 			worldView.addObjectListener(InitedMessage.class, WorldObjectUpdatedEvent.class, this);
 		}
 	}
 
 	/** InitedMessage listener */
 	private InitedMessageListener initedMessageListener;
 
 	/*========================================================================*/
 
 	/**
 	 * VolumeChanged listener.
 	 */
 	private class VolumeChangedListener implements IWorldEventListener<VolumeChanged>
 	{
 		@Override
 		public void notify(VolumeChanged event)
 		{
 			lastVolumeChanged = event;
 		}
 
 		/**
 		 * Constructor. Registers itself on the given WorldView object.
 		 * @param worldView WorldView object to listent to.
 		 */
 		public VolumeChangedListener(IWorldView worldView)
 		{
 			worldView.addEventListener(VolumeChanged.class, this);
 		}
 	}
 
 	/** VolumeChanged listener */
 	private VolumeChangedListener volumeChangedListener;
 
 	/*========================================================================*/
 
 	/**
 	 * {@link Self} listener.
 	 */
 	private class SelfListener implements IWorldObjectEventListener<Self, WorldObjectUpdatedEvent<Self>>
 	{
 		private IWorldView worldView;
 
 		/**
 		 * Constructor. Registers itself on the given WorldView object.
 		 * @param worldView WorldView object to listent to.
 		 */
 		public SelfListener(IWorldView worldView)
 		{
 			this.worldView = worldView;
 			worldView.addObjectListener(Self.class, WorldObjectUpdatedEvent.class, this);
 		}
 
 		@Override
 		public void notify(WorldObjectUpdatedEvent<Self> event) {
 			self = event.getObject();			
 		}
 	}
 
 	/** {@link Self} listener */
 	private SelfListener selfListener;
 
 
 	/*========================================================================*/
 	
 	/**
 	 * {@link ConfigChange} listener.
 	 */
 	private class ConfigChangeListener implements IWorldObjectEventListener<ConfigChange, IWorldObjectEvent<ConfigChange>>
 	{
 		private IWorldView worldView;
 
 		/**
 		 * Constructor. Registers itself on the given WorldView object.
 		 * @param worldView WorldView object to listent to.
 		 */
 		public ConfigChangeListener(IWorldView worldView)
 		{
 			worldView.addObjectListener(ConfigChange.class, WorldObjectUpdatedEvent.class, this);
 			this.worldView = worldView;
 		}
 
 		@Override
 		public void notify(IWorldObjectEvent<ConfigChange> event) {
 			lastConfig = event.getObject();			
 		}
 	}
 
 	/** {@link ConfigChange} listener */
 	private ConfigChangeListener configChangeListener;
 
 
 	/*========================================================================*/
 
 	public Self getSelf() {
 		return self;
 	}
 
 	/** Game memory module. */
 	public Game game;
 	
 	/**
 	 * Constructor. Setups the memory module based on bot's world view.
 	 * @param game game info module
 	 */
 	public AgentInfo(UT2004Bot bot) {
 		this(bot, new Game(bot), null);
 	}
 	
 	/**
 	 * Constructor. Setups the memory module based on bot's world view.
 	 * @param bot owner of the module
 	 * @param game game info module
 	 */
 	public AgentInfo(UT2004Bot bot, Game game) {
 		this(bot, game, null);
 	}
 
 	/**
 	 * Constructor. Setups the memory module based on bot's world view.
 	 * @param bot owner of the module
 	 * @param game game info module
 	 * @param log Logger to be used for logging runtime/debug info. Note: If <i>null</i> is provided,
 	 * this memory module creates it's own logger.
 	 */
 	public AgentInfo(UT2004Bot bot, Game game, Logger log)
 	{
 		super(bot, log);
 
 		this.game = game;
 		NullCheck.check(this.game, "game");
 		
 		// create listeners
 		selfListener          = new SelfListener(worldView);
 		initedMessageListener = new InitedMessageListener(worldView);	
 		volumeChangedListener = new VolumeChangedListener(worldView);
 		botKilledListener     = new BotKilledListener(worldView);
 		playerKilledListener  = new PlayerKilledListener(worldView);
 		configChangeListener  = new ConfigChangeListener(worldView);
 		
 		cleanUp();
 	}
 	
 	@Override
 	protected void cleanUp() {
 		super.cleanUp();
 		self = null;
 		suicides = 0;
 		kills = 0;
 		lastInitedMessage = null;
 		lastVolumeChanged = null;
 		lastConfig = null;
 	}
 
 }