# Target Monster Conditions
}

    Attribute definitions:

    afterSkill (<skill name>)
        Kore will use this combo slot right after the skill specified in this option was used. This attribute is required.

    dist [<number>]
        This option specifies the distance (in number of blocks) from the monster that Kore will move to before using this skill.

        Notes:

                * Common mistake: This is not a list, so specify only one number.
                * If this option is not set, Kore will use the distance you specified in attackDistance and attackMaxDistance.

    isSelfSkill [<boolean flag>]
        This option specifies whether the skill will be used on self or on the target monster. If this option is set to 1, Kore will use the skill on itself, otherwise if this is set to 0 (which is the default value), Kore will use the skill on the attack target.

        Note. You must set this option to the correct value. For example, if you're trying to use Combo Finish you have to set this flag to 1 or Combo Finish will fail because it cannot be used on a monster.

    maxUses [<number>]
        This option specifies the maximum number of successful usage allowed for this skill.

        Note: This attribute only counts successful usage. If a skill fails, Kore will continue to use the skill until it finally succeeds even if this option is set to 1. 

    waitBeforeUse [<seconds>]
        Kore will use the skill after the specified number of seconds has elapsed since the skill specified in afterSkill was used. This is crucial for some combos like the Monk Combo skills.

    autoCombo [<boolean flag>] v.1.9.0
        If this option is set to 1, Kore will automatically calculate the waitBeforeUse time for you.

    Attributes defined elsewhere:

        * (Skill Use Attributes) lvl, maxCastTime, minCastTime, equip

        * (Self Conditions) aggressives, defendMonsters, disabled, hp, inCart, inInventory, inLockOnly, monsters, notInTown, notMonsters, notOnAction, notInMap, notWhileSitting, onAction, inMap, partyAggressives, sp, spirit, stopWhenHit, timeout, whenFlag, whenFollowing, whenGround, whenIdle, whenNotFlag, whenNotGround, whenNotPermitSkill, whenPermitSkill, whenStatusActive, whenStatusInactive, whenWater

        * (Target Monster Conditions) target_deltaHp, target_dist, target_misses, target_timeout, target_totalMisses, target_whenGround, target_whenNotGround, target_whenShieldEquipped, target_whenStatusActive, target_whenStatusInactive, target_whenWeaponEquipped

    The following example shows how this option is used for Monk Combos:

    Example:

attackComboSlot Chain Combo {
	lvl 5
	dist 1.5
	sp > 30
	monsters
	notMonsters Red Plant,Green Plant,Blue Plant
	maxUses
	afterSkill Triple Attack
	waitBeforeUse 0.3
	isSelfSkill 1
}

    The example will make Kore use the Chain Combo Skill after it used Triple Attack.

attackSkillSlot [<skill name>]
    This option specifies the skill to automatically use when attacking.

    Syntax:

attackSkillSlot [<skill name>] {
	dist [<number>]
	isSelfSkill [<boolean flag>]
	maxAttempts [<number>]
	maxUses [<number>]
	previousDamage [<range>]

	# Skill Use Attributes
	# Self Conditions
	# Target Monster Conditions
}

    Attribute definitions:

    dist [<number>]
        This option specifies the distance (in number of blocks) from the monster that Kore will move to before using this skill.

        Notes:

                * Common mistake: This is not a list, so specify only one number.
                * If this option is not set, Kore will use the distance you specified in attackDistance and attackMaxDistance.

    isSelfSkill [<boolean flag>]
        This option specifies whether the skill will be used on self or on the target monster. If this option is set to 1, Kore will use the skill on itself, otherwise if this is set to 0 (which is the default value), Kore will use the skill on the attack target.

        Note. You must set this option to the correct value. For example, if you're trying to use Grand Cross you have to set this flag to 1 or you might see a target circle around your target monster as if you casted a skill on it, which is quite suspicious.

    maxAttempts [<number>]
        This option specifies the maximum number of attempts allowed to use this skill. Use this to limit usage of skills that could fail (e.g. Steal).

    maxUses [<number>]
        This option specifies the maximum number of successful usage allowed for this skill.

        Note: This attribute only counts successful usage. If a skill fails, Kore will continue to use the skill until it finally succeeds even if this option is set to 1. 

    previousDamage [<range>]
        If this option is set, the skill will only be used if the damage you have dealt to the monster is within the specified range.

    Attributes defined elsewhere:

        * (Skill Use Attributes) lvl, maxCastTime, minCastTime, equip

        * (Self Conditions) aggressives, defendMonsters, disabled, hp, inCart, inInventory, inLockOnly, monsters, notInTown, notMonsters, notOnAction, notInMap, notWhileSitting, onAction, inMap, partyAggressives, sp, spirit, stopWhenHit, timeout, whenFlag, whenFollowing, whenGround, whenIdle, whenNotFlag, whenNotGround, whenNotPermitSkill, whenPermitSkill, whenStatusActive, whenStatusInactive, whenWater

        * (Target Monster Conditions) target_deltaHp, target_dist, target_misses, target_timeout, target_totalMisses, target_whenGround, target_whenNotGround, target_whenShieldEquipped, target_whenStatusActive, target_whenStatusInactive, target_whenWeaponEquipped

    This is a simple example on how to use Holy Cross on monsters Khalitzburg, Raydric, Whisper, and Whisper Boss:

    Example:

