config.txt : Reference

# config.txt

Current language: English | Change language

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

Quick search:

!include (filename)
  Use this option to include different files as part of config.txt. That makes it easier to reuse configurations. 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]
  Kore has the chat commands feature which allows other users on RO to send commands to Kore by using private messages. Only users who are authorized are allowed to control Kore. This option controls the authorization password.

  If this option is left blank, then Kore will automatically generate a random password, for security reasons.

alias_(alias name) (command)
  Sets up custom commands (like macros) for faster command issuing.

  Example:

        alias_fullheal ss 28 10
        alias_laagg c laaaagggggg

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

allowedMaps (list of maps)
allowedMaps_reaction (number)
  Exit or respawn if Kore is on a map other than the ones specified in list of maps. This is useful on pRO where GMs warp you to secret rooms.
  list of maps is a comma-seperated list of map names (example: `prontera,gef_fild01,moc_fild02`).

  allowedMaps_reaction specifies what to do.

  Value | Description
  --- | ---
  0 | Respawn.
  1 | Exit.

attackAuto (number)

  Value | Description
  --- | ---
  0 | Disable auto-attack. Do not automatically attack anything.
  1 | Automatically attack all monsters that attack you.
  2 | Automatically attack all monsters, whether they attack you or not.

attackAuto_followTarget (flag)
  Regardless of how attackAuto is set, this toggles automatic attacking of monsters that are attacking, or are being attacked by, the followTarget when you are following. These monsters have high priority.

attackAuto_inLockOnly (number)

  Value | Description
  --- | ---
  0 | Attack all monsters when walking to lockMap.
  1 | Only attack monsters that attack you, when walking to lockMap.
  2 | Do not attack any monsters when walking to lockMap.

  This option only has effect if lockMap is set. attackAuto overrides this setting (which means that, for example, if attackAuto is set to 0, Kore will never attack anything no matter what attackAuto_inLockOnly is set to).

attackAuto_onlyWhenSafe (flag)
  If enabled, only auto-attack when there are no people in the screen other than you and your party members.

attackAuto_party (number)
  Configures what to do with monsters that attacks party members.

  Value | Description
  --- | ---
  0 | Do nothing.
  1 | Automatically attack monsters that attacked party members, or monsters that are attacked by party members. These these party members have high priority.
  2 | Automatically attack monsters that attacked party members, but not monsters that are attacked by party members.

  Value 2 is useful if you're tanking a bot mage. If the mage casts on the monster before the monster has attacked the tanker, the monster might switch target.

