wizAPI

An updated 2022 API to interact and make bots in Wizard101 based on image recognition.

The wizAPI.py file contains a large number of functions to interact with Wizard101, Hopefully, you will find it useful :)

How to run

Make sure you have python (version 3.9 perfered) installed and that you've configured your environment PATH variable to include the path to your python installation (Standard stuff, Python 3.6 even does it for you)
Open the terminal of you choice (can be cmd) and cd into the project folder
Run python -m pip install -r requirements.txt in the command line to install all dependencies
To run teamup_loremaster.py type in python teamup_loremaster.py (It needs a w101 windows opened and for the player to be standing at the teamup kiosk for this particular bot)
Make your own bots! Looks at the code of teamup_loremaster.py and get the sense on how this API is used. Go through each of the functions in wizAPI.py and look at what they do! Then build your own for your purpose.

IMPORTANT

Make sure your windows are set to an 800 x 600 resolution and your interface size is 'regular' A common issue is when the scale of your screen isn't at 100% (if it's lower or higher, pixels don't match up) you can check that in display settings on your desktop.

Has only been tested on Windows!

To add your own spells, use the 'screenshot' function from the API when spell selection is opened. Take this image and crop it so that only the image of the spell is visible (see spells folder for examples) Rename it to the name of the spell, and add it to the spells folder. You can also use the windows snipping tool.

Syntax

I coded this library to be very intuitive and easy to use. Here's an example script:

from wizAPI import *
player = wizAPI().register_window()

(
  player.hold_key('s', 1)
  .hold_key('w', 1)
)

player.wait_for_next_turn()
inFight = True

while inFight:
    if player.enchant('tempest', 'epic') or player.find_spell('tempest_enchanted'):
        player.cast_spell('tempest-enchanted')
    else:
        player.pass_turn()

    player.wait_for_end_of_round()

    if player.is_idle():
      inFight = False

# Fight complete!

Spectre1-Ghost/wizAPI-2022

wizAPI

How to run

IMPORTANT

Has only been tested on Windows!

Syntax