attackSkillSlot Holy Cross {
	lvl 10
	dist 1.5
	sp > 30
	monsters Khalitzburg,Raydric,Whisper,Whisper Boss
}

autoBreakTime [<weekday>|all]
    Kore can automatically disconnect and reconnect at certain times of the day. This option allows you to specify on which days of the week will Kore automatically disconnect. This feature is useful if you want to automatically logout during server maintenance periods.

    Note. Only specify the first three letters of the weekday name (e.g. sun, mon, tue). You can alternatively specify "all", which means every day in the week. This is not case-sensitive.

    Syntax:

autoBreakTime [<weekday>|all] {
	startTime (<time>)
	stopTime [<time>]
}

    Attribute definitions:

    startTime (<time>)
        This option specifies the time (in 24-hour format) when Kore will automatically disconnect.

    stopTime [<time>]
        This option specifies the time (in 24-hour format) when Kore will reconnect after disconnecting.

    The following example will make Kore automatically disconnect at 9:29 P.M. on Sunday and resume botting at 1:08 A.M. on Monday:

    Example:

autoBreakTime Sun {
	startTime 21:29
	stopTime 01:08
}

    Notes:

            * You can only specify breaks of less than 24 hours.
            * You can add multiple break times by adding additional blocks.
            * AM/PM Format is not supported, you must use 24 Hr clock!

autoConfChange [<filenames>]
    Kore can automatically switch to another config.txt file when all conditions set in this block are met. This option specifies a comma-separated list of filenames that Kore will automatically switch to. A random file out of the specified list will be selected.

    Note. You can use a path that is relative to your main bot folder.

    Syntax:

autoConfChange [<filenames>] {
	minTime [<seconds>]
	varTime [<seconds>]
	lvl [<range>]
	joblvl [<range>]
	isJob [<job class>]
}

    Attribute definitions:

    minTime [<seconds>]
        If this option is set, Kore will automatically switch config files in time intervals not less than the specified number of seconds.

    varTime [<seconds>]
        If this option is set, the time interval between automatic config switches is randomized. The actual time interval will then be equal to the randomized value of varTime added to the value of minTime.

    lvl [<range>]
        If this option is set, only switch config file if you're within the specified level range.

    joblvl [<range>]
        If this option is set, only switch config file if you're within the specified job level range.

    isJob [<job class>]
        If this option is set, only switch config file if you're of the specified job class.

        Note. This is case-sensitive.

    In the following example, Kore will load the config file config_2.txt at a random time between 3600 seconds (1 hour) and 5400 seconds (1.5 hour), and when the character is currently a Thief class:

    Example:

autoConfChange control\config_2.txt {
	minTime 3600
	varTime 1800
	isJob Thief
}

autoSwitch [<monster names>]
    Kore can automatically switch weapons, shields and/or arrows when certain monsters are engaged. This option specifies a comma-separated list of monster names which, when encountered, will trigger the auto-switch.

    Syntax:

autoSwitch [<monster names>] {
	rightHand [<equipment name>]
	leftHand [<equipment name>]
	arrow [<arrow name>]
	distance [<number>]
	useWeapon [<boolean flag>]
}

    Attribute definitions:

    rightHand [<equipment name>]
        This option specifies the weapon to automatically equip in the right hand slot.

        Note. To attack with bare hands, specify [NONE].

    leftHand [<equipment name>]
        This option specifies the equipment (weapon or shield) to automatically equip in the left hand slot.

        Note. Leave this attribute blank if you are switching to a two-handed weapon.

    arrow [<arrow name>]
        If you're using a bow class weapon, this option specifies the arrows to use.

    distance [<number>]
        If this option is set, this will temporarily replace the value of attackDistance when auto-switch occurs. The original value is stored and will be reset when you encounter another monster not in the list specified in autoSwitch.

    useWeapon [<boolean flag>]
        If this option is set, this will temporarily replace the value of attackUseWeapon when auto-switch occurs. The original value is stored and will be reset when you encounter another monster not in the list specified in autoSwitch.

    Note. If you encounter a monster not listed in any of your autoSwitch blocks, Kore will equip the items specified in autoSwitch_default_rightHand, autoSwitch_default_leftHand, and autoSwitch_default_arrow if these options are set.

    The following example will make Kore switch weapon to a +7 Very Very Strong Ice Flamberge when it encounters a High Orc, and switch back to +8 Triple Bloody Saber when attacking other monsters:

    Example:

autoSwitch_default_rightHand +8 Saber [Hydra*3] [3]

autoSwitch High Orc {
	rightHand +7 VVS Ice Flamberge
}

buyAuto [<item name>]
    Kore can automatically buy an item from a buy/sell NPC when the amount of that certain item goes below a minimum value. This option specifies the item to automatically buy from a buy/sell NPC.

    Syntax:

buyAuto [<item name>] {
	maxAmount (<amount>)
	minAmount [<amount>]
	npc (<map name> <x> <y>)
	distance [<number>]
	standpoint [<map name> <x> <y>] bugged

	zeny [<amount>] v.1.9.0

	# Self Conditions v.1.9.0
}

    Attribute definitions:

    maxAmount (<amount>)
        This option specifies the maximum amount of item in inventory that you need. Kore will buy an amount equal to the difference between the specified maximum amount and the current amount in inventory.

    minAmount [<amount>]
        If this option is set, this specifies the minimum amount of item in inventory before the auto-buy sequence is automatically triggered. Kore will go to the NPC when the number of the specified items left in inventory is less than or equal to this amount.

        Tip. If you don't want Kore to automatically go back to town to buy this item, but you DO want Kore to buy this item when it's in town for another reason, then leave minAmount empty. See example below.

        Note. Once Kore is in auto-buy sequence, Kore will automatically check the rest of the buyAuto blocks if you need to buy the items specified in those blocks.

    npc (<map name> <x> <y>)
        This option specifies the location of a buy/sell NPC that sells the item. This NPC must have the item available for purchase.

    distance (<number>)
        This option specifies how far Kore will stand from the item buy/sell NPC during auto-buy.

    standpoint [<map name> <x> <y>] bugged in v.1.6.4
        If this option is set, Kore will stand on the specified location when buying this item instead of anywhere near the item buy/sell NPC itself. The attribute distance will be ignored.

        Note. This is bugged in v.1.6.4 so don't use this. Fixed in v.1.9.0.

    zeny [<range>] v.1.9.0
        If this option is set, the item will only be bought if your zeny is within the specified range.

    Attributes defined elsewhere:

        * (Self Conditions v.1.9.0) aggressives, defendMonsters, disabled, hp, inCart, inInventory, inLockOnly, monsters, notInTown, notMonsters, notOnAction, notInMap, notWhileSitting, onAction, inMap, partyAggressives, sp, spirit, stopWhenHit, timeout, whenFlag, whenFollowing, whenGround, whenIdle, whenNotFlag, whenNotGround, whenNotPermitSkill, whenPermitSkill, whenStatusActive, whenStatusInactive, whenWater

    If you use many types of pots, it might only be worth going back to town when you've depleted your Orange Potions. The following example will make Kore go to town to buy pots when there are no more Orange Potions in your inventory. Notice that the minAmount is left empty for the Red Potion block.

    Example:

buyAuto Red Potion {
	maxAmount 100
	minAmount
	npc morocc 147 102
	distance 8
}
buyAuto Orange Potion {
	maxAmount 70
	minAmount 0
	npc morocc 147 102
	distance 8
}

equipAuto [<equipment name>]
    Kore can automatically equip items when certain conditions are met. This option allows you to specify an equipment to automatically equip when all the conditions are met.

    Notes (v.1.9.0): The equipment name specified in equipAuto is not used anymore. Use the <equip slot> attribute instead to specify a set of equipments to automatically equip on different equipment slots.

    Syntax:

equipAuto [<equipment name>] {
	def [<equipment name>] v.1.6.4 only
	misses [<range>] v.1.6.4 only
	onTeleport [<boolean flag>] v.1.6.4 only
	skills [<skill names>] v.1.6.4 only
	totalMisses [<range>] v.1.6.4 only
	weight [<percent>]
	whileSitting [<boolean flag>]

	(<equip slot>) [<equipment name>] v.1.9.0
	target [<monster names>] v.1.9.0

	# Self Conditions
	# Target Monster Conditions v.1.9.0
}

    Attribute definitions:

    def [<equipment name>] v.1.6.4 only
        This option specifies the default equipment to automatically equip after the equipment specified in equipAuto was equipped and the conditions in this block is no longer met.

        Note (v.1.9.0). This option is removed in v.1.9.0. See also attackEquip for equipping default weapons when attacking with weapons.

    misses [<range>] v.1.6.4 only
        If this option is set, auto-equip only if the number of times you consecutively missed your target is within the specified range.

        Note (v.1.9.0). This option is renamed in v.1.9.0. Use the shared target miss condition target_misses instead.

    onTeleport [<boolean flag>] v.1.6.4 only
        If this option is set to 1, auto-equip when attempting to teleport.

        Note (v.1.9.0). This option is removed in v.1.9.0. Use teleportAuto_equip instead.

    skills [<skill names>] v.1.6.4 only
        If this option is set, auto-equip when attempting to use any of the specified comma-separated list of skills.

        Note (v.1.9.0). This option is removed in v.1.9.0. Use the shared skill block attribute equip instead.

    totalMisses [<range>] v.1.6.4 only
        If this option is set, auto-equip only if the total number of times you missed your target is within the specified range.

        Note (v.1.9.0). This option is renamed in v.1.9.0. Use the shared target miss condition target_totalMisses instead.

    weight [<percent>]
        If this option is set, auto-equip only when weight is at or above the specified percent.

    whileSitting [<boolean flag>]
        If this option is set, auto-equip while Kore is sitting.

    (<equip slot>) [<equipment name>] v.1.9.0
        If this option is set for a specific equipment slot, Kore will automatically equip the specified equipment on the corresponding equipment slot when all conditions for this block are met.

        For example, if you want to automatically equip a +4 Shoes of Health and a Robust Clip when you are sitting to regenerate hp, use the following configuration:

        Example:

equipAuto - {
	shoes +4 Shoes [Zombie] [1]
	leftAccessory Clip [Muka] [1]
	onAction sitAuto
	whileSitting 1
}

        Note. See the references section for the list of equipment slots.

    target [<monster names>] v.1.9.0
        If this option is set, auto-equip when you are attacking any of the specified comma-separated list of monsters. Use this attribute if you want equipAuto to function like autoSwitch.

    Attributes defined elsewhere:

        * (Self Conditions) aggressives, defendMonsters, disabled, hp, inCart, inInventory, inLockOnly, monsters, notInTown, notMonsters, notOnAction, notInMap, notWhileSitting, onAction, inMap, partyAggressives, sp, spirit, stopWhenHit, timeout, whenFlag, whenFollowing, whenGround, whenIdle, whenNotFlag, whenNotGround, whenNotPermitSkill, whenPermitSkill, whenStatusActive, whenStatusInactive, whenWater

        * (Target Monster Conditions v.1.9.0) target_deltaHp, target_dist, target_misses, target_timeout, target_totalMisses, target_whenGround, target_whenNotGround, target_whenShieldEquipped, target_whenStatusActive, target_whenStatusInactive, target_whenWeaponEquipped

    The following example will make you automatically switch to a Healing Clip when you are attempting to use the Heal skill, and switch to a Teleport Clip if you are to use the Teleport skill. By default, you will be equipping your Nimble Glove:

    Example (v.1.6.4):

useSelf_skill Heal {
	lvl 1
	hp < 80
	sp > 20
	inLockOnly 1
	notWhileSitting 0
	timeout 2
	disabled 0
}
equipAuto Clip [Vitata] [1] {
	def Glove [Zerom] [1]
	skills Heal
	whileSitting 0
	disabled 0
}
equipAuto Clip [Creamy] [1] {
	def Glove [Zerom] [1]
	onTeleport 1
	disabled 0
}

    This is the corresponding example if you are using v.1.9.0:

    Example (v.1.9.0):

attackEquip_leftAccessory Glove [Zerom] [1]
teleportAuto_equip_leftAccessory Clip [Creamy] [1]

useSelf_skill Heal {
	lvl 1
	hp < 80
	sp > 20
	inLockOnly 1
	notWhileSitting 0
	timeout 2
	disabled 0
	equip_leftAccessory Clip [Vitata] [1]
}

    Bug Note (v.1.9.0): If you configured Kore to auto-equip items before using the Heal skill, you must disable useSelf_skill_smartHeal or the auto-equip will not work. This is fixed in CVS.

getAuto [<item name>]
    Kore can automatically get items from storage when the amount of that certain item goes below a minimum value. This option specifies the item to automatically get from the Kafra storage.

    Note. The location of the Kafra NPC is defined in storageAuto_npc.

    Syntax:

getAuto [<item name>] {
	minAmount [<amount>]
	maxAmount [<amount>]
	passive [<boolean flag>]

	dcOnEmpty [<boolean flag>] v.1.9.0
}

    Attribute definitions:

    maxAmount (<amount>)
        This option specifies the maximum amount of item in inventory that you need. Kore will get an amount equal to the difference between the specified maximum amount and the current amount in inventory.

    minAmount [<amount>]
        If this option is set, this specifies the minimum amount of item in inventory before the auto-get sequence is automatically triggered. Kore will go to the NPC when the number of the specified items left in inventory is less than or equal to this amount.

    passive [<boolean flag>]
        By default, auto-get will be initiated once the amount of that item specified in this block reaches minAmount. Set this option to 1 if you want to get items only during auto-storage.

    dcOnEmpty [<boolean flag>] v.1.9.0
        If this option is set to 1, disconnect if there are no more items to get from storage.

    The following example will make you get White Potions from storage when there are no more whites in your inventory:

    Example:

storageAuto 1
storageAuto_npc geffen 120 62
storageAuto_distance 6
storageAuto_npc_type 1

getAuto White Potion {
	minAmount 0
	maxAmount 100
	passive 0
}

monsterSkill [<skill name>]
    Kore can use skills on monsters even if it is not currently attacking them. This option specifies the skill to automatically use on monsters as long as you are not currently using any other skill.

    This is useful for fighting multiple opponents at once. For example, an Acolyte can offensive-Bless Khalitzburg even if it's not your current target, or a Knight can Provoke all Sohees and then Brandish Spear them.

    Syntax:

monsterSkill [<skill name>] {
	target [<monster names>]

	# Skill Use Attributes
	# Self Conditions
	# Target Monster Conditions
}

    Attribute definitions:

    maxUses [<number>]
        This option specifies the maximum number of successful usage allowed for this skill.

        Note: This attribute only counts successful usage. If a skill fails, Kore will continue to use the skill until it finally succeeds even if this option is set to 1. 

    target (<monster names>)
        This option specifies on which monsters will this skill be used.

        Note. This option is required. If you don't set this option, the skill will never be used.

    Attributes defined elsewhere:

        * (Skill Use Attributes) lvl, maxCastTime, minCastTime, equip

        * (Self Conditions) aggressives, defendMonsters, disabled, hp, inCart, inInventory, inLockOnly, monsters, notInTown, notMonsters, notOnAction, notInMap, notWhileSitting, onAction, inMap, partyAggressives, sp, spirit, stopWhenHit, timeout, whenFlag, whenFollowing, whenGround, whenIdle, whenNotFlag, whenNotGround, whenNotPermitSkill, whenPermitSkill, whenStatusActive, whenStatusInactive, whenWater

        * (Target Monster Conditions) target_deltaHp, target_dist, target_misses, target_timeout, target_totalMisses, target_whenGround, target_whenNotGround, target_whenShieldEquipped, target_whenStatusActive, target_whenStatusInactive, target_whenWeaponEquipped

    The following example will make Kore use Provoke on Sohees until there are more than five monsters attacking you. It will then use Brandish Spear to kill them all at once:

    Example:

monsterSkill Provoke {
	lvl 1
	sp > 15
	aggressives < 5
	maxUses 1
	target Sohee
	target_dist 7
}
attackSkillSlot Brandish Spear {
	lvl 10
	dist 1.5
	sp > 20
	aggressives >= 5
	monsters Sohee
}

partySkill [<skill name>]
    Kore can automatically use skills on players. This option specifies the skill to automatically use on players as long as you are not currently using any other skill.

    Syntax:

partySkill [<skill name>] {
	notPartyOnly [<boolean flag>]
	target [<player names>]

	isSelfSkill [<boolean flag>] v.1.9.0

	# Skill Use Attributes
	# Self Conditions
	# Target Player Conditions
}

    Attribute definitions:

    notPartyOnly [<boolean flag>]
        By default, Kore will only use party skills on members of your party. If this option is set to 1, Kore will also be allowed to use this on non-party members.

    target [<player names>]
        If this option is set, Kore will only use the specified skill on the specified comma-separated list of players/party members. If this option is left blank, Kore will use the skill on all players/party members.

    isSelfSkill [<boolean flag>] v.1.9.0
        This option specifies whether the skill will be used on self or on the target monster. If this option is set to 1, Kore will use the skill on itself, otherwise if this is set to 0 (which is the default value), Kore will use the skill on the attack target.

        Note. You must set this option to the correct value. Useful for Magnificat or Gloria.

    Attributes defined elsewhere:

        * (Skill Use Attributes) lvl, maxCastTime, minCastTime, equip

        * (Self Conditions) aggressives, defendMonsters, disabled, hp, inCart, inInventory, inLockOnly, monsters, notInTown, notMonsters, notOnAction, notInMap, notWhileSitting, onAction, inMap, partyAggressives, sp, spirit, stopWhenHit, timeout, whenFlag, whenFollowing, whenGround, whenIdle, whenNotFlag, whenNotGround, whenNotPermitSkill, whenPermitSkill, whenStatusActive, whenStatusInactive, whenWater

        * (Target Player Conditions) target_aggressives, target_dead, target_defendMonsters, target_deltaHp, target_dist, target_hp, target_isGuild, target_isJob, target_isNotJob, target_monsters, target_notWhileSitting, target_timeout, target_whenGround, target_whenNotGround, target_whenShieldEquipped, target_whenStatusActive, target_whenStatusInactive, target_whenWeaponEquipped

    The following example is a simple way of how to use Blessing on your party mates:

    Example:

partySkill Blessing {
 	lvl 10
 	sp > 20
 	stopWhenHit 1
 	inLockOnly 1
 	notWhileSitting 1
 	notInTown 1
 	target
 	target_whenStatusInactive Blessing
 	target_timeout 240
}

useSelf_item [<item names>]
    Kore can automatically use items when certain conditions are met. This option specifies a comma-separated list of items that will automatically be used on self.

    Note. Only one of the listed items will be used, i.e. the first in the list that exists in inventory.

    Syntax:

useSelf_item [<item names>] {
	dcOnEmpty [<boolean flag>]

	# Self Conditions
}

    Attribute definitions:

    dcOnEmpty [<boolean flag>]
        If this option is set to 1, disconnect if there are no more items in inventory to use.

    Attributes defined elsewhere:

        * (Self Conditions) aggressives, defendMonsters, disabled, hp, inCart, inInventory, inLockOnly, monsters, notInTown, notMonsters, notOnAction, notInMap, notWhileSitting, onAction, inMap, partyAggressives, sp, spirit, stopWhenHit, timeout, whenFlag, whenFollowing, whenGround, whenIdle, whenNotFlag, whenNotGround, whenNotPermitSkill, whenPermitSkill, whenStatusActive, whenStatusInactive, whenWater

    The following example will make Kore use a Concentration Potion every time the speed status wears out:

    Example:

useSelf_item Concentration Potion {
	whenStatusInactive Concentration Potion
	inLockOnly 1
	notWhileSitting 1
	timeout 3
}

useSelf_skill [<skill name>]
    Kore can automatically use skills on self when certain conditions are met. This block specifies the skill to automatically use on self.

    Syntax:

useSelf_skill [<skill name>] {
	smartEncore [<boolean flag>]

	# Skill Use Attributes
	# Self Conditions
}

    Attribute definitions:

    smartEncore [<boolean flag>]
        If this option is set to 1, Kore will use the Encore skill instead of this skill if Encore would cause this skill to be cast (saves SP for bards and dancers).

    Attributes defined elsewhere:

        * (Skill Use Attributes) lvl, maxCastTime, minCastTime, equip

        * (Self Conditions) aggressives, defendMonsters, disabled, hp, inCart, inInventory, inLockOnly, monsters, notInTown, notMonsters, notOnAction, notInMap, notWhileSitting, onAction, inMap, partyAggressives, sp, spirit, stopWhenHit, timeout, whenFlag, whenFollowing, whenGround, whenIdle, whenNotFlag, whenNotGround, whenNotPermitSkill, whenPermitSkill, whenStatusActive, whenStatusInactive, whenWater

    The following example will make Kore use the Crazy Uproar Skill when the skill status is no longer active:

    Example:

useSelf_skill Crazy Uproar {
	lvl 1
	sp > 8
	whenStatusInactive Crazy Uproar
	inLockOnly 1
	notWhileSitting 1
	timeout 3
}

Shared Block Attributes

Skill Use Attributes
    These options are shared between the attackComboSlot, attackSkillSlot, monsterSkill, partySkill, and useSelf_skill configuration blocks.

    Attribute definitions:

    lvl [<level>]
        This option sets the skill level to use for the skill block. This option is required.

    maxCastTime [<seconds>]
        If this option is set, Kore will wait for at most the specified number of seconds for the spell to finish casting before continuing AI functions.

        Note. This is just a maximum. If Kore sees that the spell has finished then AI will resume.

    minCastTime [<seconds>]
        If this option is set, Kore will wait for at least the specified number of seconds before continuing AI functions.

        Note. This is just a minimum. If Kore sees that the spell has not yet finished then AI will not resume.

    equip_(<equip slot>) [<equipment name>] v.1.9.0
        If this option is set for a specific equipment slot, Kore will automatically equip the specified equipment on the corresponding equipment slot when attempting to use the skill.

        For example, if you want to automatically equip a Healing Clip when you attempt to use Heal, use the following configuration:

        Example:

useSelf_skill Heal {
	lvl 10
	sp > 5%
	notWhileSitting 1
	equip_rightAccessory Clip [Vitata] [1]
}

        Note. See the references section for the list of equipment slots.

        Bug Note (v.1.9.0): If you configured Kore to auto-equip items before using the Heal skill, you must disable useSelf_skill_smartHeal or the auto-equip will not work. This is fixed in CVS.

Self Conditions
    These condition options are shared between the attackComboSlot, attackSkillSlot, buyAuto, equipAuto, monsterSkill, partySkill, useSelf_item, and useSelf_skill configuration blocks.

    Attribute definitions:

    aggressives [<range>]
        If this option is set, the block will only be used if the number of monsters who has hit or missed you is within the specified range.

    defendMonsters [<monster names>]
        If this option is set, the block will only be used if you are the current target of the attacks of any of the specified comma-separated list of monsters.

    disabled [<boolean flag>]
        Set this option to 1 to temporarily disable the block completely.

    hp [<range>[%]]

        Syntax 	Description
        hp <range> 	If this option is set, the block will only be used if the percent HP is within the specified range.
        v.1.9.0 If this option is set, the block will only be used if the absolute amount of HP is within the specified range.
        hp <range>% v.1.9.0 	If this option is set, the block will only be used if the percent HP is within the specified range.

        Example (v.1.9.0):

        For example, if you have 4000 maximum HP and you want to use the block if you have less than 800 HP left, use the setting:

        Example:

hp < 800

        Alternatively, the following example will have the same effect, because 800 HP is 20% of 4000 HP:

        Example:

hp < 20%

    inCart [<item name> <range>] v.1.9.0
        If this option is set, the block will only be used if the amount of each of the specified list of items in cart are within the corresponding specified ranges. The value could be a comma-separated list of (<item name> <range>) pairs:

        Syntax:

<item> <range>[,<item1> <range1>[, ...]]

    inInventory [<item name> <range>]
        If this option is set, the block will only be used if the amount of each of the specified list of items in inventory are within the corresponding specified ranges. The value could be a comma-separated list of (<item name> <range>) pairs:

        Syntax:

<item> <range>[,<item1> <range1>[, ...]]

        The following example will allow you to create Holy Water using the Aqua Benedicta skill if you are currently standing on water and you have Empty Bottles in your inventory.

        Example:

useSelf_skill Aqua Benedicta {
	lvl 1
	notWhileSitting 1
	inInventory Empty Bottle > 0
	disabled 0
}

    inLockOnly [<boolean flag>]
        Set this option to 1 if you want to use the block only when Kore is inside the specified lockMap.

    inMap [<map names>] v.1.9.0
        If this option is set, the block will only be used if you are inside one of the specified comma-separated list of maps.

    monsters [<monster names>]
        If this option is set in an attackSkillSlot or attackComboSlot block, the block will only be used if you are attacking any one of the specified comma-separated list of monsters.

        If this option is set on other blocks, the block will only be used if any one of the specified comma-separated list of monsters is attacking you.

    notInMap [<map names>] v.1.9.0
        If this option is set, the block will never be used if you are inside one of the specified comma-separated list of maps.

    notInTown [<boolean flag>]
        Set this option to 1 if you don't want to use the block while in town.

    notMonsters [<monster names>]
        If this option is set in an attackSkillSlot or attackComboSlot block, the block will not be used if you are attacking any one of the specified comma-separated list of monsters.

        If this option is set on other blocks, the block will not be used if any one of the specified comma-separated list of monsters is attacking you.

    notOnAction [<AI sequences>] v.1.9.0
        If this option is set, the block will only be used if none of the specified comma-separated list of AI sequences is curently active. See onAction for a list of known AI actions.

    notWhileSitting [<boolean flag>]
        Set this option to 1 if you don't want to use the block while sitting.

    onAction [<AI sequences>]
        If this option is set, the block will only be used if at least one of the specified comma-separated list of AI sequences is curently active. There are around 29 known AI sequences, but the following are the only ones you can use in this option:

        AI sequence 	Block Options Supported
        attack 	attackComboSlot, attackSkillSlot, useSelf_item, useSelf_skill, partySkill, monsterSkill, equipAuto
        follow 	buyAuto, useSelf_item, useSelf_skill, partySkill, monsterSkill, equipAuto
        items_gather 	useSelf_item, useSelf_skill, partySkill, monsterSkill, equipAuto
        items_take 	useSelf_item, useSelf_skill, partySkill, monsterSkill, equipAuto
        mapRoute 	useSelf_item, useSelf_skill, partySkill, monsterSkill, equipAuto
        move 	partySkill, monsterSkill
        route 	buyAuto, useSelf_item, useSelf_skill, partySkill, monsterSkill, equipAuto
        sitAuto 	useSelf_item, useSelf_skill, partySkill, monsterSkill, equipAuto
        skill_use 	useSelf_item, useSelf_skill, equipAuto
        take 	useSelf_item, useSelf_skill, partySkill, monsterSkill, equipAuto

    partyAggressives [<range>]
        If this option is set, the block will only be used if the number of monsters who has hit or missed you and your party members is within the specified range.

    sp [<range>[%]]

        Syntax 	Description
        sp <range> 	If this option is set, the block will only be used if the percent SP is within the specified range.
        v.1.9.0 If this option is set, the block will only be used if the absolute amount of SP is within the specified range.
        sp <range>% v.1.9.0 	If this option is set, the block will only be used if the percent SP is within the specified range.

        Example (v.1.9.0):

        For example, if you have 600 maximum SP and you want to use the block if you have more than 60 SP left, use the setting:

        Example:

sp > 60

        Alternatively, the following example will have the same effect, because 60 SP is 10% of 600 SP:

        Example:

sp > 10%

    spirit [<range>]
        If this option is set, the block will only be used if the number of summoned spirit spheres (for Monks) is within the specified range.

    stopWhenHit [<boolean flag>]
        Set this option to 1 if you don't want to use the block when you are the target of monster's attacks.

    timeout [<seconds>]
        If this option is set, wait for the specified number of seconds before using the block again.

        Note. Usually, this is used to prevent Kore from spamming block usage when there's lag.

    whenEquipped [<equipment name>] in CVS
        If this option is set, the block will only be used if the specified equipment is currently equipped.

    whenFlag [<name>] v.1.9.0
        If this option is set, the block will only be used if a member of the %flags hash with the specified name is set. This is useful to enable or disable a group of block options easily.

        Note. Currently, only plugins or the eval console command could change %flags so this is only useful to developers.

    whenFollowing [<boolean flag>]
        Set this option to 1 if you want to use the block only when Kore is following someone.

    whenGround [<ground spells>]
        If this option is set, the block will only be used when any one of the specified comma-separated list of spells is currently active on the ground you're standing on.

        Note. Ground types can be found by using the console command spells while certain spells are active on the ground. You can also look for them in the tables folder, in the file spells.txt.

    whenIdle [<boolean flag>]
        Set this option to 1 if you want to use the block only when Kore is doing nothing.

    whenNotFlag [<name>] v.1.9.0
        If this option is set, the block will only be used if a member of the %flags hash with the specified name is not set. This is useful to enable or disable a group of block options easily.

        Note. Currently, only plugins or the eval console command could change %flags so this is only useful to developers.

    whenNotGround [<ground spells>]
        If this option is set, the block will only be used when none of the specified comma-separated list of spells is currently active on the ground you're standing on.

        Note. Ground types can be found by using the console command spells while certain spells are active on the ground. You can also look for them in the tables folder, in the file spells.txt.

    whenNotPermitSkill [<skill name>]
        If this option is set, the block will only be used when you have not been granted use of the specified temporary skill.

    whenPermitSkill [<skill name>]
        If this option is set, the block will only be used when you have been granted use of the specified temporary skill.

    whenStatusActive [<status names>]
        If this option is set, the block will only be used if at least one of the specified comma-separated list of status names is currently active.

        Note. Statuses can be found by typing s in the console while the status is active. You can also look for them in the tables folder, in the files skillsailments.txt, skillslooks.txt, skillsstate.txt, and skillsstatus.txt.

    whenStatusInactive [<status names>]
        If this option is set, the block will only be used if none of the specified comma-separated list of status names is currently active.

        Note. Statuses can be found by typing s in the console while the status is active. You can also look for them in the tables folder, in the files skillsailments.txt, skillslooks.txt, skillsstate.txt, and skillsstatus.txt.

    whenWater [<boolean flag>]
        This option is not yet working. Specifying this option will disable your configuration block completely. 