attackCanSnipe (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 (flag)

  When set to 0, this will enable the new experimental LOS check code.

  If you are a ranged attacker (attackDistance > 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.

  This feature isn't perfect yet! It will frequently be unable to find a solution.

attackComboSlot (full skill name) {
...
afterSkill (full skill name)
dist (number)
isSelfSkill (flag)
maxUses (number)
waitBeforeUse (number)
}
  full skill name - Skill name from the Skills List (type 'skills' in Kore when logged in).

  This slot is tipically used to create a "skill loop" where a skill is executed right after another. It is most commonly used for monk's combo but it could be used for other skills as well.

  This configuration block also supports shared conditions, skill conditions and target conditions.

  afterSkill (full skill name)
    Kore will use this slot right after it detects that the skill specified in this option is executed.
  dist (number)
    This option specifies the distance (in blocks) from the monster that Kore will move to before using this skill.

    Only put the maximum distance here! Commas don't work.
  isSelfSkill (flag)
    Kore will use the specified skill on itself when flag is set to 1. Setting it to 0 (which is the default value) will cause kore to use the skill on the attack target. You must set this option to the correct value. For example, if you're trying to use Combo Finish, but you set this flag to 0, then 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.

    This attribute only counts successful usage. If a skill fails, Kore will continue to use the skill until it finally succeeds even if this is set to 1.
  waitBeforeUse (number)
    Kore will only use this skill after number seconds of the execution of afterSkill.

  Example:

        attackComboSlot Chain Combo {
        	lvl 5
        	dist 1.5
        	sp > 30
        	afterSkill Triple Attack
        	waitBeforeUse 0.02
        	isSelfSkill 1
        }

        attackComboSlot Combo Finish {
        	lvl 5
        	dist 1.5
        	sp > 30
        	afterSkill Chain Combo
        	waitBeforeUse 0.02
        	isSelfSkill 1
        }

attackDistance (number)
  number is the distance (in blocks) from the monster that Kore will move to before attacking with its weapon.

  Only put the maximum distance here! Commas don't work.

attackDistanceAuto (flag)
  If set to 1, automatically set attackDistance and attackMaxDistance by auto-detection.

attackMaxDistance (number)
  number specifies the farthest distance between you and the monster before Kore will try to move closer when attacking.

attackMaxRouteDistance (number)
  Kore will not move any more than number blocks to kill the target. Set to 0 to disable. This is used to prevent Kore from walking around long cliffs/walls just to kill a monster.

attackMaxRouteTime (number)
  Kore will not spend any more than number seconds calculating the route to the target. Set to 0 to disable.

attackMinPlayerDistance (number)
  Only auto-attack monsters that are at least number blocks away from other players. number is at least 3; if you enter a lower value, Kore will treat it as 3.

attackMinPortalDistance (number)
  Only auto-attack monsters that are at least number blocks away from a portal. If number is not set, Kore will treat it as 4.

attackNoGiveup (flag)
  When set to 1, will make bot not stop attacking enemy even if it can't damage it. Useful if your attackSkillSlot is e.g. Spell Breaker.

attackSkillSlot (full skill name) {
...
dist (number)
maxAttempts (number)
maxUses (number)
target_dist (range)
previousDamage (range)
isSelfSkill (flag)
}
  This option allows you to specify that you want to use a skill to attack a monster. Kore will use full skill name to attack monsters if the specified conditions are correct. If the conditions don't match for all specified skill slots, then Kore will use its weapon to attack. You can have as many skill slots as you want. Just put them all in the order you wish for them to be checked.

  This configuration block also supports shared conditions, skill conditions and target conditions.

  dist (number)
    Kore will move within number blocks distance if this slot is going to be used.

    Only put the maximum distance here! Commas don't work.
  maxAttempts (number)
    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)
    Specifies the maximum number of successful usage allowed for this skill.

    This attribute only counts successful usage. If a skill fails, Kore will continue to use the skill until it finally succeeds even if this is set to 1.
  target_dist (range)
    Use the skill only if the distance to the target is within range. See also: how to specify ranges.
  previousDamage (range)
    Use this skill only when your damage to the monster is between the specified range. This operator is useful if you want to select a skill level based on the damage already done on a monster. See below for an example.
  isSelfSkill (flag)
    Kore will use the specified skill on itself if flag is set to 1. Setting it to 0 (which is the default value) will cause kore to use the skill on the attack target. You must set this option to the correct value.

  ### attackSkillSlot examples

  Example:

        attackSkillSlot Bash {
            lvl 5
            maxUses 3
        }

        attackSkillSlot Magnum Break {
            lvl 3
            monsters Hode
        }

        attackSkillSlot Bowling Bash {
            lvl 10
            aggressives > 5
        }

  The above examples will allow Kore to:

  - Attack monsters with Bash level 5. But you will use this skill at most 3 times for each monster. After those 3 times, you will use normal attacks. Or, if the monster is a Hode, you will attack it with Magnum Break.
  - Attack monsters with Bowling Bash if more than 5 monsters are attacking you.

  ### previousDamage example

  Kore casts Fire Bolt lv 10 and does 7000+ damage on a Geographer. It now only has 1000 HP left, so you would want to cast a lower level Fire Bolt instead. Here's how you can do that:
  Example:

        # Use level 3 if you have dealt damage greater than 7000
        attackSkillSlot Fire Bolt {
        	lvl 3
        	dist 7
        	monsters Geographer
        	previousDamage > 7000
        }

        # Use level 10 otherwise
        attackSkillSlot Fire Bolt {
        	lvl 10
        	dist 7
        	monsters Geographer
        }

attackUseWeapon (flag)
  Tells Kore whether it should use its weapon in battle or not. When disabled, Kore won't move towards the enemy and attack with its weapon, instead it will rely on the attack skill slots. Most mages will want this option set to 0.

autoBreakTime (day)

  If set, Kore will automatically disconnect during certain times of the day. This option is useful if you want to make Kore not connect during the maintenance period, for example.

  day can be one of the following:

  - The first three letters of the week day.
  - The word all, which means every day in the week.
  Example:

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

  In this example, Kore will disconnect at 9:29 P.M. on Sunday and resume botting at 1:08 A.M. on Monday.
  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 hour clock format!

autoConfChange (filenames...) {
minTime (number)
varTime (number)
lvl (range)
joblvl (range)
isJob (job class)
}
  Configure Kore to automatically change configuration files. Kore will switch configuration file if all of the specified conditions are met.

  filenames
    A list of configuration file filenames, seperated by comma. A random file out of this list will be selected.
  minTime (number)
    Kore will wait at least number seconds, and at most `minTime + varTime` seconds before switching config file.
  varTime (number)
    See minTime.
  lvl (range)
    If set, Kore wil only switch if the desired level is reached.
  joblvl (range)
    If set, Kore wil only switch is desired level is reached.
  isJob (job class)
    If set, only switch config file if you're of the specified job.

autoMakeArrows (flag)
  If you have the Arrow Craft skill, this enables automatic arrow crafting. See control\arrowcraft.txt

autoResponse (flag)
  Enables or disables automatically responding to messages. You must also setup chat_resp.txt.

autoResponseOnHeal (flag)
  If enabled, automatically PM a person who uses Heal, Increase AGI, and Blessing on you or the monster you are attacking. The response can be configured in response.txt (Use skillgoodM when the supportive skills are used on you; skillbadM when the skills are used on your target monster).

autoRestart (flag)
  If enabled, Kore will automatically restart itself (disconnect and log back in). 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. You must also set autoRestartMin and autoRestartSeed.

autoRestartMin (seconds)
autoRestartSeed (seconds)
  Sets the time it takes before Kore initiates auto-restart. The formula is: time = autoRestartMin + rand(autoRestartSeed) which means that the time will be equal to the randomized value of autoRestartSeed added to the value of autoRestartMin.

  Example:

        autoRestart 1
        autoRestartMin 60
        autoRestartSeed 30

  In this example, Kore will automatically restart after a random period between 60 and 90 (=60+30) seconds.

autoRestartSleep (flag)
  Tells Kore to got into standby mode after it disconnects during auto-restart before connecting again. autoRestart must be correctly configured, or this option will do nothing. You must also set autoSleepMin and autoSleepSeed.

autoSleepMin (seconds)
autoSleepSeed (seconds)
  Similar deal with the autoRestartMin / autoRestartSeed time. And the time spent sleeping before a restart does not count as run time before the next restart.

autoSpell (full skill name)
  full skill name - Skill name from Skills List (type 'skills' in Kore when logged in). Not case sensitive.

  Sets the spell Kore will automatically cast during melee combat (sage skill Auto Spell). Combine this with a useSelf_skill for casting Auto Spell.

  Example:

        useSelf_skill Auto Spell {
        	lvl 10
        	timeout 10
        	notInTown 0
        	inLockOnly 0
        	whenStatusInactive Auto Spell
        	notWhileSitting 1
        	disabled 0
        }
        autoSpell Cold Bolt

  The above example causes Kore to cast the sage skill Auto Spell on itself if the status Auto Spell is not activated. The skill specified will be the skill Kore will automatically cast during melee combat. Take note that the last line is outside the useSelf_skill block.
  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_default_rightHand (weapon name)
autoSwitch_default_leftHand (weapon name)
autoSwitch_default_arrow [arrow name]
autoSwitch (monster name(s)) {
rightHand (weapon name)
leftHand [weapon name]
arrow [arrow name]
distance (number)
useWeapon (flag)
}
  Kore can use different weapons for different monsters. For example, it can use an elemental weapon for monster "Whisper", and normal weapons for everything else.
  The autoSwitch_default_* options specify what weapon you want to use as default weapon. The autoSwitch block specifies what weapon you want to use for what monsters.
  Remember to provide the full name of weapon including enchantment and cards (as displayed in the inventory list)! You can put multiple monster per weapon, separated by a comma. In case of bows, you can also specify the type of arrow to use.

  Example:

        autoSwitch_default_rightHand +5 Ice Claymore
        autoSwitch_default_leftHand
        autoSwitch_default_arrow

        autoSwitch Whisper {
        	rightHand +5 Earth Two-handed Sword
        	leftHand
        	arrow
        }

        autoSwitch Sohee,Obeaune {
        	rightHand +7 Wind Katana
        	leftHand
        	arrow
        }

  The above example uses "+5 Earth Two-handed Sword" for Whisper, "+7 Wind Katana" for Sohee and Obeaune, and "+5 Ice Claymore" for all other monsters.
  distance (number)
    Sets a temporary value for attackDistance when auto-switch occurs.
  useWeapon (flag))
    Sets a temporary value for >attackUseWeapon when auto-switch occurs.

