bot documentation

2. program interface, hotkeys and chat commands
The program has 3 tabs, move between them using the Tab key
2.1. list of scripts
press the up or down arrows to move between script files, to run the script you are interested in press enter
f1 - to create a new script. enter a name and press enter
f3 to rename the script. enter a new name and press enter
f4 - to edit the selected script. press ctrl+s to save changes to the script. press f1 in the script editor to find out the line number you are on.
f5 - to update the list of scripts
f6 to open the file exchanger. use the up or down arrows to find the file you are interested in. press enter to download the file
press Tab to find the "upload file" button. You can select this in Explorer or simply copy the file first and paste it using the key combination ctrl+v and press enter
downloaded files are stored in the files folder inside the bot folder

2.3. chat message history.
at the top of the chat history you will see the expiration time of your key, for example
last date: 2024-03-03 23:59:59
thus, on March 4, your key will no longer be valid. Take care of this in advance and control the validity period of the license key.

3. bot localization
in the bot folder find the language.ini file
open it and translate the text that is after the equal sign (=), save the changes and restart the program.
This way the program interface will be translated into your native language. Ukrainian is the default language.

4.1. example config.ini
on the line below we indicate the text to which the game will be translated when you press and turn on the translator ctrl+t, I wrote about this above. in my example it is ru, Russian language
translate_target_language=ru
On the line below we indicate the language into which your messages will be translated when you press alt+t. to use this, just press alt+t, write a message in your language and press enter. I wrote about the translator above. in my example it is tr, Turkish language
translate_chat_write=tr
Below you can turn off or turn on the notification when the user appears offline in the program. on is on, off is off
chat_online=off. в моем примере звуковые уведомления выключены
Below we indicate whether to automatically open the game again if for some reason it is closed. 0 disabled, 1 enabled
enable_restart=0
the minimum amount of health below which a character will drink a red bottle or use a healing skill
min_hp=25000
the minimum amount of mana below which a character will drink a blue bottle
min_mp=40000
how often to check a character’s health (press the letter r), in my example, check health every 30 seconds
regen_timeout=30
we indicate how often the health bottle can be used, information can be found by pressing the letter g, it is not necessary to indicate, especially if your character uses the healing skill
reload_bank_hp=1
indicate how often you can use the blue bottle, information can be found by pressing the letter g, it is not necessary to indicate correctly
reload_bank_mp=1
close the game if there are fewer red bottles. in my example, 1 bottle is indicated. that is, if the character runs out of red bottles, the game will close. if you write a negative value, the game will not close
min_banks_hp=1
close the game if there are fewer blue bottles. in my example, 1 bottle is indicated. that is, if the character runs out of blue bottles, the game will close. if you write a negative value, the game will not close
min_banks_mp=1
Below we indicate whether to ignore tied, locked bottles (for example, bottles received at a supply camp or during a game event) 1 ignore, 0 - do not play
ignore_personal_banks=1
Below we indicate the key for healing the character (red bottle or healing skill)
key_user_regen_hp=1
Below we indicate the key to replenish the character’s mana (blue bottle)
key_user_regen_mp=2
Below we indicate the key for the red bottle of the pet, in my example it is the number 3
key_pet_regen_hp=3
Below we indicate the key for the blue pet bottle, in my example it is the number 4
key_pet_regen_mp=4
Below we indicate the key for the rice ball (pet food), in my example it is the number 5
key_pet_regen_food=5
Below we indicate the level of satiety below which the pet will eat a rice ball
pet_min_food=70
Below we indicate how often you need to check the satiety of your pet. must be specified in seconds. 300 is 5 minutes
pet_food_timeout=300
Below we indicate the amount of health of the pet, below which the pet will drink a red bottle
pet_min_hp=75000
Below we indicate the amount of manna for a pet, below which the pet will drink a blue bottle
pet_min_mp=75000
Below we indicate how often you can use the red bottle for your pet, information can be found by pressing the letter g, it is not necessary to indicate)
pet_reload_bank_hp=1
Below we indicate how often you can use the blue bottle for your pet, information can be found by pressing the letter g, it is not necessary to indicate)
pet_reload_bank_mp=1
Below we indicate how often you need to check the health of your pet (you need to indicate in seconds)
pet_regen_timeout=10
Below we indicate the keys for the skills that the character should use in battle. Skills must be separated by a vertical line. There is no need to put a vertical line at the end. look at the example, and then change it to avoid breaking the script
keys_attack=h|j|n|m
Below we indicate whether to summon a pet. 0 do not summon, 1 - summon pet
enable_pet=0
Below are the names of pets, from strong to weak. You need to separate pets with a vertical line, for example wolf|horse|hare
pet_name=黄牛
We indicate below the equipment repair option. (-1 ignore equipment breakdown)
enable_repair=-1
key to repair equipment
key_repair=0
Below we indicate the option for using the driver. 0 drv, 1 - winio. the default is drv. When you first start it you need to install it, I wrote about this above. To use winio, you need to run the checkDriver.cmd file and restart your computer. the program will work with winio on a desktop computer only if a ps/2 keyboard is connected to it. The Drv driver is universal and will work successfully on both a laptop and a desktop computer.
keyboard_type=0
Below is the license key
api_key=test_api_key

5. script management hotkeys
To run the script you are interested in, select it in the list and press Enter. Attention, make sure that the chat window in the game is closed, otherwise you will have to open the game again
to pause the script, press alt+f2
to continue executing the script, unpause, press f2
To finish running the script and close it, press ctrl+f2
Attention! When the script is paused, you will not be able to find a list of scripts in the program window, so close the script first.
Sometimes there is a problem with the key getting stuck, so I recommend not closing the script right away. Pause, open the chat window and make sure that the computer is not writing any letters into the chat. After this, feel free to close the script. if the script writes letters, continue working (f2), and after a few seconds, pause again and check again. The problem should go away.

7. a few words for advanced users
With the help of triggers you can handle most situations in the game. I'll show you some examples
Below is a trigger, if the character hits the edge of the map, then the script will go to line 26, it says that the character should go to the center of the map. This is protection against the key getting stuck. players often encounter this problem
add_action_speak=bordermap={"text": ["^边缘$"], "command": ["go_to_line", "26"]}
now the trigger body itself is a regular function
"^边缘$"
the ^ sign means that the line will begin with this text and no other
then the word "edge" is written in Chinese
The $ sign means that the line ends with this text.
this way the trigger won't fire if someone sends you the word "edge" in a private message.
below is the trigger if my character is attacked by another character
add_action_speak=escapeattack={"text": ["^来自(\\w+)的攻击;ID\\((\\d+)$"], "command": ["go_to_line", "15"]}
\\d+ means that the line will contain the order of numbers
\\w+ means that the string will have character order
You can find detailed information about the notation on the Internet; I wrote you a small example.
if someone attacks my character, I will use a shield, stop attacking and run to the specified coordinates.
The logic of the script depends only on your imagination.

9. game configuration for the script to work correctly
You can explore other game settings yourself. If something doesn't work for you, look at the list of recommended settings.
target distance must be indicated at the end
距离朗读方式距离在后;有菜单
The option below must be checked if you want your character to bypass players and not collide with them
切目标时读出玩家职业;已选中
Below you need to choose whether to announce the amount or percentage of health
切换目标时朗读生命值;有菜单
It should also be noted that it shows negative and beneficial effects at the beginning
查看目标数值时前置朗读增损益信息;已选中