config.txt

The file config.txt is the main configuration file. It is where you configure most of Kore's behavior.

Entries in this file follows two distict formats, the key-value and the block format. The key-value format is outright simple. Each line contains a configuration key as the first word, followed by the value:

Syntax:

<config key> <value>

The block format, on the other hand, follows the similar concept, but additional attributes enclosed in curly brackets "{ }" extend the block config option's meaning:

Syntax:

<config key> <value> {
	<attribute1> <value1>
	<attribute2> <value2>
}

Details

<config key>: This is one of the configuration variable names used by Kore. See the configuration list below for a list of available config variables.
<value>: This sets the value for the corresponding configuration variable that will be used by Kore. The type of meaningful values vary with each configuration key. The proper values for each config keys are described in the configuration list below.
<attribute>: These are basically the same as config keys but they are only used inside configuration blocks. These attributes define properties for the current block, as well as the conditions when the block will be used.

Note. Lines that begin with the pound sign (#) are comment lines. They are ignored by Openkore. You can also make blocks of comments by enclosing multiple lines inside /* and */.

Other Notes

Most of the configuration settings in this file are optional. Unless otherwise specified below, you can either leave the value empty or delete the whole entry, in which case either the default value will be used (e.g disabled for boolean flags) or the option will be completely ignored.

Each unique configuration key in key-value lines must appear only once inside this file (except for !include). When multiple lines have the same config key, that configuration option takes the value set in the line that appears last.

In contrast, you can specify an unlimited number of blocks with the same configuration key name. However, not all blocks defined for a certain configuration key will always be used by Kore. When Kore is ready to use a certain type of block configuration, Kore checks each defined block from top to bottom and stops when it finds a block whose defined attributes or conditions are met. Therefore, place the more important block options on top and the lower priority ones, below.

Configuration options that follow the block format are marked in the list below with block.

Configuration List

!include [<filename>]

Use this option to include different files as part of config.txt. That makes it easier to reuse configurations.

Note. You can use a path that is relative to config.txt.

Example:

!include account.txt
!include skills/hunterselfskills.txt

In the example above, if your config.txt is placed in the folder is "C:\Openkore\control", the files "C:\Openkore\control\account.txt" and "C:\Openkore\control\skills\hunterselfskills.txt" will be included as part of your configuration.

Known Limitation. Multiple block configurations are screwed if you specify blocks of the same type (say, attackSkillSlot) inside different files. While this is not yet fixed, it is recommended to place each type of configuration blocks in one file only.

adminPassword [<password>]: This option specifies the password required to for a player to gain authorization for using chat commands on Kore. If this password is sent via private message to Kore, the sender will become an admin and be authorized to command Kore using chat messages.
Note. If this option is left blank, Kore will automatically generate a random password for security reasons.

alias_(<alias name>) [<command>]

This option allows you to set up custom command names or aliases for faster console command issuing.

Example:

alias_fullheal ss 28 10
alias_laagg c laaaagggggg

In the example above, typing "laagg" in the console has the same effect of typing "c laaaagggggg".

Note. You can specify multiple aliases as long as each alias names are unique.

allowedMaps [<map names>]
allowedMaps_reaction [<flag>]

You can set Kore to only allow itself to enter certain maps. If the option allowedMaps is set and Kore found itself in a map other than those specified in this comma-separated list of map names, Kore will either respawn or exit.

The option allowedMaps_reaction specifies how you will react on such event.

Value	Description
0	Respawn.
1	Exit.

attackAuto [<flag>]

This option sets whether Kore will automatically attack monsters or not.

Value	Description
0	Do not attack any monster.
1	Do not automatically attack monsters, but retaliate when a monster attacks you.
2	Automatically attack non-aggressive monsters.

attackAuto_followTarget [<boolean flag>]

If Kore is following a player and this option is set to 1, Kore will attack monsters that are engaged by its followTarget.

Notes:

This option works independently from attackAuto, thus if this option is enabled, you will attack monsters engaged by the follow target regardless of how attackAuto is set.
Kore will only attack monsters engaged by the follow target if there are no other aggressive monsters attacking Kore itself. If you want to give priority on monsters engaged by the follow target, set attackAuto to 0.

attackAuto_inLockOnly [<flag>]

This option sets whether auto-attack will be disabled outside the lockMap.

Value	Description
0	Kore is allowed to automatically attack monsters in any map.
1	Kore is only allowed to retaliate to aggressive monsters when outside the lockMap.
2	Kore is not allowed to automatically attack monsters outside the lockMap.

Note. This option only has effect if lockMap is set and attackAuto is enabled.

attackAuto_notInTown [<boolean flag>] v.1.9.0: If this option is set to 1, Kore will not auto-attack monsters when you are inside a town.

attackAuto_onlyWhenSafe [<boolean flag>]: If this option is set to 1, Kore will only auto-attack monsters when there are no people to see other than you and your party members.

attackAuto_party [<flag>]

This option sets whether Kore should attack monsters engaged by party members.

Value	Description
0	Do nothing.
1	Immediately attack monsters engaged by party.
2	Attack monsters only if they have started attacking the party.

Notes:

Use the flag value 2 if you are being tanked to prevent you from laying the attack to the monster first while the monster is still moving towards your tanker. Unless those monsters are known to have a habit of switching targets regardless of who made the first attack, this flag ensures that monsters will always attack the party/tanker.
This option works independently from attackAuto, thus if this option is enabled, you will attack monsters engaged by your party regardless of how attackAuto is set.
Kore will only attack monsters engaged by the follow target if there are no other aggressive monsters attacking Kore itself. If you want to give priority on monsters engaged by your party, set attackAuto to 0.

attackCanSnipe [<boolean flag>]: Set this option to 1 if your character is able to snipe (archers/mages). Kore will then attempt to attack through snipable walls or cliffs, instead of walking around them.

attackCheckLOS [<boolean flag>]: This option toggles the use of LOS (Line Of Sight) check code when attacking.
If this option is enabled and you are a ranged attacker (i.e. attackDistance is set to a value greater than 2), this will check whether it thinks you have a clear line of attack to the target; if not, it will attempt to move to a space where you do while respecting runFromTarget_dist and followDistanceMax.

attackComboSlot [<skill name>] block: Kore can automatically chain skills when attacking. This block can be used to specify a skill to automatically use after another skill was previously used.
See the attackComboSlot block details for more information on this block option.

attackDistance [<number>]: This option sets the distance in number of blocks from the monster that Kore will move to before attacking with its weapon. This also specifies the default distance to be used when the dist option in attackSkillSlot and attackComboSlot blocks are not specified.

attackDistanceAuto [<boolean flag>]: If this option is set to 1, Kore will automatically set attackDistance and attackMaxDistance by auto-detection.

attackEquip_(<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 attacking with your weapon.

For example, if you want to equip a Clip of Mustle and a Nimble Clip when you attack with your weapon, use the following configuration:

Example:

attackEquip_rightAccessory Clip [Mantis] [1]
attackEquip_leftAccessory Clip [Zerom] [1]

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

attackLooters [<boolean flag>] v.1.9.0: If this option is set to 1 and an item on the ground disappeared, Kore will automatically attack monsters directly standing on the same spot as where the item was last seen.
Note. This will only work if Kore is set to pick up the item that disappeared (see pickupitems.txt).

attackMaxDistance [<number>]: This option specifies the farthest distance in number of blocks between you and the monster before Kore will try to move closer when attacking.

attackMaxRouteDistance [<number>]: If this option is set, Kore will not move any more than the specified number of blocks to engage the target. This is used to prevent Kore from walking around long cliffs/walls just to attack a monster.

attackMaxRouteTime [<seconds>]: If this option is set, Kore will not spend any more than the specified number of seconds calculating the route to the target.

attackMinPlayerDistance [<number>]: Kore will not auto-attack non-aggressive monsters that are within the specified distance in number of blocks from other players.

attackMinPortalDistance [<number>]: Kore will not auto-attack non-aggressive monsters that are within the specified distance in number of blocks from a map portal.
Note. If this option is not set, Kore will use a default value of 4.

attackNoGiveup [<boolean flag>]: If this option is set to 1, Kore will not stop attacking the target even if Kore can't damage it.
Note. This is useful if your attackSkillSlot is a non-damaging skill, e.g. Spell Breaker.

attackSkillSlot [<skill name>] block: This option specifies the skill to automatically use when attacking.
See the attackSkillSlot block details for more information on this block option.

attackUseWeapon [<boolean flag>]: If this option is set to 1 and Kore is not using skills when attacking, Kore will be allowed to use its weapon to attack. Otherwise, Kore will never move towards the target to attack with its weapon. Most mages will want this option set to 0.

autoBreakTime [<weekday>|all] block: 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.
See the autoBreakTime block details for more information on this block option.

autoConfChange [<filenames>] block: 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.
See the autoConfChange block details for more information on this block option.

autoMakeArrows [<boolean flag>]: If you have the Arrow Craft skill, set this option to 1 to enable automatic arrow crafting. See arrowcraft.txt for details.

autoResponse [<boolean flag>]: Kore can automatically reply to chat messages. Set this option to 1 to enable automatic responding to messages. See chat_resp.txt for details.

autoResponseOnHeal [<boolean flag>]: If this option is set to 1, Kore can automatically send private messages to players who uses Heal, Increase AGI, or Blessing on you or the monster you are attacking. The responses can be configured in response.txt.

autoRestart [<boolean flag>]
autoRestartMin [<seconds>]
autoRestartSeed [<seconds>]

Set the option autoRestart to 1 if you want Kore to automatically restart itself (disconnect and log back in) in certain time intervals. Use this if you find that Kore is screwing up after a while, or if you just want it to automatically disconnect for a while.

The options autoRestartSeed and autoRestartMin sets the time it takes before Kore initiates auto-restart. The time will be equal to the randomized value of autoRestartSeed added to the value of autoRestartMin.

For example:

Example:

autoRestart 1
autoRestartMin 60
autoRestartSeed 30

With the configuration above, Kore will automatically restart after a random period between 60 and 90 (=60+30) seconds.

autoRestartSleep [<boolean flag>]
autoSleepMin [<seconds>]
autoSleepSeed [<seconds>]: If autoRestart is enabled, set the option autoRestartSleep to 1 if you want Kore to be in standby mode after it disconnects during auto-restart.
The options autoSleepSeed and autoSleepMin sets the time Kore will spend sleeping before connecting again during auto-restart. The time will be equal to the randomized value of autoSleepSeed added to the value of autoSleepMin.

autoSpell [<skill name>]

If you have the skill Auto Spell (Sage), use this option to set the spell that Kore will automatically cast during melee combat. This option is combined with the useSelf_skill for casting Auto Spell.

For example:

Example:

autoSpell Cold Bolt

useSelf_skill Auto Spell {
	lvl 10
	timeout 10
	whenStatusInactive Auto Spell
	notWhileSitting 1
}

In the example above, Kore will use the Sage skill Auto Spell on itself when the status "Auto Spell" is not active. The skill specified in the autoSpell option will be the skill Kore will automatically cast during melee combat.

Notes:

There are only seven skills you can specify: Napalm Beat, Fire Bolt, Lightening Bolt, Cold Bolt, Soul Strike, Fire Ball, and Frost Diver.
Furthermore, you can only cast a spell which you have points in. On some servers however, you can specify a spell which you haven't invested points in and it will succeed to be autocast at level 1.

autoSwitch [<monster names>] block: 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.
See the autoSwitch block details for more information on this block option.

autoSwitch_default_rightHand [<equipment name>]
autoSwitch_default_leftHand [<equipment name>]
autoSwitch_default_arrow [<arrow name>]: If you have set an autoSwitch block, these options specify the default weapon, shield and arrows that Kore will automatically equip when you encounter a monster not listed in any of your autoSwitch blocks.
Note. For autoSwitch_default_rightHand, specify [NONE] to attack with bare hands.

autoTalkCont [<boolean flag>]: If this option is set to 1, Kore will automatically type "talk cont" for you when you're in a conversation with an NPC.

avoidGM_ignoreList [<player names>]: If you don't want to avoid certain Game Masters or you want to prevent Kore from avoiding certain players that Kore might accidentally identify as Game Master (due to false name pattern matches), use this option to specify a comma-separated list of player names that will be excluded from avoidGM checks.

avoidGM_namePattern [<regular expression>]

By default, Kore identifies Game Masters as those players whose names follow the pattern:

Regular Expression:

/^([a-z]?ro)?-?(Sub)?-?\[?GM\]?/

The regular expression above matches the names iro-Sub-GM Hakore or pro[GM] Hakore. In case your server uses non-standard GM names, you can use this option to override the pattern by specifying a regular expression for GM names.

Notes:

Do not include the enclosing slashes ("/").
If you want to learn more about regular expressions, visit the site www.regular-expressions.info. Alternatively, you can search the web for the phrase "regular expression".

avoidGM_near [<flag>]

When Kore encounters players whose name matches a certain pattern for Game Master names (see avoidGM_namePattern), Kore can choose to avoid them. If you want to avoid Game Masters, set this option to one of the following possible values to determine what action you will do when one is seen on screen.

Value	Description
0	Do not avoid GMs.
1	Teleport away and then disconnect.
2	Disconnect.
3	Teleport away.
4	Respawn.

Note. If you disconnect to avoid a GM, you will reconnect after the number of seconds specified in avoidGM_reconnect has elapsed.

avoidGM_near_inTown [<boolean flag>]: If avoidGM_near is set, this option specifies whether you want to avoid Game Masters in towns or not. If this option is set to 1, Kore will try to avoid GMs even when you are in town. Set this to 0 if you don't want Kore to avoid GMs in town.

avoidGM_reconnect [<seconds>]: If avoidGM_near is set and you disconnect to avoid a Game Master, this option specifies the time in seconds Kore will wait and sleep before reconnecting again.

avoidGM_talk [<boolean flag>]: Set this option to 1 if you want to disconnect when a player whose name matches a certain pattern for Game Master names (see avoidGM_namePattern) sends you a private message.

avoidList [<boolean flag>]: This option enables or disables the avoid list. See avoid.txt.

avoidList_inLockOnly [<boolean flag>]: Set this option to 1 if you only want to avoid people in your avoid list when you are inside your lockMap.

avoidList_reconnect [<seconds>]: If avoidList is enabled and you disconnect due to avoid list matches, this option specifies the time in seconds Kore will wait and sleep before reconnecting again.

beepDomains [<message domains>]: If this option is set, Kore will beep when certain messages grouped under one of the specified comma-separated list of message domains is printed in the console.
Note. See the references section for a list of known message domains.

beepDomains_notInTown [<message domains>]: This option specifies a comma-separated list of message domains that are exempted from beepDomains if you are in a town.
Note. See the references section for a list of known message domains.

bindIp [<ip address>]: If your computer has multiple IP addresses, you can select which one to use. If you are unsure, you should leave this option empty.
Note. This cannot be used for proxying!

buyAuto [<item name>] block: Kore can automatically buy an item from a buy/sell NPC when the amount of that certain item in inventory goes below a minimum value. This option specifies the item to automatically buy from a buy/sell NPC.
See the buyAuto block details for more information on this block option.

cachePlayerNames [<boolean flag>] v.1.9.0
cachePlayerNames_duration [<seconds>] v.1.9.0
cachePlayerNames_maxSize [<number>] v.1.9.0

Player names can be cached so that they don't have to be re-retrieved as often. This can save a lot of bandwidth, especially when you're walking in town. The option cachePlayerNames enables or disables player name caching.

The option cachePlayerNames_duration specifies the maximum time in seconds player names will be kept in the cache.

The option cachePlayerNames_maxSize specifies the maximum number of player names to be cached. If the number of player names that needs to be cached exceeds the specified number, the earliest name added will be removed.

callSign [<call name>]: This option specifies the word or call name that must be included in chat commands sent to Kore through party and guild chats for such commands to be recognized. This is not case sensitive.
Note. See Chat Commands for more information.

cartMaxWeight [<number>] v.1.9.0: If you have a cart and you set Kore to automatically put items in your cart (see items_control.txt), Kore will stop putting items to your cart if the cart weight is greater than or equal to the specified number.

char [<number>]: This option specifies the character to login as from the character select server. This number is the index of your character as displayed in the character selection screen. Your first character is index 0, second is 1, and so on.
Note. You don't have to set this option. If you leave it empty, Kore will automatically ask you to choose a character from a list when you login to the game login server.

chatLangCode [<boolean flag>]: If your RO server uses language codes in chat messages, then you must set this option to 1. Right now, euRO and oRO are the only servers that use language codes. So for all other servers, you must set this option to 0 or your chat messages will always have a preppended "|00".
Note. You don't have to set this option. If it is already set in tables\servers.txt, Kore will automatically set the correct chatLangCode depending on your chosen master server.

chatTitleOversize [<boolean flag>]: If this option is set to 1 Kore will allow itself to use chatroom titles that are more than 36 characters in length.
Note. It is not recommended to enable this option. Only use this if you know what you are doing.

clientSight [<number>] v.1.9.0: If this option is set, Kore will ignore actors (e.g. monsters, NPCs, etc.) whose distance from you is greater than or equal to the specified number of blocks. If not specified, Openkore assumes a default value of 15.
Note. Some private servers like Freya will send actor packets at a ridiculous distance that the normal RO Client can't display, and use this for automated banning. This config option will make Kore ignore those actors and hopefully avoid auto-bans.

commandPrefix [<string>]: If you're running in X-Kore mode, messages you type in the Ragnarok Online client that begin with the specified prefix will be intercepted by Kore and interpreted as console commands.

dcOnDeath [<flag>]

This option specifies what Kore should do when it is dead.

Value	Description
-1	Do nothing. Do not respawn.
0	Respawn after a certain number of seconds specified in the timeout key ai_dead_respawn in timeouts.txt.
1	Disconnect (exit).

dcOnDisconnect [<boolean flag>]: If this option is set to 1, Kore will quit (don't reconnect) when you get disconnected from the server.

dcOnDualLogin [<number>]: If this option is set to 1, Kore will quit (don't reconnect) when a dual login error is detected (someone else is accessing the account).
Any other value will be interpreted as the time in seconds when Kore will try to reconnect again after being disconnected due to a dual login error. For example, if you want Kore to reconnect after an hour, specify a value of 3600. If you want Kore to immediately reconnect, set this option to 0.

dcOnEmptyArrow [<boolean flag>]: If this option is set to 1, Kore will automatically disconnect when you have no more arrows to use.

dcOnJobLevel [<level>] v.1.9.0: If this option is set and you gain a job level, Kore will automatically disconnect when your job level is greater than or equal to the specified level.

dcOnLevel [<level>] v.1.9.0: If this option is set and you gain a level, Kore will automatically disconnect when your base level is greater than or equal to the specified level.

dcOnMute [<boolean flag>]: If this option is set to 1, Kore will automatically disconnect when you have been muted by a GM.

dcOnPM [<boolean flag>]: If this option is set to 1, Kore will automatically disconnect when somebody sends you a PM.

dcOnStorageFull [<boolean flag>] v.1.9.0: If this option is set to 1, Kore will automatically disconnect when your current weight is still greater than or equal to the percent weight specified in itemsMaxWeight_sellOrStore after finishing an auto-storage sequence.

dcOnZeny [<amount>]: If this option is set, Kore will automatically disconnect when the total amount of zeny is less than or equal to the specified amount.

dealAuto [<flag>]

This option specifies what to automatically do with incoming deals.

Value	Description
0	Do nothing.
1	Automatically cancel all deals.
2	Automatically accept deals, and immediately finalize/trade.
3	Automatically accept deals; finalize and trade only after the other party finalizes.

debug [<level>]

Enable or disable debugging messages. This option is only interesting to developers, or when you want to submit a bug report.

Value	Description
0	Off.
1	Low.
2	High.

debugDomains [<message domains>]

If this option is set, messages grouped under one of the specified comma-separated list of debug message domains (which are not normally displayed) will be printed in the console.

Notes:

For debug messages, the option squelchDomains overrides this option, thus if a message domain is listed in squelchDomains, that message group will never be printed in the console even if it is listed in this option.
Internally, Kore sets the verbosity level of debug message domains listed in this option to 0. See the option verbose for more information on verbosity.
See the references section for a list of known message domains.

debugPacket_exclude [<packet switches>]

packet switch - The first 2 bytes of recieved packets in reversed order (e.g. 8A 23 -> 238A). See your tables\packetdescriptions.txt for a list of known packets.

This specifies a comma-separated list of packet switches that you want to be ignored by the options debugPacket_received, debugPacket_ro_sent, debugPacket_sent, and debugPacket_unparsed, if these options are set. For example, debugPacket_exclude 008A,0123.

Note. only useful for developers. Don't mess with these unless you know what you are doing.

debugPacket_include [<packet switches>]
debugPacket_include_dumpMethod [<flag>]

packet switch - The first 2 bytes of recieved packets in reversed order (e.g. 8A 23 -> 238A). See your tables\packetdescriptions.txt for a list of known packets.

The option debugPacket_include specifies a comma-separated list of specific packet switches that you want to display or dump to file when they are received.

Note. This option forces displaying or dumping of packets received regardless of how the other debugPacket_* options are set.

The option debugPacket_include_dumpMethod specifies how the packet information will be displayed or dumped.

Value	Description
0	Disabled.
1	Prints a debug message in the console that contains the packet switch and a description.
2	Prints a normal message in the console that contains visual output of the packet.
3	Dumps the packet to file DUMP.txt.

Note. only useful for developers. Don't mess with these unless you know what you are doing.

debugPacket_received [<flag>]

Toggles the displaying of all received packet switches.

Value	Description
0	Disabled.
1	Prints a debug message in the console that contains the packet switch and a description.
2	Prints a normal message in the console that contains visual output of the packet.

Note. only useful for developers. Don't mess with these unless you know what you are doing.

debugPacket_ro_sent [<flag>]

Toggles the displaying of packet switches sent by the RO client (only in X-Kore mode).

Value	Description
0	Disabled.
1	Prints a debug message in the console that contains the packet switch and a description.
2	Prints a normal message in the console that contains visual output of the packet.

Note. only useful for developers. Don't mess with these unless you know what you are doing.

debugPacket_sent [<boolean flag>]

Toggles the displaying of packet switches sent by Kore.

Value	Description
0	Disabled.
1	Prints a debug message in the console that contains the packet switch and a description.
2	Prints a normal message in the console that contains visual output of the packet.

Note. only useful for developers. Don't mess with these unless you know what you are doing.

debugPacket_unparsed [<boolean flag>]: Toggles unparsed packet dumping.
Note. only useful for developers. Don't mess with these unless you know what you are doing.

encrypt [<number>]

This option specifies the Ragnarok Online server's encryption mode. Back in 2003, cRO, iRO and some other servers used encryption. These days there are no known servers that use encryption, so you probably shouldn't touch this option.

Value	Description
0	Off.
1	Mode 1.
2	Mode 2.

equipAuto [<equipment name>] block: Kore can automatically equip an items when certain conditions are met. This option allows you to specify an equipment to automatically equip when all the conditions are met.
See the equipAuto block details for more information on this block option.

exeName [<filename>] v.1.6.4 and v.1.9.0 only

If XKore is set to 1, this option specifies the name of the Ragnarok Online client executable (without the path) that will be used by X-Kore.

Notes:

Never mistake this to be the patch client. You have to distinguish between the patch client and the RO client.
This option is renamed to XKore_exeName in SVN.

follow [<boolean flag>]: This option toggles player following. If this is set to 1 and followTarget is set, Kore will follow that player around.

followBot [<boolean flag>]: When following and this option is set to 1, this specifies that the followTarget is a Kore bot. If this is enabled and the followTarget is out of screen range, a move command will be PM'ed to him, telling him to go to where you are.
Note. You must be authorized to use Chat Commands on the your followTarget or this option has no effect.

followCheckLOS [<boolean flag>]: This option toggles the use of LOS (Line Of Sight) check code when following.
If you are following, this will check whether it thinks you have a clear line of movement to the followTarget; if not, it will attempt to move to a space where you do.

followDistanceMax [<number>]
followDistanceMin [<number>]: When following, Kore will try to never be further away from the followTarget than the number of blocks specified in followDistanceMax, and never closer than the number of blocks specified in followDistanceMin.

followEmotion [<boolean flag>]
followEmotion_distance [<number>]: When following and followEmotion is enabled, Kore will imitate the followTarget's emoticons if he's within the number of blocks distance specified in followEmotion_distance.

followFaceDirection [<boolean flag>]: When following and if this option is enabled, Kore will always look at the followTarget.

followLostStep [<number>]: If Kore lost its followTarget when following, Kore will move towards where the followTarget was last seen. By default, Kore will move this number of blocks every second, for about 10 seconds.
Note. You probably shouldn't have to change this option.

followSitAuto [<boolean flag>]: If this option is enabled, Kore will sit/stand when the followTarget sits/stands.

followTarget [<player name>]: If follow is enabled, Kore will follow the specified player.

forceMapIP [<ip address>]: If this option is set, Kore will use this ip address to connect to the map server instead of the ip defined in tables\servers.txt or that received from the RO server.

friendlyAID [<player IDs>]: This option specifies a comma-separated list of AIDs (player IDs) of friendly players. When players in this list appear on screen, the corresponding console message will be in the domain parseMsg_presence instead of parseMsg_presence/player (useful for beepDomains).

getAuto [<item name>] block: 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.
See the getAuto block details for more information on this block option.

guildAutoDeny [<boolean flag>]: If this option is set to 1, Kore will automatically deny all guild join requests.

ignoreAll [<boolean flag>]: If this option is enabled, Kore will automatically block all PMs.
Note. This has the same effect as the /exall command in the official Ragnarok Online client.

ignoreInvalidLogin [<boolean flag>]: If this option is enabled, Kore will ignore the "Account doesn't exist" error message.

intervalMapDrt [<seconds>]: Setup the time interval in seconds when Kore will save its coordinates to be used by mapview.pl

itemHistory [<boolean flag>]: This option toggles the logging of items added to your inventory in logs\items.txt

itemsGatherAuto [<flag>]

This option toggles auto-gather of items.

Value	Description
0	Do not gather items.
1	Kill all monsters that are attacking you, then gather loot.
2	Gather loot, then kill all monsters that are attacking you.

Note. If this option is enabled, Kore will pickup items that aren't surrounded by any players. It's smart, non-intrusive looting.

itemsMaxNum_sellOrStore [<number>] v.1.9.0: If the total number of items in your inventory is greater than or equal to the specified number, Kore will automatically sell items (if sellAuto is enabled) or go to storage (if storageAuto is enabled). This is useful to prevent you from picking up more items when you have reached the maximum allowable number of items in your inventory.

itemsMaxWeight [<percent>]: Kore will stop picking up items when its weight percentage is greater than or equal to the specified percent.

itemsMaxWeight_sellOrStore [<percent>]: If your weight percentage is greater than or equal to the specified percent, Kore will automatically sell items (if sellAuto is enabled) or go to storage (if storageAuto is enabled).
Note. While walking to the sell/storage NPC and Kore is set to pickup loots, Kore will pick up loot as long as your weight is under the percentage specified by itemsMaxWeight.

itemsTakeAuto [<flag>]

This option toggles auto-looting of items dropped by monsters you killed.

Value	Description
0	Do not pick up any loot.
1	Kill all monsters that are attacking you, then pick up the loot.
2	Pick up the loot, then kill all monsters that are attacking you.

itemsTakeAuto_new [<boolean flag>] v.1.9.0: If this option is set to 1, this will activate the new experimental item taking code; might work better for archers who keep failing to take items.

itemsTakeAuto_party [<boolean flag>]: If this option is enabled, Kore will automatically pick up items dropped by monsters killed by party members.

lockMap [<map name>]: If this option is set, Kore will always try to stay in the specified map. If you are not inside your lockMap, Kore will try to walk back to it. If you die (hopefully, you won't), Kore will walk back to your lockMap after you sit to regenerate your HP.

lockMap_x [<x-coordinate>]
lockMap_y [<y-coordinate>]

If lockMap is set, and these two options are set, Kore will always try to stay in the specified coordinates inside the lockMap.

Notes:

If you are using random walk to search for monsters, you have to also set lockMap_randX and lockMap_randY or these options are rather useless.
If you are using tele-search, these options are entirely useless.

lockMap_randX [<number>]
lockMap_randY [<number>]

If lockMap, lockMap_x, and lockMap_y are set, and you set these two options, Kore will always try to stay at a random spot inside the lockMap within an area lockMap_randX distance to the left or to the right of lockMap_x, and lockMap_randY distance above or below lockMap_y.

Notes:

This is useful if you want to stay in a particular area inside the lockMap. If you are using random walk to search for monsters, these options restrict your movement within that particular area.
If you are using tele-search, these options are entirely useless.

logAppendUsername [<boolean flag>] v.1.9.0: If this option is set to 1, your username and char will be appended to the log file names to be used. This is useful if you are running multible bots at the same time so logs for each bot are separated on different files.
For example, if your username is hakore and your char is 0, your log files will be named 'chat_hakore_0.txt', 'monsters_hakore_0.txt', 'items_hakore_0.txt', 'storage_hakore_0.txt', and 'shop_hakore_0.txt'.

logConsole [<boolean flag>] v.1.9.0: If this option is set to 1, everything that Kore prints on the console will be logged to logs\console.txt.

logChat [<boolean flag>]
logPrivateChat [<boolean flag>]
logPartyChat [<boolean flag>]
logGuildChat [<boolean flag>]
logSystemChat [<boolean flag>]: These options toggles the logging of particular chat data into logs\chat.txt.

logEmoticons [<emoticons>]: This option specifies a comma-separated list of emoticon codes that you want to log in chat.txt. A value of all means you want to log all emoticons. See tables\emotions.txt for a list of available emoticon codes.

logToFile_Debug [see below]
logToFile_Errors [see below]
logToFile_Messages [see below]
logToFile_Warnings [see below]

These options enable the logging of Messages, Errors, Warnings and Debug infos to Files. These are only interesting for Developers or if you want to save special domains to a file. The files are created in you Log folder.

The value for these options observes the following syntax:

Syntax:

<domain>=<filename>
<domain>=<filename1>,<filename2>
<domain1>=<filename1>;<domain2>=<filename2>,<filename3>

The following example will log all debug messages for the parseMsg domain to messages.txt.

Example:

logToFile_Debug parseMsg=messages.txt

The following example will log all selfSkill messages to selfskill.txt and all used items to usedItems.txt.

Example:

logToFile_Messages selfSkill=selfskill.txt;useItem=usedItems.txt

master [<server name>]: This option specifies what master server Kore should log in to (whether you want Kore to login to iRO, oRO, pRO, etc.). See tables\servers.txt for a list of valid master server names (those names enclosed in square brackets "[ ]").
Note. You don't have to set this option. If you leave it empty, Kore will automatically ask you to select a master server from a list at startup.

message_length_max [<number>]: All outgoing chat will be divided intelligently into messages with lengths of at most the specified number of characters.
Note. You shouldn't change this option unless you know what you're doing.

missDamage [<number>]

Any damage you do less than or equal this amount will be counted as a miss.

Notes:

This option is useful for detecting a miss when you're using a Very Very Strong elemental weapon which still deals a small amount of damage even if you actually miss.
This is also useful for detecting whether you're using the correct elemental weapon against a certain monster. For example, you know that you normally do at least 300 damage to Merman. But when Merman changes element, you will do less damage. In combination with totalMisses in the equipAuto configuration block, you can automatically equip a different elemental weapon.

monsterLog [<boolean flag>]: This option toggles the logging of monsters killed in logs\monsters.txt.

monsterSkill [<skill name>] block: 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.
See the monsterSkill block details for more information on this block option.

noAutoSkill [<boolean flag>]: If this option is set to 1, this disables all auto-skills.
Note. An auto-skill means it will automatically use a skill whenever it sees "Permitted to use ". This is usually done for Butterfly Wings; it'll say "Permitted to use Teleport, level 3" when you use a Butterfly Wing, and openkore in its default behavior will automatically use that skill. noAutoSkill makes it not do this. This makes you avoid auto-bans like in EuphRO which automatically makes you try to use Basic Skill level 0 regularly. (pmak)

partyAuto [<flag>]

This option specifies what to automatically do with incoming party join requests.

Value	Description
0	Do nothing.
1	Automatically deny party requests.
2	Automatically accept party requests.

partyAutoShare [<boolean flag>]: If this option is enabled, Kore will automatically set party EXP sharing to 'Even Share' on connect.

partySkill [<skill name>] block: 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.
See the partySkill block details for more information on this block option.

partySkillDistance [<range>]: This specifies how close a player must be to you in order for you to use a partySkill on them. Defaults to 1..8

password [<password>]: This option specifies your password for logging into Ragnarok Online.
Note. You don't have to set this option. If you leave it empty, Kore will automatically ask you for your password at startup.

pauseMapServer [<seconds>]: Pause for the specified number of seconds before connecting to map server (sometimes the server is slower than the bot).

portalRecord [<flag>]

This option toggles automatic recording of portals in tables\portals.txt.

Value	Description
0	Disabled.
1	Record portals you walk through.
2	Record the return portal too (by guessing).

relogAfterStorage [<boolean flag>]: If this option is set to 1, Kore will relogin after performing autostorage. This works around a server bug which causes autostorage to fail when you do it the second time.

removeActorWithDistance [<number>] in SVN: If this option is set to 1, Kore will automatically remove actors from a specified distance.
This is useful for merchants vending in prontera - set removeActorWithDistance to ~5 and you will not send as many getPlayerInfo packets, thus lessening the lag caused by you.

repairAuto [<boolean flag>] v.1.9.0: If this option is set to 1, Kore will automatically choose the item to repair when you use the Weapon Repair Skill on players.

route_maxNpcTries [<number>] v.1.9.0: If talking to a Warp NPC is part of the map solution to reach your destination, this option specifies the maximum number of times Kore will try to talk to the NPC before giving up and plotting an alternate path.
Note. If this option is not set, Kore will use a default value of 5.

route_maxWarpFee [<amount>]: This option specifies the maximum amount of zeny you're willing to spend on a Warp NPC to reach your destination. If this option is set and Kore is calculating map routes, Kore will choose a map solution that do not use Warp NPCs that require zeny greater than the specified amount.
Note. See your tables/portals.txt.

route_randomWalk [<flag>]

This option toggles random walking. If this is enabled, Kore will regularly walk to random spots on the current map when it is idle.

Value	Description
0	Disabled.
1	Walk to random spots anywhere inside the current map.
2	Walk to random spots but do not pass through portals inside the current map.

Notes:

The flag value 2 is used in maps split by portals (e.g. dungeon maps) if you want to prevent Kore from entering map portals to reach other areas of the current map.
Kore will never walk randomly inside towns.
If you are using tele-search, you have to disable this option.

route_randomWalk_inTown [<boolean flag>] in SVN: By default, Kore will not walk randomly inside a taown even if route_randomWalk is enabled. Set this option to 1 if you want to allow Kore to random walk in towns.

route_randomWalk_maxRouteTime [<seconds>]: If route_randomWalk is enabled, Kore will not spend any more than the specified number of seconds calculating the route to the random point. A new point will be chosen if the time limit is exceeded. Set to 0 to disable.

route_step [<number>]: This option specifies the number of steps (blocks) Kore will move along the route at a time.
Note. You should probably leave this option at the default value (15). You should never set this option to 0 or Kore will not be able to walk at all.

route_teleport [<boolean flag>]
route_teleport_minDistance [<number>]
route_teleport_maxTries [<number>]

If route_teleport is set to 1, and Kore is walking to a certain map, Kore will teleport until it is within the distance specified in route_teleport_minDistance away from the destination portal.

Note. The optimal value for route_teleport_minDistance depends on the map you're currently on, but it's generally recommended that you use a value between 100 or 200.

Kore will attempt to teleport at most the number of times specified in route_teleport_maxTries per map. If it fails to get near the portal in that many teleport tries, it will start walking to the portal.

route_teleport_notInMaps [<map names>]: Maze-like maps such as dungeons and mjolnir maps screws route teleport. If route_teleport is enabled, this option specifies a comma-separated list of map names where Kore will not use route teleport.

runFromTarget [<boolean flag>]
runFromTarget_dist [<number>]

If runFromTarget is enabled, Kore will try to keep a safe distance between you and the target monster by running away when the target gets closer than the distance specified in runFromTarget_dist. This is useful for ranged attackers.

Notes:

The monster you are attacking must be slower than your current walking speed, or must be made immobile using skill status. Otherwise you will be running away forever.
Be wary that if this option is enabled, it prevents you from walking closer to your target to keep it within your attack range.

saveMap [<map name>]: This option specifies the name of the map where your character is saved. This is used when respawning.
Note. The character MUST have saved in that map for Kore to be able to respawn to that map.

saveMap_warpChatCommand [<chat command>] in SVN

Some RO servers allow you to warp to any map without using a Butterfly Wing, Teleport Skill or Warp Portal Skill by simply using a server-defined chat command (e.g. "@go", "@warp"). This option can be used to specify the chat command to use for respawning to your saveMap. If this is set, teleportAuto_useSkill is ignored and Kore will instead send the chat command to the server to respawn.

Notes:

This option does not check if the chat command you use does warp you to your saveMap. It is your responsibility to specify the right chat command or you may end up using the chat command endlessly.
See also teleportAuto_useChatCommand for using chat commands on random teleport.

saveMap_warpToBuyOrSell [<boolean flag>]: If enabled, Kore will warp to to the save point specified by saveMap before doing auto-sell, auto-buy, auto-storage or auto-get.
Note. You must properly set saveMap or this option will fail. You also need a Butterfly Wing in your inventory or the Teleport Skill, to respawn.

secureAdminPassword [<boolean flag>]: If this option is enable, Kore will generate a random adminPassword everytime you start Kore.

secureLogin_requestCode [<hex string>]

If your server uses secure login and secureLogin_requestCode is not set on your master server details (see tables\servers.txt), Kore will use the code specified here to login to the master server. The code depends on your server: try searching the forums for the correct code for your server.

The <hex string> is a space-separated sequence of hex codes. For example: 04 02 22 37 D7 FC.

Notes:

If this option is set, the secureLogin_type setting in the master server details is ignored.
If you're playing on Indonesian RO, and you use VisualKore, you don't have to set this option. VisualKore will automatically download the latest (correct) secure login code from the Internet.

sellAuto [<boolean flag>]
sellAuto_distance [<number>]
sellAuto_npc [<map name> <x> <y>]

The option sellAuto enables or disables auto-selling. If this is set to 1 and your percent weight reaches a value greater than or equal to the percentage specified in itemsMaxWeight_sellOrStore, Kore will automatically move to the location of the buy/sell NPC specified in sellAuto_npc to sell items in your inventory.

Notes:

To configure which items you want to sell, edit items_control.txt.
If the NPC is located in your saveMap, you can set saveMap_warpToBuyOrSell to 1 to automatically warp back to your save point before moving to the NPC.

The option sellAuto_distance specifies how far Kore will stand from the item buy/sell NPC during auto-sell.

sellAuto_standpoint [<map name> <x> <y>] bugged: If this option is set, Kore will use the specified location as a standpoint during auto-sell instead of anywhere near the item buy/sell NPC itself. The option sellAuto_distance will be ignored.
Note. This is still bugged in v.1.6.4 so don't use this. Fixed in v.1.9.0.

server [<number>]: This option specifies the game login server you want to login to. This number is the index of your server as displayed in the server selection screen. The first listed server is index 0, second is 1, and so on.
Note. You don't have to set this option. If you leave it empty, Kore will automatically ask you to select a server when you login to the master server.

serverType [<number>]

If serverType is not specified in your master server details (see tables\servers.txt), you can specify in this option what kind of server you're playing on.

Value	Description
0	Normal server
1	oRO (Oceania)
2	pRO (Philippines)
3	eAthena SVN
4	Freya
5	eAthena servers using sakexe628

Note. You don't have to set this option. If it is already set in tables\servers.txt, Kore will automatically set the correct serverType depending on your chosen master server.

sex [<flag>]

When logging in, you can force your sex to be of this value. This is an exploit. You cannot see your sex change, but other people can. It's recommended that you leave this option empty unless you know what you are doing.

Value	Description
0	Girl
1	Boy

Note. If you are using X-Kore mode, you have to leave this option blank or you will have problems logging in.

shopAuto_open [<boolean flag>]: If this option is set to 1 and you have the Vending Skill, Kore will automatically open your shop after you have been idle for a certain amount of time specified in the timeout key ai_shop in timeouts.txt.
Note. To configure what items you want to put in your shop, edit shop.txt.

shopTitleOversize [<boolean flag>]: If this option is set to 1 Kore will allow itself to use shop titles that are more than 36 characters in length.
Note. It is not recommended to enable this option. Only use this option if you know what you are doing.

shop_random [<boolean flag>]: By default, when you open a shop, Kore will put items in your shop in the same order as they appear in shop.txt. Set this option to 1 if you want to randomize the order of your shop items.

showDomain [<boolean flag>]: If this option is set to 1, Kore will display domain names along with messages in the console.

showTime [<boolean flag>]: If this option is set to 1, Kore will display a timestamp along with all messages printed in the console (e.g. [Sep 15 11:27:44 2005.99]).
Note. If you want to limit displaying of timestamps on specific messages only, or if you want to customize the format of the timestamps, use showTimeDomains instead.

showTimeDomains [<message domains>]
showTimeDomainsFormat [<time format>]

If showTimeDomains is set to 1, Kore will display a timestamp along with messages grouped under the specified comma-separated list of message domains.

You can set a time format in showTimeDomainsFormat to customize how Kore displays the timestamp. The <time format> is simply a string that will be used as a pattern when the timestamp is displayed. The following characters can be used in the time format and will be replaced by corresponding time elements:

Character	Description
H	Hour.
M	Minutes.
S	Seconds.
y	Year.
m	Month.
d	Day.

The following example may print connection messages with a preppended timestamp such as [11:23:49 15/08/2005].

Example:

showTimeDomains connection
showTimeDomainsFormat [H:M:S d/m/y]

Note. See the references section for a list of known message domains.

sitAuto_hp_lower [<percent>]
sitAuto_hp_upper [<percent>]: Kore will automatically sit to regenerate HP when the current HP is below sitAuto_hp_lower. When HP reaches sitAuto_hp_upper, Kore will stand and resume other AI functions.

sitAuto_idle [<boolean flag>]: If this option is set to 1, Kore will sit after you have been idle for a certain amount of time specified in the timeout key ai_sit_idle in timeouts.txt.

sitAuto_look [<direction>]: If this option is set, this specifies the direction you will look at when you sit.
Note. See the console command look for the list of body directions.

sitAuto_over_50 [<boolean flag>]: By default, Kore will not sit if you are overweight. If this option is set to 1, this forces the bot to sit even when overweight.

sitAuto_sp_lower [<percent>]
sitAuto_sp_upper [<percent>]: Kore will automatically sit to regenerate SP when the current SP is below sitAuto_sp_lower. When SP reaches sitAuto_sp_upper, Kore will stand and resume other AI functions.

skillsAddAuto [<boolean flag>]
skillsAddAuto_list [see below]

If the option skillsAddAuto is set to 1, Kore can automatically raise the level of your skills.

The option skillsAddAuto_list specifies what skills to raise and up to what level. The value for skillsAddAuto_list observes the following syntax:

Syntax:

<skill> <level>[,<skill2> <level2>[, ...]]

In the following example, Kore will first raise Basic Skill to level 9. After that is done, it will raise Increase HP Recovery to level 10, and then raise Sword Mastery to level 10.

Example:

skillsAddAuto 1
skillsAddAuto_list Basic Skill 9, Increase HP Recovery 10, Sword Mastery 10

sleepTime (<microseconds>): Kore sleeps for the specified microseconds every program cycle to conserve CPU cycles.
Setting it to a higher value will make Kore use less CPU power, but also less responsive. If you run just one or two bots, then you should leave it at the default value of 10000. However, if you run many bots, and CPU usage is a concern, then you should set it to a higher value. In that case, a value of 50000 is recommended. It's generally not recommended to set the value higher than 200000, as it will make your bot very unresponsive.

squelchDomains [<message domains>]

If this option is set, certain messages grouped under the specified comma-separated list of message domains will not be printed in the console. For example, use:

Example:

squelchDomains skill

if you don't want your vendbot to be spammed by people using skills in town.

Notes:

For normal messages, the option verboseDomains overrides this option, thus if a message domain is listed in verboseDomains, that message group will always be printed in the console even if it is listed in this option.
Internally, Kore sets the verbosity level of message domains listed in this option to 5. See the option verbose for more information on verbosity.
See the references section for a list of known message domains.

statsAddAuto [<boolean flag>]
statsAddAuto_dontUseBonus [<boolean flag>]
statsAddAuto_list [see below]

If the option statsAddAuto is set to 1, Kore can automatically distribute status points to raise your stats.

The option statsAddAuto_list specifies which stats to raise and up to what number. The value for statsAddAuto_list follows the following syntax:

Syntax:

<number> <stat>[,<number2> <stat2>[, ...]]

where <stat> is the three-letter stat name (i.e. str, agi, int, vit, dex, or luk).

In the following example, Kore will continue to add status points to vit first until you have a total of 30 vit, afterwhich it will add points to agi until it's 99.

Example:

statsAddAuto 1
statsAddAuto_dontUseBonus 0
statsAddAuto_list 30 vit, 99 agi

By default, Kore counts your total stat (i.e. base stat + job bonus). If you want to count only the base stat, set the option statsAddAuto_dontUseBonus to 1. In the previous example, if statsAddAuto_dontUseBonus is set to 1, Kore will add points so that the base vit is exactly 30, thus if you are a job level 30 Acolyte, your total vit would be 32 (since job level 30 Acolytes get 2 bonus points to vit).

statsAdd_over_99 [<boolean flag>] in SVN: By default, Kore will not allow you to add stat points over 99. If you are playing on a private server where the maximum stat goes over 99, you can set this option to 1 so Kore will allow adding of stats past 99.

storageAuto [<boolean flag>]
storageAuto_distance [<number>]
storageAuto_npc [<map name> <x> <y>]

The option storageAuto enables or disables auto-storing. If this is set to 1 and your percent weight reaches a value greater than or equal to the percentage specified in itemsMaxWeight_sellOrStore, Kore will automatically move to the location of the Kafra NPC specified in storageAuto_npc to store items in your inventory.

Notes:

To configure which items you want to store, edit items_control.txt.
If the NPC is located in your saveMap, you can set saveMap_warpToBuyOrSell to 1 to automatically warp back to your save point before moving to the NPC.
You have to set the type of Kafra NPC in storageAuto_npc_type so Kore will know how to talk to the NPC to open the storage.

The option storageAuto_distance specifies how far Kore will stand from the item buy/sell NPC during auto-storage.

storageAuto_keepOpen [<boolean flag>] v.1.9.0

By default, Kore always closes the storage when it is done with the auto-storage sequence. If this option is set to 1, Kore will keep the storage open after doing auto-storage.

Notes:

Only enable this if you know what you're doing.
You cannot use items while storage is open.

storageAuto_notAfterDeath [<boolean flag>]: By default, Kore will try to go to storage after you respawned when you die. If this option is set to 1, Kore will not automatically do storage and selling when it dies.

storageAuto_npc_type [<flag>]
storageAuto_npc_steps [<NPC talk codes>]

Some Kafra NPCs require different conversation steps in order to open the storage. If storageAuto is enabled, the option storageAuto_npc_type allows you to specify what kind of NPC is specified in storageAuto_npc so Kore will know how it will talk to the NPC to open the storage:

Value	Description
1	Normal NPC (code: c r1 n).
2	Comodo NPC (code: c c r1 n).
3	Other NPC (use the code specified in storageAuto_npc_steps).

If you specified 3 for storageAuto_npc_type, you must manually specify the exact steps needed in storageAuto_npc_steps, otherwise, this option is ignored. See the references section to learn about NPC conversation codes.

For example, if your Kafra requires you to click Continue, then select the second menu item, then select the first menu item. You specify:

Example:

storageAuto_npc_type 3
storageAuto_npc_steps c r1 r0

storageAuto_password [<password>] v.1.9.0: If your server is using a storage password, specify the password here.
Note. You must also set storageEncryptKey for this to work.

storageAuto_useChatCommand [<chat command>]: Some RO servers allow you to use storage from any map without talking to a Kafra NPC by simply using a server-defined chat command (e.g. "@storage"). This option specified the chat command to use for opening the storage. If this is set, storageAuto_npc is ignored and Kore will instead send the chat command to the server to open the storage.

storageEncryptKey [<encrypt key>] v.1.9.0

If your server is using a storage password, specify your server's encryption key here.

For mRO, the encrypt key is:

Encrypt key:: 0x050B6F79, 0x0202C179, 0x00E20120, 0x04FA43E3, 0x0179B6C8, 0x05973DF2, 0x07D8D6B, 0x08CB9ED9

Notes:

The key may change in the future.
You don't have to set this option. If it is already set in tables\servers.txt, Kore will automatically set the correct storageEncryptKey depending on your chosen master server.

tankersList [<player names>]: Kore will not allow you to kill-steal monsters engaged by players other than those in your party. This option allows you to specify a comma-separated list of player names that should be treated as if they were in your party so they can tank monsters for you.

tankMode [<boolean flag>]
tankModeTarget [<player name>]: If tankMode is set to 1, and the player specified in tankModeTarget is found on screen, Kore will tank for the player by only hitting monsters once.

teleportAuto_allPlayers [<boolean flag>]

If this option is set, Kore will automatically teleport to avoid all players on screen.

Value	Description
0	Disabled.
1	Teleport away from all players.
2 in SVN	Teleport away from all non-party members.

Note. Kore will not teleport away if you are currently doing auto-storage or auto-buy.

teleportAuto_atkCount [<number>]: If this option is set, Kore will automatically teleport if the number of times it has attacked a single monster is greater than or equal to the specified number.

teleportAuto_atkMiss [<number>]: If this option is set, Kore will automatically teleport when the number of times your attacks have missed a monster is greater than or equal to the specified number. For example, this is useful if you're trying to attack a monster with the wrong elemental weapon.

teleportAuto_attackedWhenSitting [<boolean flag>]: If this option is set to 1, Kore will automatically teleport when it gets hit by a monster while sitting.
Note. If you timely teleport due to attack from the monster, you will not receive any damage at all even if it is displayed in the console.

teleportAuto_deadly [<boolean flag>]: If this option is set to 1, Kore will automatically teleport when the next hit of a monster could kill you.
Note. If you timely teleport due to attack from the monster, you will not receive any damage at all even if it is displayed in the console.

teleportAuto_dropTarget [<boolean flag>]: If this option is set to 1, Kore will automatically teleport when it drops a target because it can't reach or damage it.

teleportAuto_dropTargetKS [<boolean flag>] v.1.9.0: If this option is set to 1, Kore will automatically teleport when it drops a target to avoid kill-stealing other players. This is a workaround for constantly dropping and selecting the same target.

teleportAuto_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 teleport.

Notes:

You can actually use all slots but it is recommended to use only either the right or left accessory slot (for Teleport accessory).
If you are using a Teleport accessory to teleport and it is not equipped by default, you can use this option to automatically equip the accessory. Note however, that this will not ensure that you will evade damage when you teleport as described in teleportAuto_attackedWhenSitting, teleportAuto_deadly, teleportAuto_hp, teleportAuto_maxDmg, teleportAuto_maxDmgInLock, teleportAuto_totalDmg, and teleportAuto_totalDmgInLock.

Example:

teleportAuto_equip_rightAccessory Clip [Creamy] [1]

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

teleportAuto_emptyName [<boolean flag>]: If this option is set to 1, Kore will automatically teleport when you are attacked by a monster with an empty name.

teleportAuto_hp [<percent>]: If this option is set, Kore will automatically teleport if HP is below the specified percentage and there are aggressive monsters attacking you.
Note. If you timely teleport due to attack from the monster, you will not receive any damage at all even if it is displayed in the console.

teleportAuto_idle [<boolean flag>]: If this option is set to 1, Kore will automatically teleport after you have been idle for a certain amount of time specified in the timeout key ai_teleport_idle in timeouts.txt.
Note. If enabled, this option is used for the tele-search feature. If you want to use tele-search, you must set teleportAuto_search to 1 and route_randomWalk to 0.

teleportAuto_maxDmg [<number>]

If this option is set, Kore will automatically teleport if an attack of a monster will deal you damage greater than or equal to the specified number.

Notes:

This option is ignored if teleportAuto_maxDmgInLock is set and you are in lockMap.
If you timely teleport due to attack from the monster, you will not receive any damage at all even if it is displayed in the console.

teleportAuto_maxDmgInLock [<number>]: If this option is set and you are currently inside your lockMap, Kore will automatically teleport if an attack of a monster inside the lockMap will deal you damage greater than or equal to the specified number.
Note. If you timely teleport due to attack from the monster, you will not receive any damage at all even if it is displayed in the console.

teleportAuto_minAggressives [<number>]: If this option is set, Kore will automatically teleport if the number of aggressive monsters attacking Kore is greater than or equal to the specified number.
Note. This option is ignored if teleportAuto_minAggressivesInLock is set and you are in lockMap.

teleportAuto_minAggressivesInLock [<number>]: If this option is set and you are currently inside your lockMap, Kore will automatically teleport if the number of aggressive monsters attacking Kore inside the lockMap is greater than or equal to the specified number.

teleportAuto_onlyWhenSafe [<boolean flag>]: If this option is set to 1, Kore will only use teleport when there are no players around to see it. If Kore needs to teleport but it has always been unsafe, Kore will only allow itself to teleport even when there are players to see when the time set in the timeout key ai_teleport_safe_force in timeouts.txt has elapsed since the last time you teleported.
Note. Because of the risk, Kore will never teleport in a city, regardless of this variable!

teleportAuto_portal [<boolean flag>]: If this option is set to 1, Kore will automatically teleport when near a map portal to avoid switching maps.
Note. This only works when you are inside your lockMap or if lockMap is not set.

teleportAuto_search [<number>]

If this option is set, Kore will enable searching for monsters whose search flag is set in mon_control.txt. If this is set, auto-attack will be deactivated by default and will only be activated when a search monster is found on screen. Such behavior allows Kore to continue moving around (random-walk) or teleporting (tele-search) until a search monster is found.

v.1.9.0 This option can specify the minimum number of search monsters that should be found on screen before activating auto-attack. For example, if this is set to 2, and you set Kore to search for Poporings, you will not start attacking monsters if there is only one Poporing found on screen.

Note. If you want to use tele-search, you must set teleportAuto_idle to 1 and route_randomWalk to 0.

teleportAuto_sp [<percent>]: If this option is set, Kore will automatically teleport if SP is below the specified percentage and there are aggressive monsters attacking you.

teleportAuto_unstuck [<boolean flag>]: If this option is set to 1, Kore will automatically teleport when it gets stuck while walking.

teleportAuto_useChatCommand [<chat command>] in SVN: Some RO servers allow you to teleport randomly without using a Fly Wing or the Teleport Skill by simply using a server-defined chat command (e.g. "@jump"). This option can be used to specify the chat command to use for random teleport. If this is set, teleportAuto_useSkill is ignored and Kore will instead send the chat command to the server to teleport.
See also saveMap_warpChatCommand for using chat commands to teleport back to your saveMap.

teleportAuto_useSkill [<flag>]

Use this option to specify how the bot should try to teleport.

Value	Description
0	Use items (Fly Wing or Butterfly Wing).
1	Use the Teleport skill normally (consume SP).
2	Use the Teleport skill and don't consume SP if there are no players around to see.
3	Use the Teleport skill and never consume SP.

Important. Using the Teleport Skill without SP consumption is an exploit that works only on official servers, not on eAthena or Freya servers. If you use this flag on eAthena or Freya servers, it will fail without warning.

Notes:

When you use the Teleport Skill normally, the "Teleport !!" message is shown on top of your head. On the other hand, if you use the skill without consuming SP, you will look as if you used a Fly Wing.
If you set Kore to use items to teleport but there are no items available, Kore will automatically try to use the Teleport Skill if it is available.
Conversely, if you set Kore to use the Teleport Skill but you don't have this skill, Kore will automatically try to use an item if one is available.

teleportAuto_totalDmg [<number>]

If this option is set, Kore will automatically teleport if the total amount of damage dealt to you by one monster is greater than or equal to the specified number.

Notes:

This option is ignored if teleportAuto_totalDmgInLock is set and you are in lockMap.
If you timely teleport due to attack from the monster, you will not receive any damage at all even if it is displayed in the console.

teleportAuto_totalDmgInLock [<number>]: If this option is set and you are currently inside you lockMap, Kore will automatically teleport if the total amount of damage dealt to you by one monster inside the lockMap is greater than or equal to the specified number.
Note. If you timely teleport due to attack from the monster, you will not receive any damage at all even if it is displayed in the console.

username [<username>]: This option specifies your username for logging into Ragnarok Online.
Note. You don't have to set this option. If you leave it empty, Kore will automatically ask you for your username at startup.

useSelf_item [<item names>] block: 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.
See the useSelf_item block details for more information on this block option.

useSelf_skill [<skill name>] block: Kore can automatically use skills on self when certain conditions are met. This block specifies the skill to automatically use on self.
See the useSelf_skill block details for more information on this block option.

useSelf_skill_smartHeal [<boolean flag>]: If this option is set to 1, Kore will use "Smart Healing" for all slots that use the Heal skill. With "Smart Healing" Kore will auto-detect what level of Heal to use based on HP left and SP available.
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 SVN.

verbose [<number>]

Internally, every message has a certain verbosity level that determines whether they should be printed in the console or not. A message's verbosity level must be lower or equal to the number set in this option for it to be displayed in the console.

The higher the value you set in this option, the more messages will be displayed in the console. If this option is set to 0, Kore will only print the most important messages (e.g. connection messages).

This option also controls whether Kore should reply to Chat Commands, and whether admin messages (e.g. the welcome text) will be shown in X-Kore.

verboseDomains [<message domains>]

If this option is set, certain messages grouped under the specified comma-separated list of message domains will always be printed in the console.

Notes:

Internally, Kore sets the verbosity level of message domains listed in this option to 0. See the option verbose for more information on verbosity.
See the references section for a list of known message domains.

XKore [<flag>]

This option toggles game client-reliant botting. If this is set to 1, Kore will run inside the real Ragnarok Online client whose filename is specified in exeName (or XKore_exeName if you are using Openkore SVN).

A new flag 2 is available in v.1.9.0 but it is highly recommended to use the SVN version for this as there are many fixed issues there. Visit the XKore 2 User's Guide for more info.

Value	Description
0	Disabled, no client connection.
1	XKore version 1, both client and server use same socket (XKore.pm).
2 in SVN	XKore version 2, kore-as-proxy, which reuses server-connection code from 0 (XKore2.pm).

XKore_bypassBotDetection [<boolean flag>] v.1.9.0: Set this option to 1 if you want Kore to try to bypass the RO client's bot detection.
Note. This feature is experimental and has only been tested with the iRO client, so enable this at your own risk!

XKore_exeName [<filename>] in SVN: If XKore is set to 1, this option specifies the name of the Ragnarok Online client executable (without the path) that will be used by X-Kore.
Note. Never mistake this to be the patch client. You have to distinguish between the patch client and the RO client.

XKore_silent [<boolean flag>]: By default, some Kore messages will be shown inside the Ragnarok Online client, as pink text. Set this option to 1 if you don't want to display Kore messages when using X-Kore.
Note. Even if this option is enabled, the output of commands you typed in the RO client will still be displayed as pink text.

Block Option Details

attackComboSlot [<skill name>]

Kore can automatically chain skills when attacking. This block can be used to specify a skill to automatically use after another skill was previously used (e.g. Monk combo attacks, Wizard Frost Diver + Jupital Thunder combo, etc.).

Syntax:

attackComboSlot [<skill name>] {
	afterSkill (<skill name>)
	dist [<number>]
	isSelfSkill [<boolean flag>]
	maxUses [<number>]
	waitBeforeUse [<seconds>]

	autoCombo [<boolean flag>] v.1.9.0

	# Skill Use Attributes
	# Self Conditions
	# 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 SVN.

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 SVN.

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 SVN: 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.

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

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.