autoTalkCont (flag)
  If set to 1, kore will automatically type 'talk cont' for you when you're in a conversation with an NPC.

avoidGM_namePattern (regular expression)
  In case your server uses non-standard GM names, you can specify a regular expression for GM names with this option.

avoidGM_near (number)
avoidGM_near_inTown (flag)
avoidGM_reconnect (seconds)
  Setup kore to perform an action when a Game Master is on screen.

  Value | Description
  --- | ---
  0 | Do nothing.
  1 | Teleport away & disconnect for avoidGM_reconnect seconds.
  2 | Disconnect for avoidGM_reconnect seconds.
  3 | Teleport away.
  4 | Respawn.

  If you set avoidGM_near_inTown to 0, and Kore encounters a GM while you are in town, then Kore will do nothing.

avoidGM_talk (flag)
  Setup kore to disconnect when a Game Master sends you a private message.

avoidList (flag)
avoidList_inLockOnly
  Enables or disables avoid list (avoid.txt).

  Set avoidList_inLockOnly to 1, if you want to avoid people in avoid list (avoid.txt) when they are on screen, but only if you are in lockMap.

avoidList_reconnect (number of seconds)
  How long it will sleep after disconnecting due to avoid list matches.

avoid_ignore_0 (player0)
avoid_ignore_1 (player1)
...
avoid_ignore_# (player#)
  Lists names you want to exclude from the avoidGM options. Replace # with any positive integer as index.

beepDomains (list)
  list - a list of message domains.

  Kore will beep when a message whose domain is in list is printed.

beepDomains_notInTown (list)
  list - a list of message domains.

  Lists message domains that are exempted from beepDomains if you are in a town.

bindIp (IP address)
  If your computer has multiple IP addresses, you can select which one to use. When unsure, you should leave this option empty. This cannot be used for proxying!

buyAuto (item name) {
npc (NPC location)
standpoint [location]
minAmount (number)
maxAmount (number)
distance (number)
}
  Setup Kore to automatically buy an item from the specified NPC, if there are less than minAmount amount in inventory.

  item name
    The full name of the item that you want to buy.
  npc
    The location of the NPC that sells the item (see also: How to specify locations). This NPC must have the item available for purchase.
  standpoint
    If the NPC is located on an unreachable place (for example, behind a desk), which makes Kore unable to calculate a route to the NPC, then you can manually specify a stand point here. Kore will walk to this (reachable) location instead. You are not required to set this option so you can leave it empty. See also: How to specify locations.
  distance
    Specifies how far Kore will stay away from the NPC. Usually you can just leave it at the default value (5).
  minAmount
    Kore will go to the NPC, when there are less than number amount in inventory.
  maxAmount
    Kore will buy number amount of the item.

  You have have as many buyAuto blocks in your configuration file as you want. Each block specifies a different item.

  #### 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. For example, if you use many types of pots it might only be worth going back to town when you've depleted your Orange Potions. You'd leave the minAmount empty for the Red Potion block, and set minAmount to 0 for the Orange Potion block.

  Example:

        buyAuto Red Potion {
            npc prontera 123 456
            standpoint
            minAmount 2
            maxAmount 30
            distance 5
        }

        buyAuto Blue Gemstone {
            npc prt_in 213 412
            standpoint prt_in 213 408
            minAmount 4
            maxAmount 10
            distance 5
        }

  The above examples have the following effect:

  - Kore will buy 30 Red Potions when it has 2 or less Red Potions in inventory. It will go to the NPC located at prontera 123 456 to buy the potions. It will stand 5 blocks away from the NPC when buying the potions.
  - Kore will also buy 10 Blue Gemstones when it has 4 or less Blue Gemstones in inventory. It will buy from the NPC located at prt_in 213 412. However, that NPC is behind a desk, and Kore cannot calculate a path to the NPC behind a desk, so Kore will walk to the location specified by standpoint instead: prt_in 213 408.

callsign (name)
  This callsign must be used when using Chat Commands from Public Chat (not needed for Party Chat and Private Messaging). The callsign is not case sensitive. Example: "kore, sit" - would cause Kore to sit.

char [number]
  Specify the character to login as from the character select server. You have a choice of up to 5 characters. You can leave this option empty - Kore will automatically ask you to choose a character.

  number - your first character is number 0, second is 1, third is 2, etc.

