Error Handling

Troubleshooting

Solutions for errors during installation, update, and running. If you encounter other problems, you can join the QQ group 823265807 for feedback.

Index

• Errors
  1. Wrong archive downloaded
  2. deploy.yaml configuration error
  3. Deployment configuration errors
  4. Antivirus flags nkas.exe
  5. updater.bat installation error
  6. Update failed
  7. "Source update" cannot update
  8. Unlink error / nkas.exe disappeared
  9. Update errors cannot be resolved
  10. Dependency (pip) installation error
  11. Error: reject by gitee
  12. Git Credential Manager popup
  13. Other Git-related errors
  14. Access denied / Start button stuck
  15. White screen / display abnormal
  16. Window flashes when "Run as Administrator" is checked
  17. Store purchase error
  18. In-game network error
  19. Game resolution incorrect
  20. Screen resolution does not meet requirements
  21. Abnormal colors
  22. Launcher path error
  23. Game window not found
  24. PC / emulator client configuration
  25. Launcher became vertical
  26. Wrong screen selected
• Old Version FAQ: Historical issues related to the old interface and emulators (Q1-Q10)

Errors

1. Wrong archive downloaded

Please read the Installation Guide and download the correct package.

2. config/deploy.yaml configuration error

config/deploy.yaml was edited incorrectly or not edited. Fix it with either of the following:

1. Carefully read the Installation Guide - Edit Installation Configuration, and modify config/deploy.yaml.
2. Or modify the deployment configuration directly on the Deploy page of the Web UI (a restart is required to take effect), to avoid YAML editing errors.

3. Deployment configuration errors

Fix with either of the following:

1. Refer to the Installation Guide - Edit Installation Configuration, and modify config/deploy.yaml.
2. Or modify it directly on the Deploy page of the Web UI.

4. Antivirus flags nkas.exe

This is a false positive; add it to the whitelist. nkas.exe is a Tauri 2 desktop program compiled with Rust and is not commercially code-signed, so it is easily misjudged. Add nkas.exe or the program directory to the antivirus whitelist; if it is still blocked, temporarily disable real-time protection and retry.

5. updater.bat installation error

The most common cause for users in Mainland China is domestic mirrors not configured. Check the domestic mirror configuration in config/deploy.yaml (see the Installation Guide - Basic Configuration), then re-run updater.bat.

6. Update failed

1. Re-run updater.bat.
2. If no error is reported, use the release package ending with full.
3. If nkas.exe (the desktop launcher) is corrupted or missing, you can also repair it with "Launcher Update" on the update page (only available in 1.x versions).

7. The "Source update" on the update page cannot update, or the update page displays abnormally

The update page is now divided into two sections: "Source update" and "Launcher update". The cause of this issue is not yet identified; try:

1. Delete the .git folder.
2. Run updater.bat.

8. Unlink xxxxxx error, or nkas.exe disappeared

1. Manually run updater.bat twice.
2. If nkas.exe is corrupted or missing, you can also repair it with "Launcher Update" on the update page (only available in 1.x versions).

9. Update-related errors cannot be resolved

1. Reinstall NKAS.
2. If only nkas.exe (the desktop launcher) is corrupted, you can first repair it with "Launcher Update" on the update page (only available in 1.x versions).

10. Dependency (pip) installation error

If you see No matching distribution found for XXX or a package download timeout, handle it as follows:

1. Re-run updater.bat.
2. If it still fails, change PypiMirror in config/deploy.yaml to another mirror (or modify it on the Deploy page):

Mirror	URL
PyPI Official	https://pypi.org/simple
Aliyun	https://mirrors.aliyun.com/pypi/simple/
Tsinghua	https://pypi.tuna.tsinghua.edu.cn/simple
Douban	https://pypi.douban.com/simple/

⚠️ The Tsinghua mirror may block requests due to heavy downloads (showing "Dear visitor"). Switch to the Aliyun mirror in that case.

11. Script error: reject by gitee

Try the following steps one by one:

1. Change network.
2. Change the git source: set Repository in config/deploy.yaml to https://git.megumiss.top/megumiss/NIKKEAutoScript or https://github.com/megumiss/NIKKEAutoScript (or modify it on the Deploy page).
3. Disable auto-update: set AutoUpdate in config/deploy.yaml to false.
4. If you encounter SSL certificate verification errors on an untrusted network, you can set SSLVerify in config/deploy.yaml to false.

12. Git Credential Manager or CredentialHelperSelector popup

Change the git source: set Repository in config/deploy.yaml to https://git.megumiss.top/megumiss/NIKKEAutoScript or https://github.com/megumiss/NIKKEAutoScript (or modify it on the Deploy page).

13. Other Git-related errors

Open \toolkit\Git\git-bash.exe under the script path and execute the command in the second red box in the image below.

14. Access denied, or the launcher's Start button keeps being clicked

NKAS must be run with Administrator privileges.

Access denied:

The Start button keeps being clicked:

15. White screen / display abnormal

The most common cause is a missing WebView2 Runtime (the NKAS UI depends on it for rendering). Check the following in order of priority:

1. Download/install or repair WebView2 Runtime from the Microsoft official site (Windows 11 usually has it preinstalled).
2. Clear the WebView2 cache: fully exit NKAS (including the tray icon), delete the directory %LOCALAPPDATA%\com.megumiss.nkas\EBWebView (i.e. C:\Users\YourUsername\AppData\Local\com.megumiss.nkas\EBWebView), then restart. The same applies to white screens when accessing via browser directly: press Ctrl+F5 to force refresh or clear site data for 127.0.0.1.

   Typical scenario: some software changes the file type of .js in the registry to text/plain, causing the UI scripts to be rejected by the engine and the bad result to be cached — the logs show all resource requests returning 304, but the page stays white. Clearing the cache forces a reload; if it recurs after clearing the cache, run the following with an administrator PowerShell to fix the registry, then restart the computer: reg add "HKLM\SOFTWARE\Classes\.js" /v "Content Type" /t REG_SZ /d "text/javascript" /f (newer versions already work around this in code).

3. Make sure the project is under a pure English path.
4. Press Ctrl+R several times to refresh the UI, or reopen nkas.exe.
5. Modify HardwareAcceleration in deploy.yaml (toggle hardware acceleration) and restart the desktop app.
6. If the UI scale is abnormal or blurry, modify DpiScaling and restart the desktop app.
7. Run netsh winsock reset in a terminal or PowerShell, and restart the computer.
8. Change WebuiHost to 127.0.0.1, or change WebuiPort to another port.
9. Confirm updater.bat ran successfully without errors; if necessary, switch the pip mirror and re-run it.
10. If you use a fixed IP or DNS, try changing it and retry.
11. If none of the above works: reinstall NKAS, set EnableReload to false (a legacy mechanism from old versions, not directly related to the white screen, only a last resort), or refer to Issue #876 (untested).

Other display anomaly examples:

16. Window flashes and closes instantly when "Run as Administrator" is checked, but opens normally when unchecked

If the system user is Administrator, you usually do not need to check "Run as Administrator". It may also be because the extracted path is on the C drive.

(No image available)

17. Store purchase error

Please check that the store purchase item is filled in correctly.

18. Error shown in the image below

It may be a problem with the accelerator (network booster).

19. Game resolution incorrect

1. Enable Game Resolution Compatibility Mode in the PC client settings.
2. Disable compatibility mode in the game icon's right-click Properties.

20. Screen resolution does not meet requirements

Refer to the PC Client Guide for solutions.

1080p screen users can enable the Rotate Screen option: when you click start, the screen will rotate to portrait mode to meet the vertical resolution requirement, and will automatically rotate back to landscape after the task ends. You can also use the hotkey Ctrl+F12 to manually rotate back to landscape.

21. Abnormal colors

Game settings not adjusted, the "Disable Auto HDR" option not enabled, or various software settings caused the color change. Please check the game settings recommendations in the PC Client Guide.

22. Launcher path error

Please fill in the correct launcher path.

23. Game window not found

The launcher path / game path / window process or title is filled in incorrectly. Check them one by one.

24. PC / emulator client configuration

1. For PC, manually select the client platform as Windows (PC Client).
2. For emulator, fill in the Serial.

25. Launcher became vertical

Read the small text under the Game Client option carefully.

26. Wrong screen selected

Check the Multi-monitor Mode and Game Window Target Screen options in the PC client settings.

---

Old Version FAQ

Of the following items, those related to the old interface (Q1, Q2, Q6, Q7) only apply to the removed old interface (pywebio era) and no longer apply to the new version; they are for reference only. The rest are game/emulator-related issues that may still occur in the new version.

Q1: "Failed to load resource" when running NikkeAutoScript.exe

This may be due to an incomplete update when running updater.bat. Try re-extracting the package and run updater.bat again.

Q2: The main window is blank except for the top bar.

Some dependencies may be missing. You can manually install them via CMD:
.\toolkit\python.exe -m pip install -r requirements.txt -i https://pypi.org/simple

Q3: updater.bat closes instantly.

This happens when GitHub is unreachable. You can set a proxy in the GitProxy field in config/deploy.yaml or modify your hosts file.

Q4: Unable to consult any NIKKE in Consultation Tasks.

Check the NIKKE graphics settings. Ensure both "Bloom Effect" and "Color Grading" are enabled, and that you have favorited the NIKKE you want to consult.

Q5: Task clicks in the wrong position.

This happens if the emulator's resolution is 1280x720 but NIKKE runs in portrait mode. Set it to 720x1280 and try again.

Q6: Update page shows "None".

Git not initialized — run updater.bat.

Q7: Stuck on the updating screen.

Same cause as Q3.

Q8: BaseError: ...apk not found during scheduler execution.

This occurs if NIKKE was downloaded from Google Play. Uninstall it and reinstall from QooApp.

Q9: "Network Error – Failed to load store checkout info" when entering the shop.

Likely caused by a missing Google Play login on the emulator. Log in to your account and try again.

Q10: OCR model file not found (e.g. 'FileNotFoundError: ...ch_PP-OCRv4_det_infer.onnx does not exist.')

The old solution was to copy bin\deploy\ch_PP-OCRv4_det_infer.onnx to the reported path, but this no longer applies: the current version has switched to the PP-OCRv5 model, located in the bin\paddleocr\ directory. If the model files are missing, re-run updater.bat to restore dependencies, or check whether the bin\paddleocr\ model directory is complete.