User manual, must read

[Nikolaj]

"1. preparation for launch and launch program": ShowHide

Use of this bot is at your own risk. We are not responsible for any consequences resulting from the execution of the provided scripts.
Please read the documentation thoroughly before asking questions. We will endeavor to answer all inquiries.
**Important:** Ensure the "Use NVDA" checkbox is selected within your game settings. The bot requires this to receive and process in-game information.
Minimum required operating system: Windows 8.1.
The program is compatible with both x86 and x64 platforms.
**Attention:** It is highly recommended to add the bot's folder to your antivirus software's exclusion list to prevent potential issues with launching or updating the program.
Antivirus software may occasionally block the program. This is often due to the non-standard execution method of Python scripts, which are encrypted to prevent unauthorized access and theft.
Additionally, antivirus programs may theoretically flag the software because it simulates keyboard input, which is considered a potentially risky action.
You can verify the bot's safety using VirusTotal. Open the "Actions" tab and confirm that the bot does not contain viruses.
Extract the contents of the archive and place the bot folder directly into your game directory. This is a mandatory requirement for the script to function correctly.
If using a virtual machine, it is advisable to install the game on the local C: drive to avoid potential path conflicts. Running the program from a shared folder is not recommended.
The mwBot.exe file must be executed with administrator privileges. To avoid performing this step each time, right-click the file, select "Properties" (or press Alt+Enter), navigate to the "Compatibility" tab, and check the box labeled "Run this program as an administrator."
Run the mwBot.exe file.
Press Alt+Tab and look for a Windows Security prompt. Confirm the driver installation.
Press Alt+Tab and look for the window prompting for your license key. Enter your key and press Enter.
If all steps were followed correctly, the program should launch successfully.
Troubleshooting: Bot Launch Issues
The bot license allows usage on multiple computers, but only one instance of the bot can be active at a time with the same key. If you launch the bot on a second computer, the program will automatically close on the first one.

"2. program interface and chat commands": ShowHide

The program interface consists of 3 tabs. Use the Tab key to switch between them.

"2.1. list of scripts": ShowHide

Use the Up or Down arrow keys to navigate through the list of script files. Press Enter to execute the selected script.
List of Bot Hotkeys

"2.2 chat window": ShowHide

Type your message and press Enter to send it.
Press Ctrl+H within the bot window to access help information.

"2.3. chat message history.": ShowHide

At the top of the chat history, you will find the expiration date and time for your license key. For example:
end date: 2024-03-03 23:59:59
This indicates that your key will become invalid on March 4th. Please monitor the validity period of your license key and renew it in advance.

"2.4 commands in chat": ShowHide

/report your message - Use this command to submit a bug report.
/p username your text - Send a private message to a specific user.
/r your text - Send a quick reply to the most recent private message received.
/translate_write the language in which you would like to send chat messages. - Set the language for outgoing chat messages. For example, /translate_write en.
/helpme - Command for test accounts. Type this in the chat window and press Enter. Available administrators will join your channel.
To check which users are currently online on the server, type /who in the chat and press Enter. Please note, this feature is not available for test accounts.
To check which users are online in your current channel, type /whochannel in the chat and press Enter.
To check which users are online in a specific channel, type /whochannel channelname in the chat and press Enter.
To quickly change the bot's interface language, type the following in the chat window:

Code Select Expand

/lang namelanguage2 Service commands:
/gettime - Retrieve the current time on the server.
/getdate - Retrieve the current date on the server.

"3. bot interface localization": ShowHide

Navigate to the lang folder within the bot's installation directory.
Locate the file named english.bot.txt.
Open this file and translate the text that appears after the equals sign (=). Save the changes and restart the program.
This process will translate the program's interface into your desired language. The default language is Ukrainian.

"4. bot configuration": ShowHide

The main configuration file is located in the bot's folder and is named config.ini.
This file contains the primary settings. If a specific parameter is not defined in a script's configuration file, the value from the config.ini file will be used.

"4.1 example configuration file for my witch": ShowHide