chatLangCode [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 can set this option to 0.

  You don't have to set this option. When you choose a server at Kore's startup, Kore will automatically set the correct chatLangCode for the chosen server.

  This is the option which will make your chat appear with |00 in front of it, if you use this option on servers you should not.

chatTitleOversize (flag)
  Set flag to 1 will enable shop title and chatroom title to be more than 36 characters . Only use this option if you know what you are doing.

commandPrefix (string)
  If you're running in X-Kore mode, and you send a message using the Ragnarok Online client, then all messages that begin with string will be intercepted by Kore and interpreted as commands.

dcOnDeath (number)
  Tells Kore what to do when it's dead.

  Value | Description
  --- | ---
  -1 | Do nothing. Do not respawn.
  0 | Respawn after a short while.
  1 | Disconnect. This is useful in order to prevent Kore walking back to lockMap and getting killed again.

dcOnDisconnect (flag)
  If this is set to 1, exit (don't reconnect) when you get disconnected from the server.

dcOnDualLogin (number)
  If a dual login error is detected (someone else accessing the account) then Kore will reconnect after number seconds. Set to 1 to make Kore quit entirely, any other value will be interpreted as seconds.

dcOnEmptyArrow (flag)
  If set to 1, automatically disconnect when you have no more arrows.

dcOnMute (flag)
  If set to 1 then disconnect when you have been muted by a GM.

dcOnPM (flag)
  Disconnect when somebody sends you a PM.

dcOnZeny (zeny)
  Disconnects from the Ragnarok server when the total amount of zeny is lower than the zeny provided.

dealAuto (number)
  Specifies what to do with incoming deals.

  Value | Description
  --- | ---
  0 | Don't do anything with incoming deals.
  1 | Automatically cancel all deals.
  2 | Automatically accept all deals, and immediately finalize/trade.
  3 | Automatically accept all deals; finalize and trade after the other party finalizes.

debug (level)
  level - 0 (off), 1 (low), 2 (high)

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

debugDomains (list)
  Lists debug message domains that you want to show in the console. The setting squelchDomains overrides this.

debugPacket_*
  Packet debugging options, only useful for developers. Don't mess with these unless you know what you are doing.

  debugPacket_unparsed (flag)
    Toggles unparsed packet dumping.
  debugPacket_received (flag)
    Toggles the displaying of all received packet switches.
  debugPacket_ro_sent (flag)
    Toggles the displaying of packet switches sent by the RO client (only in X-Kore mode).
  debugPacket_sent (flag)
    Toggles the displaying of packet switches sent by Kore.
  debugPacket_exclude (packet switches)
    packet switches - The first 2 bytes of recieved packets in reversed order. (e.g. 8A 23 -> 238A)
    All packets switches that you want to ignore, seperated by a comma.(example: debugPacket_exclude 008A,0123)

encrypt (number)
  number - 0 (off), 1 (encryption mode 1), 2 (encryption mode 2)

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

equipAuto (equipment name) {
...
def (default equipment name)
skills (list)
onTeleport (flag)
weight (percent)
whileSitting (flag)
}
  Kore will automatically attempt to equip equipment name when all of the specified conditions match. equipment name must be the name of an armor in your inventory. This configuration block cannot be used for weapons: for weapons, use autoSwitch instead.

  This configuration block also supports shared conditions.

  def (default equipment name)
    If specified, then Kore will automatically switch back to default armor name when the specified conditions no longer match.
  skills (list)
    Switch to this equipment when attempting to use any of the listed skills. list is a list of skill names, seperated by comma.
  onTeleport (flag)
    Switch to this equipment when attempting to teleport. This does not apply for teleportAuto_deadly.
  weight (percent)
    Switch to this equipment when weight is at or above the given percent.
  whileSitting (flag)
    Auto-equip while sitting.

exeName (filename)
  Specifies the filename of the Ragnarok Online client that will be used by X-Kore. Normally, this is not changed. However, if you intend to utilize X-Kore with a private server client that uses a different client exe name (such as qRO), this must be changed to match.

follow (flag)
  Toggles player following. If on, and followTarget is set, Kore will follow that person.

followBot (flag)
  Specifies that followTarget is a Kore bot. When 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.

followCheckLOS (flag)
  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 (maximum number)
followDistanceMin (minimum number)
  Kore will try to never be further away from the followTarget than than maximum number blocks, and never closer than minimum number blocks.

followEmotion (flag)
followEmotion_distance (number)
  When follow and followEmotion are enabled, Kore will imitate the master's emoticons if he's within number blocks distance.

followFaceDirection (flag)
  If enabled, always look at the follow target when following.

followLostStep (number)
  If lost, Kore will move towards where the followTarget was last seen. By default, Kore will move number blocks every second, for about 10 seconds. You probably shouldn't have to change this option.

followSitAuto (flag)
  When enabled, Kore will sit/stand when the followTarget sits/stands.

followTarget (player name)
  If follow is enabled, Kore will follow player name.

getAuto (item name) {
minAmount (number)
maxAmount (number)
passive (flag)
}
  If set, Kore will get item name from Kapra storage, when it has less than minAmount of a certain item. It will get maxAmount items from storage.

  The location of the Kapra NPC is defined in storageAuto_npc. getAuto only has effect if storageAuto is correctly configured.

  item name is case sensitive. So you have to write "Sweet Potato", not "sweet potato".

  passive toggles if auto-get will be initiated once the minAmount has been reached (off), or if auto-get will go with auto-store(on).

  Example:

        getAuto Red Potion {
        	minAmount 1
        	maxAmount 10
        	passive 0
        }

        getAuto Fly Wing {
        	minAmount 2
        	maxAmount 40
        	passive 0
        }

  When you have 1 or less Red Potions in inventory, Kore will go to storage to get 10 Red Potions. Or, when you have 2 or less Fly Wings in inventory, Kore will go to storage to get 40 Fly Wings.

guildAutoDeny (flag)
  Toggles the denial of guild invitations.

  If on, whenever Kore is invited by someone to join a guild, it will automatically deny the request.

ignoreAll (flag)
  Automatically blocks all PMs.

  This is like /exall when using the official Ragnarok Online client.

ignoreInvalidLogin (flag)
  Ignore the "Account doesn't exist" error message.

intervalMapDrt (number)
  Setup interval in seconds where Kore will save its coordinates to be used by mapview.p

itemHistory (flag)
  Toggles the logging of loots in items.txt

itemsGatherAuto (number)
  Toggles auto-gather of items. When on, Kore will pickup items that aren't surrounded by any players. It's smart, non-intrusive looting.

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

itemsMaxWeight (percentage)
  Kore will stop picking up items when its weight is percentage or greater.

  Example:

        itemsMaxWeight 48

  This would make Kore stop picking up items when it reaches 48% of its carry-weight.

itemsMaxWeight_sellOrStore (percentage)
  Kore will sell or go to storage if weight equals or is bigger than percentage. While walking to the sell/storage NPC, Kore will pick up loot as long as your weight is under the percentage specified by itemsMaxWeight.

itemsTakeAuto (number)
  Controls what Kore should do with loot.

  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_party (flag)
  If on, Kore will take items from monsters killed by party members.

lockMap (map name)
lockMap_x (x-coordinate)
lockMap_y (y-coordinate)
lockMap_randX (number)
lockMap_randY (number)

  map name - Name of target map as displayed by the Ragnarok Online client when you type /where (e.g. prt_fild00)

  If lockMap is set, then Kore will attempt to walk back to map name when it's on another map. Keep in mind that with this option on, if you die, Kore will first auto-sit and regenerate before walking.

  If lockMap_x and lockMap_y are set, then Kore will attempt to walk to the specified coordinates in map name.

  If lockMap_randX and lockMap_randY are set, Kore will stay at a random spot within these distances away from the specified coordinates in the lock map.

logChat (flag)
logPrivateChat (flag)
logPartyChat (flag)
logGuildChat (flag)
logSystemChat (flag)
  Toggles the logging of chat data into chat.txt

logEmoticons (list)
  Lists emoticon numbers that you want to log in chat.txt. See tables\emotions.txt for a list of available emoticon numbers. A value of 'all' means you want to log all emoticons.

logToFile_Debug (domainlist)
logToFile_Errors (domainlist)
logToFile_Messages (domainlist)
logToFile_Warnings (domainlist)
  Enables the logging of Messages,Errors,Warnings and Debug infos to Files. This option is only interesting for Developers or if you want to save special domains to a file. The files are created in you Log folder.

  domainlist syntax is:
  domain=filename
  domain=filename1,filename2
  domain1=filename1;domain2=filename2,filename3

  Example:

        logToFile_Debug parseMsg=messages.txt

        This would all debug messages for the parseMsg domain to messages.txt

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

        This would log all selfSkill messages to selfskill.txt and all used items to usedItems.txt

master [name]
  name - A corresponding name from the master server list (as found in tables/servers.txt).

  This option specifies what master server Kore should log in to (whether you want Kore to login to iRO, oRO, pRO, etc.). You don't have to set this option. When you start Kore for the first time, it will automatically ask you to select a master server from a list. (If you want to change that list, edit tables/servers.txt)

message_length_max (number)
  number - Message length in characters

  All outgoing chat will be divided intelligently into messages of number length. You shouldn't change this option unless you know what you're doing.

missDamage (number)
  Any damage you do <= number will be counted as a miss.

  This option is 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 (flag)
  If set to 1, this will enable the logging of monsters killed in logs\monsters.txt.

monsterSkill (full skill name) {
...
target (list of monsters)
maxUses (number)
}
  Kore will use the specified skill on any monster that attackAuto would eventually attack, if the conditions are met. Unlike attackSkillSlot, this enables you to use skills on monsters that you are not currently attacking (e.g. for offensive-Blessing monsters that are attacking you, or for Provoking every monster on screen).

  This configuration block also supports shared conditions, skill conditions and target conditions.

  target (list of monsters)
    Only use this skill on the specified monsters when these monsters are seen.
  maxUses (number)
    Specifies the maximum number of successful usage allowed for this skill.

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

  Example:

        monsterSkill Blessing {
            lvl 1
            maxUses 1
            target Deviruchi,Khalitzburg
        }

  Use Blessing level 1 on all Deviruchi and Khalitzburg attacking you, no matter what monster you are currently fighting.

noAutoSkill (flag)
  If set to 1, this disables all auto-skills.

partyAuto (number)

  Value | Description
  --- | ---
  0 | Don't do anything with incoming party requests.
  1 | Automatically denies all party requests.
  2 | Automatically accepts all party requests.

partyAutoShare (flag)
  If set to 1, Kore will automatically set party EXP sharing to 'Even Share' on connect.

partySkill (full skill name) {
...conditions...
target (list)
target_hp (range)
target_isJob (list)
target_isNotJob (list)
target_notWhileSitting (flag)
target_whenStatusActive (status name)
target_whenStatusInactive (status name)
target_aggressives (range)
target_monsters (list)
target_timeout (number)
target_defendMonsters (monsters)
target_whenGround (list)
target_whenNotGround (list)
target_dead (flag)
}
  Kore will use full skill name on a party member, when all of the specified conditions match.

  This option also supports shared conditions and skill conditions.

  target (list)
    If this option is specified, then Kore will only use this skill on the characters specified in list. Otherwise the skill will be used on all party members. list is a list of party member names, seperated by comma.
  target_hp (range)
    Only use the skill if the party member's HP percentage is within range. See also: how to specify ranges.
  target_isJob (list)
    Only use the skill if party member's is one of the specified jobs. list is a list of job names, seperated by comma (example: Acolyte,Archer,Knight).
  target_isNotJob (list)
    Only use the skill if party member's is not one of the specified jobs.
  target_notWhileSitting (flag)
    Only use the skill when the party member is not sitting.
  target_whenStatusActive (list of status names)
  target_whenStatusInactive (list of status names)
    Only use the skill if the specified statuses are active/inactive for the party member. status names is case sensitive! Currently, known statuses for party members are lost when the party member leaves your screen, so timeouts may be more appropriate. See whenStatusActive for more information about statuses.
  target_aggressives (range)
    Only use the skill if the number of monsters attacking the party member is in the given range. See also: how to specify ranges.
  target_monsters (list)
    Only use the skill if any of the listed monsters are attacking the party member. list is a list of monster names, seperated by comma.
  target_timeout (number)
    Wait number seconds before using this skill again. This is different from timeout because it is for each individual person, not for yourself.
  target_defendMonsters (monsters)
    Example:

          partySkill Pneuma {
              lvl 1
              target_defendMonsters Raydric Archer
          }

    Only cast this skill if a Raydric Archer's last attack hit the person.
  target_whenGround (list)
  target_whenNotGround (list)
    Only use the skill if the ground under a party member is of a type listed in target_whenGround and if the ground is not of a type listed in target_whenNotGround. See whenGround for more information about ground types.
  target_dead (flag)
    If enabled, only use this skill when the target is dead. Use this for Resurrection.

  ### partySkill examples

  Example:

        partySkill Heal {
            lvl 3
            target_hp < 40
        }

        partySkill Blessing {
            lvl 10
            target_whenStatusInactive Blessing
        }

  The above examples will allow Kore to:

  - Heal a party member with level 3 Heal when his HP is below 40.
  - Use Blessing level 10 on a party member, whenever his Blessing runs out.

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]
  Your password for logging into Ragnarok Online. You don't have to set this option. If you leave it empty, Kore will ask you for your password at startup.

pauseMapServer (seconds)
  Pause for seconds before connect to map server (sometimes the server is slower than the bot).

portalRecord (number)

  Value | Description
  --- | ---
  0 | Don't automatically record portals.
  1 | Record portals you walk through.
  2 | Record the return portal too (by guessing).

relogAfterStorage (flag)
  Relogin after performing autostorage. This works around a server bug which causes autostorage to fail when you do it the second time.

route_maxWarpFee (zenny amount)
  Specify the maximum amount of money you're willing to spend on a Kapra which teleports you to another map.

route_randomWalk (number)
  If enabled, Kore will regularly walk to random spots on the current map. While walking to the destination, Kore will attack monsters, if attackAuto is properly set.

  Value | Description
  --- | ---
  0 | Don't automatically walk around.
  1 | Walk around and go through portals to reach other areas of the map (i.e. Culvert).
  2 | Don't walk through any portals while doing random walk.

route_randomWalk_maxRouteTime (number)
  Kore will not spend any more than number 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)
  Kore will move number amount of blocks along the route at a time. You should probably leave this option at the default value (15).