Target Monster Conditions
    These condition attributes are shared between the attackComboSlot, attackSkillSlot, equipAuto, and monsterSkill configuration blocks.

    Attribute definitions:

    target_deltaHp [<range>]
        If this option is set, the block will only be used if the target's deltaHp is within the specified range.

        Notes:

                * Kore tracks changes in HP for each player/monster on screen as deltaHp. It initially starts at 0. When a player/monster takes damage, the damage is subtracted from its deltaHp. When healed, the amount of HP healed is added to the deltaHp. If the deltaHp becomes positive, it is reset to 0 (thus, deltaHp is always a negative value).
                * The monster's deltaHp can be used to intelligently choose the appropriate level for attack skills.

    target_dist [<range>]
        If this option is set, the block will only be used if the distance of the target is within the specified range.

    target_misses [<range>]
        If this option is set, the skill will only be used if the number of times you consecutively missed your target is within the specified range.

    target_timeout [<seconds>]
        If this option is set, Kore will wait for this number of seconds before using this skill on a monster again. This is different from timeout because the timeout is stored for each monster/player.

    target_totalMisses [<range>]
        If this option is set, the skill will only be used if the total number of times you missed your target is within the specified range.

    target_whenGround [<ground spells>]
        If this option is set, the block will only be used when any one of the specified comma-separated list of spells is currently active on the ground your target is standing on. See also whenGround.

    target_whenNotGround [<ground spells>]
        If this option is set, the block will only be used when none of the specified comma-separated list of spells is currently active on the ground your target is standing on. See also whenNotGround.

    target_whenShieldEquipped [<boolean flag>]
        If this option is set to 1, the block will only be used if the target has a shield equipped.

        Note. This option is useful only if your target is a player.

    target_whenStatusActive [<status names>]
        If this option is set, the block will only be used if at least one of the specified comma-separated list of status names is currently active on your target.

        Note. Currently, known statuses for monsters/players are lost when they leave your screen, so target_timeout may be more appropriate. See also whenStatusActive.

    target_whenStatusInactive [<status names>]
        If this option is set, the block will only be used if none of the specified comma-separated list of status names is currently active on your target.

        Note. Currently, known statuses for monsters/players are lost when they leave your screen, so target_timeout may be more appropriate. See also whenStatusInactive.

    target_whenWeaponEquipped [<boolean flag>]
        If this option is set to 1, the block will only be used if the target has a weapon equipped.

        Note. This option is useful only if your target is a player.

Target Player Conditions
    Currently, only the partySkill configuration block uses these conditions.

    Attribute definitions:

    target_aggressives [<range>]
        If this option is set, the skill will only be used if the amount of monsters who has hit or missed the target player is within the specified range.

    target_dead [<boolean flag>]
        If this option is set to 1, use the skill only if the target is dead. This is useful for setting Kore to ressurrect dead players.

    target_defendMonsters [<monster names>]
        If this option is set, the skill will only be used if the player is the current target of the attacks of any of the specified comma-separated list of monsters.

    target_deltaHp [<range>]
        If this option is set, the block will only be used if the target's deltaHp is within the specified range.

        Notes:

                * Kore tracks changes in HP for each player/monster on screen as deltaHp. It initially starts at 0. When a player/monster takes damage, the damage is subtracted from its deltaHp. When healed, the amount of HP healed is added to the deltaHp. If the deltaHp becomes positive, it is reset to 0 (thus, deltaHp is always a negative value).
                * A player with a lot of negative deltaHp is probably in need of healing. This allows you to intelligently heal non-party members.

    target_dist [<range>] v.1.9.0
        If this option is set, the block will only be used if the distance of the target is within the specified range.

    target_hp [<range>[%]]

        Syntax 	Description
        target_hp <range> 	If this option is set, the block will only be used if the player's percent HP is within the specified range.
        v.1.9.0 If this option is set, the block will only be used if the player's absolute amount of HP is within the specified range.
        target_hp <range>% v.1.9.0 	If this option is set, the block will only be used if the player's percent HP is within the specified range.

        Note. See the shared self condition hp for related examples.

    target_isGuild [<guild names>]
        If this option is set, use the skill only if the target is a member of one of the specified comma-separated list of guild names.

    target_isJob [<job classes>]
        If this option is set, the skill will only be used if the target player is one of the specified comma-separated list of jobs.

    target_isNotJob [<job classes>]
        If this option is set, the skill will only be used if the target player is not one of the specified comma-separated list of jobs.

    target_monsters [<monster names>]
        If this option is set, the skill will only be used if the any one of the specified comma-separated list of monsters has hit or missed the target player.

    target_notWhileSitting [<boolean flag>]
        Set this option to 1 if you don't want to use the skill if the target player is sitting.

    target_timeout [<seconds>]
        If this option is set, Kore will wait for this number of seconds before using this skill on a monster again. This is different from timeout because the timeout is stored for each player.

    target_whenGround [<ground spells>]
        If this option is set, the block will only be used when any one of the specified comma-separated list of spells is currently active on the ground your target is standing on. See also whenGround.

    target_whenNotGround [<ground spells>]
        If this option is set, the block will only be used when none of the specified comma-separated list of spells is currently active on the ground your target is standing on. See also whenNotGround.

    target_whenShieldEquipped [<boolean flag>]
        If this option is set to 1, the block will only be used if the target has a shield equipped.

    target_whenStatusActive [<status names>]
        If this option is set, the block will only be used if at least one of the specified comma-separated list of status names is currently active on your target.

        Note. Currently, known statuses for players are lost when they leave your screen, so target_timeout may be more appropriate. See also whenStatusActive.

    target_whenStatusInactive [<status names>]
        If this option is set, the block will only be used if none of the specified comma-separated list of status names is currently active on your target.

        Note. Currently, known statuses for players are lost when they leave your screen, so target_timeout may be more appropriate. See also whenStatusInactive.

    target_whenWeaponEquipped [<boolean flag>]
        If this option is set to 1, the block will only be used if the target has a weapon equipped.

Last modified: Fri Jan 27, 2006 6:28 am [AD] [AD]