mon control.txt: Difference between revisions

From OpenKore Wiki
Jump to navigation Jump to search
(attack_auto 3 (mob-training))
mNo edit summary
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
By default, if the option [[attackAuto]] in [[config.txt]] is set to '''2''', Kore will attack all monsters that it can engage. The file mon_control.txt allows you to control which monsters Kore should attack and which monsters should be ignored.
By default, all monsters are attacked when [[attackAuto]] is set. This file allows to specify per-monster behaviour.
Aside from auto-attack, additional options and features can be configured in this file.
 
These include:
* teleporting away from monsters
* teleporting to search for monsters
* avoiding skills being casted by monsters
* defining minimum level, joblevel, hp and sp requirements that should be met before attacking a monster
* designating monster weights to distinguish weak monsters from stronger ones.
 


== Syntax ==
== Syntax ==
Line 16: Line 7:
''' Note. ''' Alternatively, you can use a TAB character between the monster name and the flags. Use this for monsters that have numbers on their names.
''' Note. ''' Alternatively, you can use a TAB character between the monster name and the flags. Use this for monsters that have numbers on their names.


=== Details ===
=== <[[References#Monster_Names|monster name]]> ===
----
Name of a monster, or "all" for default options for monsters not specified in that file.


 
=== <attack> ===
; <[[References#Monster Names|monster name]]>
Attack this monster when [[attackAuto]] is set.
: This is the name of a monster. You can use the keyword "all" to set default options for all monsters.
 
 
; <attack>
: If auto-attack is enabled (i.e. the option [[attackAuto]] is set), this flag controls whether Kore should attack the monster or not. It takes one of the following values:


{|class="TablePager"
{|class="TablePager"
Line 42: Line 28:
|-
|-
!2
!2
|Always consider monster as aggressive.
|Always consider monster as aggressive. Attack it even while auto-sitting to regain hp/sp.
|-
|-
!3
!3
Line 48: Line 34:
|}
|}


'''Note.''' If you set this flag to '''2''', Kore will try to attack a monster even while you are auto-sitting to regain hp/sp.
=== <teleport> ===
 
Avoid this monster by teleporting.
 
; <teleport>
: This is a flag that tells if Kore should avoid the monster by teleporting. It takes one of the following values:


{|class="TablePager"
{|class="TablePager"
Line 71: Line 54:
|-
|-
!3
!3
|Disconnect if the monster is on your screen.
|Disconnect for 30 seconds if the monster is on your screen.
|-
!>= 4 (4, 5, etc.)
|Set the time that will be disconnected (in seconds) if the monster is on your screen.
|}
|}


'''Notes:'''
'''Notes:'''
* Only if you will be teleported (value < 0, 1 and 2) to the auto-attack mode enabled.
* You must have the Teleport Skill or Fly Wings in inventory or this option will fail (see [[teleportAuto_useSkill]]).
* You must have the Teleport Skill or Fly Wings in inventory or this option will fail (see [[teleportAuto_useSkill]]).
* 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.
* 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.


=== <search> ===
Treat this monster as a "search monster": When [[teleportAuto_search]] is set, auto-attack will be activated only when a certain amount of "search monsters" is found on screen.


; <search>
=== <skillcancel> ===
: This boolean flag tells if Kore should search for the monster or not. If this flag is set to '''1''', this labels the monster as a "search monster". If the option [[teleportAuto_search]] is enabled, auto-attack will be deactivated by default and will only be activated when a search monster is found on screen.  
Attempt to avoid skills being cast by this monster. If this is enabled, Kore will either switch target and attack the monster to interrupt its skill casting, or run to the monster's back if it is casting a location-based skill.  


=== <lv> ===
Minimum required base level before auto-attacking the monster.


; <skillcancel>
=== <joblv> ===
: This is a [[References#Basic Value and Parameter Types|boolean flag]] that tells if Kore should attempt to avoid skills being cast by the monster. If this is enabled, Kore will either switch target and attack the monster to interrupt its skill casting, or run to the monster's back if it is casting a location-based skill.  
Minimum required job level before auto-attacking the monster.  


=== <hp> ===
Minimum required current HP before auto-attacking the monster (specified in absolute amount, not in percentage).


; <lv>
=== <sp> ===
: This specifies the minimum required base level before you auto-attack the monster.  
Minimum required current SP before auto-attacking the monster (specified in absolute amount, not in percentage).


=== <weight> ===
Numeric factor that will be used as the monster's quantity or weight when counting for the number of aggressives. This value should be greater than '''0''' or the monster will be counted as '''1''' aggressive. If you don't want to count the monster as aggressive, specify '''-1'''. This value supports floating point numbers (eg 1.8237402).


; <joblv>
== API ==
: This specifies the minimum required job level before you auto-attack the monster.
<code>Misc::mon_control</code>
 
 
; <hp>
: This specifies the minimum required current HP before you auto-attack the monster.
 
'''Note.''' This is specified in absolute amount, and not in percentage.
 
 
; <sp>
: This specifies the minimum required current SP before you auto-attack the monster.
 
'''Note.''' This is specified in absolute amount, and not in percentage.
 
 
; <weight>
: This is a numeric factor that will be used as the monster's quantity or weight when counting for the number of aggressives. This value should be greater than '''0''' or the monster will be counted as '''1''' aggressive. If you don't want to count the monster as aggressive, specify '''-1'''. This value supports floating point numbers (eg 1.8237402).


== Examples ==
== Examples ==
Line 137: Line 116:
'''Note.''' Lines that begin with the pound sign (#) are comment lines. They are ignored by Openkore.
'''Note.''' Lines that begin with the pound sign (#) are comment lines. They are ignored by Openkore.


 
[[Category:control]]
[[Category:Control]]

Latest revision as of 23:48, 26 April 2021

By default, all monsters are attacked when attackAuto is set. This file allows to specify per-monster behaviour.

Syntax

The format of this file is simply a set of lines that observes the following syntax:

<monster name> <attack> <teleport> <search> <skillcancel> <lv> <joblv> <hp> <sp> <weight> 

Note. Alternatively, you can use a TAB character between the monster name and the flags. Use this for monsters that have numbers on their names.

<monster name>

Name of a monster, or "all" for default options for monsters not specified in that file.

<attack>

Attack this monster when attackAuto is set.

Value Description
-1 Ignore monster.
0 Do not auto-attack monster, but retaliate when it attacks you.
1 Auto-attack monster (default).
2 Always consider monster as aggressive. Attack it even while auto-sitting to regain hp/sp.
3 Mob-training.

<teleport>

Avoid this monster by teleporting.

Value Description
< 0 (-1, -2, etc.) Set the distance for this monster. Teleport, if the monster reaches it.
0 Do not teleport.
1 Teleport if the monster is on screen.
2 Teleport if the monster's attack will damage you.
3 Disconnect for 30 seconds if the monster is on your screen.
>= 4 (4, 5, etc.) Set the time that will be disconnected (in seconds) if the monster is on your screen.

Notes:

  • Only if you will be teleported (value < 0, 1 and 2) to the auto-attack mode enabled.
  • You must have the Teleport Skill or Fly Wings in inventory or this option will fail (see teleportAuto_useSkill).
  • 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.

<search>

Treat this monster as a "search monster": When teleportAuto_search is set, auto-attack will be activated only when a certain amount of "search monsters" is found on screen.

<skillcancel>

Attempt to avoid skills being cast by this monster. If this is enabled, Kore will either switch target and attack the monster to interrupt its skill casting, or run to the monster's back if it is casting a location-based skill.

<lv>

Minimum required base level before auto-attacking the monster.

<joblv>

Minimum required job level before auto-attacking the monster.

<hp>

Minimum required current HP before auto-attacking the monster (specified in absolute amount, not in percentage).

<sp>

Minimum required current SP before auto-attacking the monster (specified in absolute amount, not in percentage).

<weight>

Numeric factor that will be used as the monster's quantity or weight when counting for the number of aggressives. This value should be greater than 0 or the monster will be counted as 1 aggressive. If you don't want to count the monster as aggressive, specify -1. This value supports floating point numbers (eg 1.8237402).

API

Misc::mon_control

Examples

The example below will make Kore attack and search for Elder Willows and Eggyras, but ignore Bigfoots, Willows and Poporings.

Kore will also try to avoid skills casted by Elder Willows (Fire Bolt).

Elder Willow 1 0 1 1
Eggyra 1 0 1
Bigfoot 0 0 0
Willow 0 0 0
Poporing 0 0 0


The following example shows a typical way of how monster weight is used:

# In config.txt:
teleportAuto_minAggressives 6
teleportAuto_minAggressivesInLock 6

# In mon_control.txt:
Hydra 1 0 0 0 0 0 0 0 0.2
Merman 1 0 0 0 0 0 0 0 2

With the configuration above, if five Hydras and two Sword Fishes attack the bot, it will not teleport away since the aggressives are counted as (5 * 0.2) + (2 * 1) = 3. However, two Marcs and two Merman will make it teleport away because it sees (2 * 1) + (2 * 2) = 6 aggressives.

Note. Lines that begin with the pound sign (#) are comment lines. They are ignored by Openkore.