route_teleport (flag)
route_teleport_minDistance (minimum distance)
route_teleport_maxTries (number of tries)
  When route_teleport is enabled, and Kore is walking to a certain map, then Kore will teleport until it's minimum distance steps away from the destination portal. Kore will attempt to teleport at most number of tries times per map. If it fails to get near the portal in that many teleport tries, then it will walk to the portal.

  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.

route_teleport_notInMaps (list of maps)
  Do not teleport on route in the specified maps.

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

  #### Note.

  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.

saveMap (map name)
  Specify the name of the map where your character is saved. The character MUST have saved in that map for Kore to be able to respawn to that map.

  map name is the name of target map as found as shown by the `where` command in Kore, or the `/where` command in the Ragnarok Online client. For example: prontera, morocc, prt_fild08, etc.

saveMap_warpToBuyOrSell (flag)
  If enabled, Kore will warp to to the save point specified by saveMap before doing auto-buy, auto-sell, or auto-storage.

secureAdminPassword (flag)
  Generates a random adminPassword everytime you Kore.

secureLogin (flag)
  Toggle encrypted login method. Some servers (such as idRO) use secure logins. Do not enable this option for servers that don't use secure login!

secureLogin_requestCode (code)
  code - a string of hexadecimal numbers, seperated by whitespace.

  If none of the numbers for secureLogin_type works, then you can try this option. If set, secureLogin_type is ignored. code depends on your server: try searching the forums for the correct code for your server.

  If you're playing on Indonesian RO, and you use VisualKore, then you don't have to set this option. VisualKore will automatically download the latest (correct) secure login code from the Internet.