It is recommended to first specify the desired values for parameters and then enable the corresponding functions you need.
enable_restart
Enables the game to automatically restart if it closes unexpectedly.
open_game_window
The line below indicates that the program will automatically open the game window upon launch.
pet_name=horse|hare|wolf
Below, list the names of the pets that will be used. You can specify any number of pets, separating their names with a vertical bar (|).
regen_timeout=2
I set the frequency (in seconds) at which my character's health and mana will be checked.
speed_attack=0.05
I specify the delay (in seconds) between skill presses during attack. Fractional values are permitted.
attack_type=1
The line below determines the character's movement behavior during combat. If set to 1, the character will constantly move and attack monsters as they are encountered. If set to 0, the character will stop to attack a target and resume movement after killing it.
keys_attack=h|n|j|m
Below, list the keys used for attack skills, separated by vertical bars (|).
Key Names Reference
min_hp=155000
I specify the minimum health level below which the character will use a healing item.
min_mp=190000
Below, specify the minimum mana level below which the character will use a mana potion.
min_banks_hp=-1
Below, I set this to -1 to indicate that the game should not close if the character runs out of health potions.
min_banks_mp=-1
Below, I set this to -1 to indicate that the game should not close if the character runs out of mana potions.
pet_min_hp=245000
Below, specify the pet's minimum health level below which it will use a health potion.
pet_min_mp=100000
Below, specify the pet's minimum mana level below which it will use a mana potion.
pet_min_food=45
Below, specify the pet's minimum satiety level below which it will consume a food item (e.g., rice ball).
key_regen_hp=u
Below is the key assigned for the character's healing skill or potion. In this example, it is the letter u.
key_regen_mp=3
Below is the key assigned for the character's mana potion.
key_pet_regen_hp=7
Below is the key assigned for the pet's health potion.
key_pet_regen_mp=6
Below is the key assigned for the pet's mana potion.
key_pet_regen_food=9
Below is the key assigned for using a pet food item (e.g., rice ball).
key_repair=0
Below is the key assigned for repairing equipment (using a repair box or pliers).
enable_regen
Enables automatic health and mana regeneration for the character.
enable_nav_attack
Enables the radar function to search for monsters.
enable_attack
Enables the attack function, including the use of skills.
enable_repair=1
Below, I enable the character's equipment repair function using a repair box.
enable_pet
Below, I enable the function to summon and manage the pet.
enable_pet_regen
Below, I enable the control of the pet's health and mana regeneration.
enable_pet_food
Below, I enable the control of the pet's satiety level.
enable_clearbag
Below, I enable the function to automatically clear specified items from the inventory.

"5. description of the program structure and interaction with it": ShowHide

The files folder contains the files you downloaded.
The log folder stores program event logs. Remember to manually delete older log files periodically, as they can become quite large over time.
The lang folder contains files used for adapting the bot's interface language within the game. Bot interface language files are also stored here.
The scripts folder contains your script files. This folder also includes the wall folder, which stores maps defining obstacles. These maps are necessary for the automatic route search by coordinates to function correctly.
Obstacle Maps: Usage Guide for Character Auto-Navigation

Within the bot's main folder, you will find the file clearbag.txt.
List the names of items you wish to be automatically discarded from your inventory in this file.
Locate the file stopwordwall.txt. You can specify a list of obstacles in this file. This is useful if your character is moving randomly; for example, if the character collides with an obstacle listed here, it will automatically change direction.
The update.exe file is responsible for updating the program. If the program did not update automatically upon startup for any reason, you can run this file manually.

"6. a few words for advanced users": ShowHide

Triggers allow you to handle a wide variety of situations that may occur in the game. Here are a few examples:
Below is a trigger that, if the character reaches the edge of the map, will direct the script to jump to line 26, which instructs the character to move towards the center of the map. This serves as a protection against the character getting stuck, a common issue encountered by players.
add_action_speak=bordermap={"text": ["^edge$"], "command": ["go_to_line", "26"]}
Now, let's examine the trigger body itself, which uses a regular expression:
"^edge$"
The ^ symbol indicates that the line must begin with the specified text and nothing else before it.
The word "edge" is the specific text being matched.
The $ symbol indicates that the line must end with this text and nothing else after it.
This ensures that the trigger will only activate if the exact word "edge" appears as a complete line, preventing it from firing if someone sends you a private message containing the word "edge" as part of a longer sentence.
You can find detailed information about regular expression syntax online. This example provides a basic illustration. GPT chat can also be helpful in generating effective regular expressions.
The complexity and functionality of your scripts are limited only by your imagination and understanding of the game's mechanics.

"7. a few words about everything I didn't say": ShowHide

The mortal script is responsible for character resurrection. You can explore and modify it as needed.
The login script handles character authorization. You can explore and modify it individually.
Script file names can be written in any language.

"8. game configuration for the bot to work correctly": ShowHide

The target distance setting must be configured to appear at the end of the target information display.
You must enable the display of professions in the game settings if you want the bot to avoid colliding with other players. You also need to disable the first item in the target display settings, which shows the target's serial number.
You need to select whether the game displays health and mana as an amount or a percentage.
Additionally, you need to configure the display of buffs and debuffs to appear at the beginning of the line.