autowizard

An automated application for opening multiple instances of Wizard101.

Use Cases

Boxing refers to running multiple instances of Wizard101 with different accounts, enabling you to solo PvE battles more effectively.

With autowizard, you can also easily manage tasks like training pets, completing daily assignments, and gardening by automating the login process for each account, eliminating the need to manually open the launcher and enter credentials.

Learn more about boxing on Final Bastion.

Features

• Automated Account Opening: Open multiple accounts effortlessly.
• Account Selection: Choose which accounts to launch.
• Steam Integration: Track playtime and display your game status on Steam for one selected account.
• Window Positioning: Automatically position windows based on screen coordinates.

Note

While autowizard is designed for multiple instances, it can also be used to open a single account.

Usage

1. Ensure config.json exists in the same directory/folder as autowizard.exe.
2. Open config.json in a text editor (e.g., Notepad++, VSCode, Notepad) and make the needed changes.
3. Run autowizard.exe.

Important

The following sections must be updated for your setup.

1. Adding Your Accounts

Add or remove accounts as needed, and replace the placeholders with your actual login credentials:

"accounts": [
    ["username1", "password1"],
    ["username2", "password2"],
    ["username3", "password3"],
    ["username4", "password4"]
]

2. Setting the Wizard101.exe Path

Specify the path to the Wizard101.exe file, ensuring that you use double backslashes:

"wizard_exe_path": "C:\\path\\to\\Wizard101.exe"

Optional: Enable Account Selection

By default, all specified accounts open, but you can change that by enabling this option.

If you want to select which accounts to open (for example, opening only accounts 1 and 3), change false to true:

"enable_account_selection": true

Optional: Steam Integration

Note

This integration is for a single account only. It does not support running multiple instances using different Steam accounts.

This feature is primarily intended for users who want to track their playtime or let friends know they are playing Wizard101 through Steam, while using the original launcher.

To integrate the original Wizard101 with Steam, follow these steps:

1. Set Launcher Options in Steam: In the steam properties for Wizard101, set the launch options to:

"C:\path\to\Wizard101.exe" %command%

2. Specify the path to steam.exe: Set the path to the Steam executable:

"steam_exe_path": "C:\\path\\to\\steam.exe"

3. Enable Steam Integration: Change "enable_steam" option from false to true:

"enable_steam": true

Tip

If you plan to use one account more frequently, it's recommended to select that account.

Optional: Progress Logging

By default, logging for the progress bar percentage is disabled.

You can turn logging on by changing false to true:

"progress_logging": true

Optional: Window Positioning

This feature allows you to control where each window opens on your screen.

By default, window positioning is disabled. You can specify multiple positions for the windows, and each account will open in the corresponding spot on your screen.

You can set up the window_positions config to define where each game window will be placed. Positions are specified as [x, y] coordinates relative to your screen's top left corner.

"window_positions": [
    [0, 0],
    [1920, 0],
    [0, 1080],
    [1920, 1080]
]

I've included coordinates based on a 1920x1080 screen resolution. Change these coordinates to fit your own.

If you have more accounts than positions, the process will cycle back through the positions.

• You have 1 account and 4 specified positions. It will use the first position.
• You have 4 accounts and 2 specified positions. It will use the 2 positions and then cycle back through for the last 2 accounts.
• You have 4 accounts and 0 specified positions. All accounts will use [0, 0].

autofarmer

An automated application designed to assist players with farming in Wizard101 using image recognition.

Use Cases

Farming in autofarmer's case refers to repeatedly engaging in battles to collect gold, reagents, seeds (like couch potatoes), or other valuable drops in Wizard101.

autofarmer is best suited for simplifying repetitive mob fights, where battles require minimal strategy and can be automated effectively. It's ideal for running the tool overnight or while you're away.

Note

autofarmer is an active process and cannot run in the background. The game must remain open and active during use.

Features

• Customizable Spell Priorities: Tailor the spell list to match your character's deck.
• Dynamic Spell Selection: Skips to the next spell if a higher-priority one isn't available.
• Enchantment & Aura Selection: Use of buffs to enhance your character's damage output.
• Automatic Mana Refill: Uses potions to refill your mana while you're away.