secureLogin_type (number)
  number - Set to 0 to disable. Or 1, 2, 3, 4 or 5 to enable. The number depends on your server. Do trial-and-error if you're not too sure.

  This option only has effect if secureLogin is enabled.

sellAuto (flag)
sellAuto_distance (distance)
sellAuto_npc (NPC location)
sellAuto_standpoint (standpoint location)
  Enables or disables auto-selling. If enabled, Kore will walk back to town to sell items in your inventory when your weight is equal or greater than the percentage specified by itemsMaxWeight_sellOrStore.

  NPC location is the location of an item buy/sell NPC (see also: How to specify locations). Kore will use this NPC to sell items.

  standpoint location specifies a location to be used as a standpoint instead of anywhere near the item buy/sell NPC itself. If this is not set, Kore will stand distance blocks away from the NPC.

  #### Note

  To configure which items you want to sell, you have to edit items_control.txt.

server [number]
  number is a corresponding number from the server list. This list is shown to you when you first login to a master server.

  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 for the first time.

serverType [number]
  Defines what kind of server you're playing on.

  Value | Description
  --- | ---
  0 | Normal server
  1 | oRO (Oceania)
  2 | pRO (Philippines)
  3 | eAthena SVN
  4 | Freya

  You don't have to set this option. It's automatically set for you when you select a server when you run Kore for the first time.

sex [flag]
  flag - 0 (Girl), 1 (Boy)

  When logging in you can force your sex to be flag. 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.

shopAuto_open (flag)
  When set to 1, Kore will automatically open a shop when you sit (if sitAuto_idle is also set). To configure what items you want to put in your shop, edit shop.txt.

shopTitleOversize (flag)
  Setting flag to 1 will enable shop title title length longer than 36 characters. Only set this option if you know you're doing.

shop_random (flag)
  (default is 0, hidden) Sets wheter the order of items in your shop are randomized (1) or in the same order as shop.txt (0).

showDomain (flag)
  If set to 1, Kore will display domains along with messages.

showTime (flag)
  Show a high resolution time (in seconds and microseconds) in front of messages.

showTimeDomains (list)
  Show a timestamp in front of messages from the list of domains.

showTimeDomainsFormat (format)
  Format the timestamp shown in front of messages from domains listed in showTimeDomains according to the given pattern. Use the characters H (hour), M (minutes), S (seconds), y (year), m (month), and d (day) for your format.
  Example:

        showTimeDomains pm
        showTimeDomainsFormat H:M:S d/m/y

  This example will show a timestamp similar to 6:31:20 7/14/2005 when a pm is received.

sitAuto_hp_lower (low percentage)
sitAuto_hp_upper (high percentage)
sitAuto_sp_lower (low percentage)
sitAuto_sp_upper (high percentage)
  Kore will stop attacking and sit when HP or SP are below low percentage, and will resume when HP and SP are above high percentage.

  For example, if you want to sit when your HP is lower than 20%, and wait until your HP is higher than 90%, then write this:

  Example:

        sitAuto_hp_lower 20
        sitAuto_hp_upper 90

sitAuto_idle (flag)
  If set to 1, Kore will sit when it's doing nothing (not walking, not attacking - nothing).

sitAuto_look (direction)
  This option is still bugged in version 1.6.1. Fixed in CVS.

  direction: A number between 0 and 7, each representing a different direction. See tables\directions.txt for details on these values.

  If specified, this is the direction you look while doing sitAuto.

sitAuto_over_50 (flag)
  If enabled, forces the bot to sit even when overweight.

skillsAddAuto (flag)
  Enable or disable automatic raising of skills. Similar to statsAddAuto, but works on skills. You must also specify skillsAddAuto_list so Kore knows what skills to raise.

skillsAddAuto_list (list)
  list - list of skills and levels, seperated by comma.

  In this option you can specify what skills you want Kore to automatically raise for you. This option only has effect if skillsAddAuto is enabled.

  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 will sleep for 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 (list)
  list - a list of message domains, seperated by comma.

  Sets the verbosity of messages to 5, if the message is in the domain specified list. For example, write "squelchDomains skill" if you don't want your vendbot to be spammed by people using skills in town.

statsAddAuto (flag)
  Enable or disable automatically adding of stat points. See also statsAddAuto_list.

statsAddAuto_dontUseBonus (flag)
  If set to 1 then statsAddAuto will not factor in the stat bonuses at all.

statsAddAuto_list (stats)
  This option specifies what stat points to add. Note: Job bonus is counted too! If you don't want that, then set statsAddAuto_dontUseBonus to 1.

  Example:

        statsAddAuto_list 30 vit, 99 agi

  In this example, the bot will continue to add stats to vit first. After it reaches 30 vit it will add points to agi until it's 99.

storageAuto (flag)
storageAuto_distance (minimum distance)
storageAuto_npc (NPC location)
  storageAuto enables or disables auto-storing. When storageAuto is enabled, Kore will walk back to town to put items in storage when the current weight exceeds the percentage specified by itemsMaxWeight_sellOrStore.
  Kore will use the NPC specified by NPC location, and will stand minimum distance blocks away from the NPC.

  #### Related

  - You can specify what items you want Kore to put in storage by editing items_control.txt.
  - How to specify NPC locations.

storageAuto_notAfterDeath (flag)
  If this option is enabled, Kore will not automatically do storage and selling when it dies.

