FAQ

If your question isn't here, have a look through

AUTO-MAS GitHub Issues

.

If the problem is in the script itself (MAA failing to recognize a stage, for example), that's the script's business. Check that script's documentation or ask its author. AUTO-MAS only schedules them.

Questions

Does AUTO-MAS benefit paid account runners?

• When paid account runners use AUTO-MAS, it benefits paid account runners. When regular users use AUTO-MAS, it benefits regular users.
• And the wider AUTO-MAS spreads, the more it benefits users, so go help spread the word.

Are my account passwords safe?

Yes. The passwords and tokens you enter are encrypted with Windows' own encryption (DPAPI) and stored on your machine. AUTO-MAS never uploads them to any server.

That encryption is tied to your Windows login account, which means:

• The app can only decrypt the data while you are signed in to that Windows account on that computer.
• Even if someone copies the whole config folder, they can't decrypt it on another computer.

The tradeoff: change environments and it can't be decrypted

In the three cases below, your old credential data stops working and you'll have to enter it again. This is not a bug:

1. You reinstalled Windows, or switched to a new Windows account — the key from the old account is gone.
2. You reset your Windows login password by bypassing Windows (offline password editors, system repair tools, and the like) — changing your password normally from inside Windows is fine; going around Windows to do it loses the key.
3. You copied the configuration to another computer or another Windows account — the encrypted data is only valid under the original account on the original computer.

Troubleshooting

The app keeps showing Network Error

That means the backend didn't start. First find the actual error, either on the error page in the app or in debug/app.log, then match it against the list below:

• [Errno 10048] error while attempting to bind on address ('0.0.0.0', 36163)

  Another program has taken the port. The AUTO-MAS backend uses port 36163. Find what's holding it and close that.

• ModuleNotFoundError: No module named 'xxx'

  Dependencies are incomplete. Delete environment/.requirements_hash in the install directory and restart the app so it reinstalls them. If that doesn't help, delete the whole environment folder and restart.

• ImportError: DLL load failed while importing onnxruntime_pybind11_state

  Your system is missing the Microsoft Visual C++ runtime. Installing it fixes this: download the x64 build directly, or pick a version from the Microsoft page.

When neither the error page nor the log shows an error

Run the backend by hand to force the error out. Open a terminal (PowerShell or CMD) as administrator and run:

cd {AUTO-MAS root directory}
.\environment\python\python.exe main.py

Replace {AUTO-MAS root directory} with your actual install path. Whatever the terminal prints is your lead.

The emulator fails to start

This is almost always mismatched privileges. Everything AUTO-MAS launches runs as administrator, but if an emulator instance is already open without administrator rights, a new instance can no longer be started as administrator. So one instance opened with normal privileges is enough to break every additional instance after it.

1. Close every emulator instance and the multi-instance manager.
2. Go back to AUTO-MAS and start the task again. If it still fails, restart the computer and start it straight from AUTO-MAS, without opening the emulator by hand in between.
3. From then on, when you open the emulator or the multi-instance manager yourself, use right-click > Run as administrator. If that gets tedious, make a shortcut and set right-click > Properties > Shortcut > Advanced > Run as administrator, so double-clicking it always runs as administrator.

I clicked configure MAA, but the MAA window never appeared

MAA has probably hidden itself in the tray. If you enabled minimize immediately after startup plus hide to tray when minimized in MAA, this is what happens. Find it in the tray at the bottom right and click it to keep configuring. If that gets old, switch to silent mode.

Error: the main program must be a subpath of the script root directory

The script root directory is unset or wrong. Every other path is measured from it, so you have to set it correctly before you can set the main program path.

How do I know MAA's settings actually saved?

Open MAA from inside AUTO-MAS, configure it, then come back to AUTO-MAS and click Save configuration. Settings you change by opening MAA directly, bypassing AUTO-MAS, are not recorded.

Silent mode is on but the emulator doesn't minimize

Check that the emulator's boss key is set correctly, and that no other software has claimed that key combination.

The scheduling queue didn't run at its scheduled time

Two things to check: whether Scheduled run is actually enabled, and whether the app was closed or the computer went to sleep or hibernation (see below).

Can it run while the computer is asleep or hibernating?

No. Sleep and hibernation stop the program entirely, and no current script supports being used that way. For scheduled runs, the computer has to stay awake.