Usage

1. Ensure config.json exists in the same directory/folder as autofarmer.exe.
2. Open config.json in a text editor (e.g., Notepad++, VSCode, Notepad) and make the needed changes.
3. Ensure Wizard101 is running.
4. Run autofarmer.exe.

Tip

autofarmer works best on higher resolutions. For the absolutely best results, put your game on borderless and change the UI size to regular or large.

1. School and Spell Priorities

Ensure your school is correctly set:

"school": "storm"

This ensures autofarmer looks for spells relevant to your character.

Spell priorities should reflect your deck setup. Place the most frequently used or important spells at the start of the list. autofarmer reads priorities from top (highest priority) to bottom (lowest priority). If there are spells you are not going to use, remove them altogether for quicker results.

Spells are followed by their mana cost. This value is important if you're using the mana refill feature.

Example configuration:

"spell_priority": {
    "sun": ["epic"],
    "star": [],
    "storm": {
        "bunyips_rage": 3,
        "tempest": 5
    }
}

If a spell isn't found during battle, autofarmer automatically skips to the next one.

Tip

Tailor your deck well. autofarmer struggles to perform when the hand is larger. The ideal hand is 1 to 5 cards.

2. Optional: Mana Refill

If you leave autofarmer to run over a period of time, there are high chances that your wizard may run out of mana at some point. This feature will periodically check your wizard's mana reserve and refill it using a potion if needed.

The tesseract folder and all of its contents must be alongside autofarmer.exe for this feature to work. This folder is included separately because of its extra size.

The interval at which it checks your wizard's mana can be configured by changing mana_check_interval in the following debug configuration section. The default is 1800 seconds, or 30 minutes.

To prevent constant scanning for the state of your mana reserve, autofarmer estimates what it could be using the card's mana cost. If your mana reaches a critical state, 10% of what you had initially, autofarmer will attempt to confirm this and refill your mana.

3. Debug Configurations

The debug section in config.json allows you to adjust image recognition settings for better performance. These configurations help troubleshoot detection issues.

"debug": {
    "confidence": 0.645,
    "min_scale": 0.5,
    "max_scale": 2.0,
    "grayscale": false,
    "center_screenshot": true,
    "save_screenshot": false,
    "screenshot_age": 60,
    "check_interval": 1800
}

• confidence (default: 0.645)

  Controls how strict the image recognition is when matching spells.

  • Higher values (e.g., 0.8): More precise but may miss matches.
  • Lower values (e.g., 0.5): More lenient but risks false positives.

• min_scale & max_scale (default: 0.5 to 2.0)

  Defines the scaling range for image detection. This helps autofarmer adjust to different screen or UI sizes.

  • min_scale (0.5): Smallest image size to check.
  • max_scale (2.0): Largest image size to check.

• grayscale (default: false)

  Enables grayscale image matching, which can improve detection speed.

• center_screenshot (default: true)

  Focuses detection on the center of the screen, where most combat elements are.

  • false: Analyzes the entire screen.

• save_screenshot (default: false)

  Saves screenshots for during detection attempts; useful if you're not sure if it's capturing the hand, etc.

• screenshot_age (default: 60)

  Determines how old (seconds) screenshots can be before they're automatically deleted when autofarmer exits.

• mana_check_interval (default: 1800)

  Sets how often (in seconds) autofarmer checks your wizard's mana reserve.

Possible Misconceptions

• Single Account/Instance: autofarmer does not support multiple instances.
• Active Use Only: The game must remain the active window. autofarmer cannot function in the background.
• Simple Battles Only: autofarmer is designed for basic mob farming, not complex boss fights or PvP scenarios.

Final Notes

• Save Changes: Make sure to save your changes to config.json before running the program.
• Check Paths: Double-check that the paths to Wizard101.exe and steam.exe are correct. They should point to the actual executable files, not shortcuts.

Caution

Treat your config.json file like sensitive information. Don't share it with others to avoid risking your login credentials.

If any assistance is needed, my discord is 1cale. If you'd like to make any suggestions, you can open up an issue. Enjoy your automated Wizard101 experience!

License

This project is licensed under the MIT License - see the LICENSE file for details.