storageAuto_npc_type (number)
storageAuto_npc_steps (code)
  Some Kapra NPCs require different conversation steps. storageAuto_npc_type allows you to specify what kind of NPC it is:

  Value | Description
  --- | ---
  1 | Normal NPC (NPC conversation code: c r1 n).
  2 | Comodo NPC (NPC conversation code: c c r1 n).
  3 | Other NPC.

  If you specified 3 for storageAuto_npc_type, then you must manually specify the exact steps is needed in storageAuto_npc_steps. code an NPC conversation code. Note that storageAuto_npc_steps is only used if storageAuto_npc_type is set to 3.

  For example, if your Kapra 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 (number)
  Required for servers that needs a password to use storage.
  This option is related to storageEncryptKey .
  Example:

        storageAuto_password 1234

storageAuto_useChatCommand (command)
  Use a specified chat command to open the storage instead of going to talk to the kafra.
  Example:

        storageAuto_useChatCommand @storage

storageEncryptKey (key)
  key - Crypton encryption key that RO uses.

  The key might change from time to time depending on the server.
  Required for servers that needs a password to use storage (such as mRO).
  A detailed guide on how to obtain the key is still not available at the moment.
  For the time beign, use amacc_boy's Packet-Extractor + Storage Encrypt Key Extractor (note you have to login to the forum first before clicking on the link).

  This option is related to storageAuto_password .

  Example:

        storageEncryptKey 0x050B6F79, 0x0202C179, 0x00E20120, 0x04FA43E3, 0x0179B6C8, 0x05973DF2, 0x07D8D6B, 0x08CB9ED9

tankersList (list)
  list - a comma-seperated lists of player names that should be treated as if they were in your party so they can tank monsters for you.

tankMode (flag)
tankModeTarget (player name)
  If tankMode is enabled, and player name is in Kore's screen, then Kore will tank for player name by only hitting monsters once.

teleportAuto_*

  teleportAuto_useSkill (number)
    Use this option to specify how the bot should try to teleport.

    Value | Description
    --- | ---
    0 | Use Fly Wing/Butterfly Wing item to teleport. If that's not available, use the Teleport skill if available.
    1 | Use the Teleport skill and always show the "Teleport !!" message on top of your head when teleporting. If the Teleport skill is not available, Fly Wing or Butterfly Wing items will be used if available.
    2 | Use the Teleport skill and only show the "Teleport !!" message on top of your head when teleporting if there are other players on screen. If the Teleport skill is not available, Fly Wing/Butterfly Wing will be used if available.
    3 | Use the Teleport skill and never show the "Teleport !!" message on top of your head when teleporting. If the Teleport skill is not available, Fly Wing/Butterfly Wing will be used if available.

    Explanation for 2 and 3: If the "Teleport !!" message on top of your head is not shown, no SP will be used when teleporting. This only works on official servers, not on eAthena or Freya servers.

  teleportAuto_hp (percent)
    Automatically teleport if HP is below the specified percentage and there are aggressive monsters attacking you. Set to 0 to disable this option.
  teleportAuto_sp (percent)
    Automatically teleport if SP is below the specified percentage and there are aggressive monsters attacking you. Set to 0 to disable this option.
  teleportAuto_idle (flag)
    Toggles automatic teleporting after being idle for a certain amount of time. The idle time is defined by ai_teleport_idle in timeouts.txt.
  teleportAuto_portal (flag)
    Toggles automatic teleporting when near a map portal to avoid switching maps. This only works when you're in lockMap.
  teleportAuto_search (flag)
    Toggles the teleporting options in mon_control.txt.

    You must set teleportAuto_idle to 1 and route_randomWalk to 0 for this to work.
  teleportAuto_minAggressives (number)
    Specifies how many aggressives need to attack the bot before random teleport is used. Set to 0 to disable this option.

    This option is ignored if teleportAuto_minAggressivesInLock is set and you are in lockMap.
  teleportAuto_minAggressivesInLock (number)
    Specifies how many aggressives need to attack the bot in lockMap before random teleport is used. Set to 0 to disable this option.
  teleportAuto_onlyWhenSafe (flag)
    If enabled, Kore will only use teleport when there are no players around to see it. If not safe for 2 minutes (default), Kore will force it to be safe (see ai_teleport_safe_force in timeouts.txt).

    Because of the risk, Kore will never teleport in a city, regardless of this variable!
  teleportAuto_maxDmg (number)
    Specifies how much damage the bot needs to take in a single hit from one monster before random teleport is used. Set to 0 to disable this option.

    This option is ignored if teleportAuto_maxDmgInLock is set and you are in lockMap.
  teleportAuto_maxDmgInLock (number)
    Specifies how much damage the bot needs to take in a single hit from one monster in lockMap before random teleport is used. Set to 0 to disable this option.
  teleportAuto_deadly (flag)
    Toggles automatic teleporting when the next hit of a monster could kill you. If successfully done, the attack won't actually hit you.
  teleportAuto_emptyName (flag)
    Indicates whether to use random teleport if a player with empty name is on screen.
  teleportAuto_allPlayers (flag)
    Indicates whether to use random teleport to avoid all players on screen.
  teleportAuto_atkCount (number)
    Teleport away if Kore can't kill the monster in the specified number of attacks.
  teleportAuto_atkMiss (number)
    Specifies how many times the bot needs to MISS a monster before random teleport is used. For example, this is useful if you're trying to attack a monster with the wrong elemental weapon. Set to 0 to disable this option.
  teleportAuto_unstuck (flag)
    Indicates whether to use random teleport if the bot gets stuck while walking.
  teleportAuto_dropTarget (flag)
    Indicates whether to use random teleport if the bot drops a target.
  teleportAuto_attackedWhenSitting (flag)
    Indicates whether to use random teleport if the bot gets hit by a monster while sitting.
  teleportAuto_totalDmg (number)
    The bot will teleport after one monster does this much total damage to it. Set to 0 to disable this option.

    This option is ignored if teleportAuto_totalDmgInLock is set and you are in lockMap.
  teleportAuto_totalDmgInLock (number)
    The bot will teleport after one monster in lockMap does this much total damage to it. Set to 0 to disable this option.

username (username)
  Your username for logging into Ragnarok Online.

useSelf_item (list of item names) {
...conditions...
}
  list of item names - A list of item names, seperated by comma.
  conditions - see shared conditions.

  Kore will use the specified item(s) when all conditions in conditions match.

  The useSelf_item configuration block is typically used for consuming healing items and speed potions.

  Example:

        useSelf_item Red Herb,Yellow Potion {
            hp < 50
        }

        useSelf_item Green Potion {
            whenStatusActive Poisoned
        }

  The above examples will:

  - Allow you to use Red Herb (or Yellow Potion, if no Red Herbs are available) if your HP is less than 50%.
  - Allow you to use Green Potion on yourself when you have the "Poisoned" status (this status is active when you are poisoned).

