telegram: @mwbot_official
E-mail: kutsenko100@gmail.com

##### First Program Launch

Hello! If you're reading this, you're likely interested in our bot or perhaps just looking for a way to handle those repetitive tasks in MW. This guide will help you get started with launching, setting up, and using the program.

##### Before You Begin: Essential Preparations

Before you dive in, there are a few important things to check and set up to ensure the bot runs smoothly.
1. System Requirements:

- Your computer should be running at least Windows 8.1.
- The program works on both x86 and x64 systems.

2. Antivirus Software:

- It is highly recommended to add the bot's folder to your antivirus software's exclusion list.
- Why? Antivirus programs might sometimes block the bot. This can happen because the bot uses Python scripts that are encrypted (to protect them from being copied) and because it simulates keyboard presses, which some antiviruses see as potentially risky.
- You can always check the bot's safety using services like VirusTotal (look under the "Actions" tab).

3. Administrator Privileges:

- The main bot file, mwBot.exe, must be run with administrator privileges.
- In order not to do it every time: press alt enter mwBot.exe, choose "Properties," go to the "Compatibility" tab, and check the box "Run this program as an administrator."

4. Important In-Game Settings:
To ensure the bot can "see" and interact with the game correctly, you'll need to adjust some settings within the game itself:

- Crucial: Ensure the "Use NVDA" checkbox is selected in your game settings. The bot needs this to get information from the game.
- Target Distance: Configure this setting so that the target's distance appears at the end of the target information display.
- Professions Display: Enable the display of professions if you want the bot to avoid bumping into other players.
- Target Serial Number: Disable the first item in the target display settings, which shows the target's serial number.
- Health and Mana Display: Choose whether the game displays health and mana as an amount (e.g., 1000 HP) or a percentage (e.g., 50% HP). The bot needs to know which one you use.
- Buffs and Debuffs: Configure the display of buffs and debuffs so they appear at the beginning of the line.

##### Installation and First Launch

Getting the bot up and running involves a few straightforward steps.

- Extract the Bot: Unzip the archive you downloaded.
- Place the Bot Folder: Copy the entire bot folder directly into your game's main directory. This is mandatory for the scripts to work correctly.
- Virtual Machines (If Used): If you're using a virtual machine, it's best to install the game on the local C: drive. Running the program from a shared folder isn't recommended as it can cause issues.
- Run the Bot: run the mwBot.exe file (it should now run as administrator if you set that in Properties).
- Driver Installation Prompt: Press Alt+Tab. You should see a Windows Security prompt. Confirm the driver installation. This driver is essential for the bot to press keys in the game.
- License Key: Press Alt+Tab again if needed and look for a window asking for your license key. Enter your key and press Enter.

If you've followed these steps, the program should launch successfully!
License Note: Your license key allows you to use the bot on multiple computers, but only one instance of the bot can be active at a time with the same key. If you start the bot on a second computer, it will automatically close on the first one.

##### Understanding Scripts

The bot works by running scripts. Some are simple, while others, like farming scripts, have a bit more to them.
A. Simple Scripts
Examples: Scripts for selling ore or searching the market.
How to use:

- Download them using the file exchanger in the bot (by pressing F6).
- Move the downloaded script file into the Scripts folder located within your main bot folder.
- Run the script from the bot interface.

B. Farming Scripts (More Complex)
Farming scripts usually consist of two main parts:

- Character Configuration File (Config File): This file tells the bot specific details about your character – like how much health you have, what keys to press for skills, etc. You'll create this file yourself or modify an existing template. You can name this file anything you like (e.g., myhunter.conf, magesetup.txt).
- Farming Script: This is the main script that contains the logic – where your character should go, what monsters to fight, and how to react in different situations.

Connecting Your Config File to a Farming Script:
For a farming script to work, it needs to know which character configuration file to use. This is usually done in one of two ways:

- Using the loadoptions command:
  Inside the farming script, you'll add or modify a line like this:
  loadoptions=name_of_your_config_file
  For example, if your config file is named myconfig.txt, the line would be:
  loadoptions=myconfig.txt (or simply loadoptions=myconfig.
- Modifying a variable in a downloaded script:
  If you download a script made by someone else, it might have a line where you need to specify your config file name. Look for comments or lines like:
  var=configfile=myhunter

In this case, you would change myhunter to the name of your character configuration file.
Important: This guide doesn't cover how to create or edit text files. You'll need basic knowledge of how to do that on your computer. The bot's documentation and hotkey list has more information on this.

##### Key Configuration Concepts (Character Config File)

Your character configuration file is where you customize the bot's behavior for your specific character. Here are some common settings you might find or need to set up (these are examples, and the exact names might vary slightly; always refer to the bot's command list for precise details):
Health and Mana Management:

- min_hp=45000 (Bot uses a health potion/skill if HP drops below 45000)
- min_mp=40000 (Bot uses a mana potion/skill if MP drops below 40000)
- key_regen_hp=lshift+y (The key or key combination for healing)
- key_regen_mp=3 (The key for mana restoration)
- enable_regen (Turns on the health/mana checking function)

Attack Settings:

- attack_type=0 (Determines how the bot behaves when an enemy is seen; 0 might mean stop and attack)
- speed_attack=0.08 (How fast skills are pressed, in seconds)
- keys_attack=j|n|m (List of keys for attacking skills, separated by |)
- enable_attack (Turns on the function for pressing skill keys)
- enable_nav_attack=0.1 (Turns on the enemy searching "radar" and sets its check speed)

Pet Management

- pet_name=Shorthair Cat|Cattle (Names of pets to summon, in order)
- pet_min_hp=80000 (Pet heals if its HP is below this)
- key_pet_regen_hp=4 (Key for pet's health potion)
- enable_pet (Enables pet functions)
- enable_pet_regen (Enables checking pet's HP/MP)

Item Repair:

- key_repair=0 (Key for your repair kit/skill)
- hotrepair=1 (1 for immediate repair when damage text appears, 0 for repair after battle)
- enable_repair=1 (Turns on repair function, =1 might mean using a repair box)

Other Useful Settings:

- enable_restart (Turns on auto-reconnect if the game crashes)
- open_game_window (Command for the bot to automatically switch to the game window)

Remember, this is just a small sample. The bot has many commands. Always check the full documentation for a complete list and detailed explanations.

##### Auto-Navigation (Using the goposition function)

For the bot to automatically navigate maps (e.g., using a goposition command in a script), it needs a "terrain map" file that tells it where obstacles are.
Getting Maps: You can often find ready-made maps in the bot's file exchange section.
Map Naming:
For automatic use, the map file (usually a .wall file) must be named exactly the same as the map's name in your game.
Example: If your game coordinates show Rock Square;Giant Rock City;204;195;central plains, the map name is central plains. Your map file in the wall folder should be central plains.
Placing Maps: Put these map files into the wall folder, which is inside your main bot folder in scripts folder.
Manual Connection: If your map file has a different name, you can tell the script to use it with a command like: mapwall=YourMapFileName
If you don't set up maps, don't be surprised if your character runs into walls or gets stuck!

##### Troubleshooting Common Issues

Sometimes things don't go as planned. Here are some common issues and how to address them.
A. Bot Not Pressing Keys / Skill Usage Problems:

- Driver Not Installed/Working: This is a common one. See the "Keyboard Driver Setup" section below.
- You took a script and didn't connect your character config file, or the script can't find it.
- Your character config file is set up incorrectly (e.g., enable_attack or enable_nav_attack functions are turned off or missing).
- Game Settings: The game is not set to display the target's health/mana as an amount or percentage, which the bot needs.
- Script Name: Try renaming the script if it has a very long name. The bot sometimes dislikes long names.
- Bot Language Setting: Check if the language selected in the bot matches the language used in your game. You can change this by pressing Alt+L in the bot window.

Experiment with Parameters:

- speed_attack=0.2 (Try values like 0.05 or 0.2. Experiment to find what works for your character and game.)
- enable_nav_attack=0.1 (This is the radar/target search speed. You might need to adjust it.)
- keyboard_delay=20| 20 (This sets the delay in milliseconds before pressing and before releasing keys. 20|20 is often recommended.)

A good starting point from one user's config: keyboard_delay=20|20 speed_attack=0.05 enable_nav_attack=0.1
B. Character Not Hitting Monsters:
This is often due to the same reasons listed above: incorrect config connection/setup or wrong game settings for health display.
C. Bot Not Opening Chests Correctly:
In-Game Settings (press F1 in the game):
Ensure "Read the target ID" is set to "Unselected."
Ensure "Distance reading mode" is set to "distance behind; sub menu."
Bot Localization File (Advanced):
If the bot struggles to identify chests, you might need to edit a text file.
Go to the lang folder inside the bot folder and open game.english.txt (or your language file) with Notepad.
Around line 45, you might find a line like: box=^Chest
This means the bot looks for the word "Chest" at the very beginning of a line to identify a chest. You can edit this "regular expression" if your game displays chest names differently.

##### Keyboard Driver Setup & Troubleshooting

For the bot to press keys in the game, a special keyboard driver is needed. The bot supports a few different drivers. If one isn't working, try another.
1. Find config.ini: Open the config.ini file located in your main bot folder using a text editor like Notepad.
2. Locate keyboard_type: Find the line that says keyboard_type=. You will change the number here.
Driver Option 0 (Often the First to Try):

- In config.ini, set: keyboard_type=0
- Save the file.
- Run mwBot.exe with administrator privileges.
- Press Alt+Tab and look for a "Windows Security" window. Confirm the driver installation.
- If successful, the bot should start and be able to press keys.

Driver Option 1:

- In config.ini, set: keyboard_type=1
- Save the file.
- Run the file checkDriver.cmd (found in the bot folder) with administrator privileges. This will disable driver signature verification, and your computer will restart.
- After the restart, run the bot and check if it presses keys.
- Attention: On a desktop computer, this driver usually only works if you have a PS/2 keyboard connected. On laptops, it generally works without this requirement.

Driver Option 2 (Newer Driver):

- In config.ini, set: keyboard_type=2
- Save the file.
- Run the file install_interceptor.cmd (found in the bot folder) with administrator privileges. This will install the driver, and your computer will restart.

What if the bot still doesn't press keys?
If you've tried all drivers and checked other troubleshooting steps, there might be deeper system conflicts. For Windows 11 users, see the "Core Isolation" tip below.
Windows 11 Specific: Core Isolation Issues
Some Windows 11 users find that keyboard drivers (which the bot needs) don't work correctly. Disabling a Windows security feature called "Core Isolation" (specifically "Memory Integrity") can sometimes help.
What is Core Isolation? It's a security feature that helps protect your system, but it can sometimes interfere with third-party applications or drivers.
How to Disable Memory Integrity (if needed for driver functionality):

- Open "Windows Security" (you can find it via the taskbar search or system tray icon).
- Go to the "Device Security" section.Under "Core Isolation," click on "Core Isolation Details."
- Turn off "Memory Integrity." Confirm the action if User Account Control asks.
- A restart will be required. Press and hold the Shift key on your keyboard, then click Restart (from the Start Menu power options). Holding Shift while restarting temporarily disables "Fast Startup," ensuring a fuller shutdown and restart, which can help apply changes like this.
- The next boot might take a little longer.

As a result, Core Isolation and Memory Integrity will be disabled. This may allow the keyboard drivers for the bot to function correctly.

##### Important Notes & Support

A few final, but very important, points:

- Use of this bot is at your own risk. The creators are not responsible for any consequences that may result from using the provided scripts or the bot itself.
- Read the Documentation: Please try to read any available documentation and guides thoroughly before asking questions. Many answers can often be found there.

What Your Subscription Includes $7.5 a month

- The bot engine for launching scripts.
- Access to a file exchanger with many script examples and ready-made solutions.
- Documentation, setup instructions, and a list of commands with descriptions.
- A community chat for finding friends, solutions, recommendations, and tips.

What Your Subscription Does Not Include:

- Custom script creation on demand for free. The team cannot create full, personalized scripts for every user's specific desires (e.g., "Make me a script for my hunter to farm gems, run from bosses, sell items, etc.").

Help and Community:

- The team and community can help solve specific problems or explain how a function works, especially if you show you're trying to learn and figure things out yourself.
- If you want a "turnkey" script made just for you, you'll likely need to find someone who offers that as a paid service.

Logs:
The bot keeps log files of its activity. These are stored on your computer in the log folder.
Attention: Logs are not deleted automatically. You must periodically delete these files manually because they can grow quite large over time.
No Remote Access: The bot creators cannot control your computer remotely, cannot receive data from your character, and cannot control your character. The bot only presses the keys specified in your scripts.

##### Final Words

This bot is a tool. Like any tool, it requires a bit of learning to use effectively. Don't be afraid to experiment (safely!), read the provided materials, and ask for help from the community when you get stuck.
We have a friendly community, and you can become a part of it. It all depends on you! Good luck, and happy botting!