useSelf_skill (full skill name) {
...conditions...
smartEncore (flag)
}
  Kore will use the specified skill on itself when the specified conditions match. This configuration block supports shared conditions and skill conditions.

  smartEncore (flag)
    Toggles automatic casting of the Encore skill instead of this skill if Encore would cause this skill to be cast (saves SP for bards and dancers).

  Example:

        useSelf_skill Heal {
            lvl 10
            hp < 70
            sp > 10
            notWhileSitting 1
        }

        useSelf_skill Twohand Quicken {
            lvl 10
            whenStatusInactive Twohand Quicken
        }

  The above examples will allow Kore to:

  - Use Heal level 10 on yourself when your HP is below 60%, but only if your SP is above 10%.
  - Use Twohand Quicken level 10 whenever it runs out (whenever the status "Twohand Quicken" is inactive).

useSelf_skill_smartHeal (flag)
  Tells Kore to 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.

verbose (flag)
  Toggles Kore's responses to Chat Commands, and toggles messages received in-game from X-Kore.

verboseDomains (list)
  verboseDomains is the opposite of squelchDomains.

version (number)
  The RO version used internally to verify that your version is up to date. You must not specify this option, it's filled in automatically for you when you choose a server from the server list at startup. However, if you need to connect to a server not specified in servers.txt, this must be filled in.

XKore (flag)
  Toggles game client-reliant botting. When on, Kore will run inside the real Ragnarok Online client.

XKore_silent (flag)
  By default, some Kore messages will be shown inside the Ragnarok Online client, as pink text. If you don't want that to happen, set this flag to 1. However, if you type any commands into the RO client, the output will still be displayed as pink text.

## More about configuration blocks

### Shared conditions

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

disabled (flag)
  This will temporarily disable a block completely.
whenIdle (flag)
  Use only when the bot is doing nothing.
hp (range)
sp (range)
  Only use this block if Kore's HP/SP % are within the given range.
aggressives (range)
  Only use this block if the amount of monsters attacking Kore is within the given range. This is useful if you are a Swordsman and want to use Magnum Break when there are many monsters attacking. You could setup the slot with Magnum Break and set range to >= 3 (this means 3 or more).

  Aggressive monsters are identified by Kore as those who are attacking you (monsters moving towards you are not yet considered aggressive). See mon_control.txt on how to make Kore identify monsters who are not yet attacking you as "aggressive".

partyAggressives (number)
  Condition works like aggressives, but also counts monsters that have fought party members.
stopWhenHit (flag)
  If set to 1, this block will not be used when being hit by a monster (skill casting which can be interrupted, for example).
whenFollowing (flag)
  If set to 1, this block will only be used if Kore is following someone.
whenStatusActive (list)
  Only use if at least one of the listed status is active.

  list is a comma separated list of status names. Status names are case sensitive!

  Statuses can be found by typing "s" in the console while the status is active, or in the tables folder, in the files skillsailments.txt, skillslooks.txt, skillsstate.txt, and skillsstatus.txt.

whenStatusInactive (list)
  Only use if all of the listed status is inactive. See additional notes in whenStatusActive.
onAction (AI sequence)
  Only use this block if the specified AI sequence is active. Useful ones to know are "route" and "attack".
spirit (range)
  Only use this block if Kore's spirit spheres amount is within the given range.
timeout (number)
  Wait number seconds before using this block again.
inLockOnly (flag)
  If set to 1, this block will only be used if Kore is in the specified lockMap.
notWhileSitting (flag)
  If set to 1, this block will not be used while sitting.
notInTown (flag)
  If set to 1, this block will not be used while in town.
monsters (list)
  If this option is used in an attackSkillSlot or attackComboSlot block, only use the block if you are attacking any one of the listed monsters.

  If this option is used on equipAuto block, only auto-equip if any of the listed monsters are attacking you or your party, and priority is given if you are also attacking that monster.

  If this option is used on other blocks, only use if any of the listed monsters are attacking you or your party.

defendMonsters (list)
  Only use if you are the target of any of the listed monsters.
notMonsters (list)
  If this option is used in an attackSkillSlot or attackComboSlot block, don't use the block if you are attacking any one of the listed monsters.

  If this option is used on other blocks, don't use if any of the listed monsters are attacking you or your party.

inInventory (list)
  Only use if all items and their corresponding amount range specified in the list exist in inventory.

  list follows the format `(item1) (range1) [,(item2) (range2) [...]]`

  Example:

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

  Don't place a space between the range operator and the amount.

whenGround (ground type)
  Cast a skill only if when the ground you're standing on is of a certain type.
  Example:
    useSelf_skill Teleport { lvl 1 whenGround Quagmire }
whenNotGround (ground type)
  Cast a skill only if when the ground you're standing on is not of a certain type.
  Example:
    useSelf_skill Pneuma { lvl 1 monsters Raydric Archer whenNotGround Pneuma }
whenPermitSkill (skill name)
  Only use this if you have been granted use of the specified temporary skill.
whenNotPermitSkill (skill name)
  Only use this if you have not been granted use of the specified temporary skill.

### Skill conditions

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

lvl (level)
  level - Skill level ranging from 1 to 10.

  Sets the skill level to use for this slot. This option is required.

maxCastTime (number)
  Kore will wait number seconds maximum for the spell to finish casting before continuing AI functions. Note that this is just a maximum - if Kore sees that the spell has finished then AI will resume. This option is usually not useful.
minCastTime (number)
  Similar to maxCastTime except Kore will wait even if the spell is finished. This option is usually not useful.

### Target conditions

These condition options are shared between the attackComboSlot, attackSkillSlot, monsterSkill, and partySkill configuration blocks.

target_timeout (seconds)
  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.
target_misses (range)
  Only use this if the number of your consecutive misses on a monster is greater than or equal the specified amount.
target_totalMisses (range)
  Only use this if you the total number of times you missed a monster is greater than or equal the specified amount.
target_whenStatusActive (list of status names)
target_whenStatusInactive (list of status names)
  Only use the skill if the specified statuses are active/inactive for the target monster. status names are case sensitive!

  Currently, known statuses for party members are lost when they leave your screen, so timeouts may be more appropriate. See whenStatusActive for more information about statuses.

target_whenGround (list of ground types)
target_whenNotGround (list of ground types)
  Only use the skill if the ground under the target monster is of a type listed in target_whenGround and if the ground is not of a type listed in target_whenNotGround. See whenGround for more information about ground types.

Login