FgoGotran Troubleshooting

Most real-device problems come from overlay permission, accessibility, the API key or the Speech key.

1. Make sure overlay permission is granted.
2. Make sure the FgoGotran accessibility service is enabled.
3. If the button does not appear, turn the accessibility service off and on again in system settings — this is usually the most important fix.
4. If the home screen shows it as disabled, fix that permission before starting the service.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

Only the JP server needs a translation API; the Simplified and Traditional Chinese servers mainly read Chinese text and speak it.

1. Open the API settings page and tap “Test API”.
2. Check the API key, model name and endpoint.
3. For the Simplified/Traditional Chinese servers, check the voice settings instead of the translation API.

Confirmed fixed: “Test API” succeeds and tapping GO in-game shows a translation.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

AI voice is off, the Speech key is missing, or the region is wrong.

1. Open voice settings and make sure AI voice is on.
2. Make sure the Speech key is filled in and the region is correct.
3. Tap “Test voice” to confirm audio comes back.

Confirmed fixed: The voice test succeeds and in-game playback works.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

The text is not fully displayed, or the crop area includes too much unrelated UI.

1. Wait until the text is fully displayed before tapping GO.
2. In crop mode, frame the complete text area.
3. Avoid including too much unrelated UI.

Confirmed fixed: After tapping GO again, the translation covers the correct text.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

Older, 32-bit or beta kernels are more likely to hit screenshot, OCR, native-library and accessibility compatibility problems.

1. Create a 64-bit instance first.
2. Make sure the Android version is 11 or newer.
3. For MuMu, LDPlayer and BlueStacks, prefer a 64-bit instance.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

First work out whether this is an API/OCR problem or an emulator screen-event problem.

1. Test once with manual GO.
2. If manual GO works, test semi-auto and auto.
3. If manual GO also fails, check screenshots, OCR, the API or the voice settings.

Confirmed fixed: If manual GO translates, the API and OCR are basically working.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

This is usually an emulator graphics-layer problem: Android is not giving the app a usable game screenshot.

1. Try switching the renderer between OpenGL, DirectX and Vulkan.
2. Restart the emulator.
3. Reproduce the problem once, then check the error log.

Confirmed fixed: After switching renderers and restarting, manual GO returns a screenshot.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

The emulator may report the permission as granted while actually blocking the overlay or the accessibility service.

1. Grant overlay permission again.
2. In system accessibility settings, turn FgoGotran off and on again — this is usually the most important step.
3. Start the service and check whether GO / Semi / Auto appear.

Confirmed fixed: After starting the service, the GO / Semi / Auto buttons appear normally.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

If manual GO works but auto mode does not, it is usually not an API problem but unstable emulator screen events, screenshot refresh or game-window state.

1. Confirm manual GO works.
2. Check that the game window is stable and not covered.
3. Watch whether screen-change detection is triggered.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

B-server, TW-server, channel builds or emulators with modified package names may not be on the supported list.

1. Export the error log TXT.
2. Make sure the TXT includes package, class and app label.

Confirmed fixed: Send the TXT to the author so support can be added.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

Mirroring software only shows the phone screen on the PC. FgoGotran still runs on the phone and can only read what Android screenshots of the phone currently display.

1. Make sure the phone screen is still actually on and showing the game.
2. Do not use mirroring modes that turn the phone screen black.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

When the phone screen is off, black, or in a power-saving mirroring mode, Android may not give the app a real game screenshot, so OCR finds no text.

1. Keep the phone screen on.
2. Turn off screen-off, black-screen or power-saving mirroring modes.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

Wired mirroring is more stable than wireless and can keep the screen awake.

1. Prefer USB wired mirroring.
2. Keep the phone screen on.
3. scrcpy can use the stay-awake / keep-active options.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

Normal screen brightness usually does not affect Android screenshot pixels.

1. What actually matters is screen-off, black-screen, privacy-screen or special display layers — check those first.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

The app does not have permission to draw over other apps, so the button cannot appear over FGO.

1. Allow FgoGotran to display over other apps in system settings.
2. Go back to the home screen and start the service.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

Android is not delivering game screen events to FgoGotran.

1. Open the system accessibility settings.
2. Even if it shows as enabled, turn FgoGotran off and on again.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

Android or the emulator is not giving the app a usable game screenshot.

1. Keep the phone screen on.
2. Switch the emulator's graphics rendering mode.
3. Do not use black-screen mode while mirroring.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

The translation endpoint did not return normally.

1. Test again on the API settings page.
2. Check the key, model name, endpoint, balance and network.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

The voice service did not return audio normally.

1. Test the voice on the voice settings page.
2. Make sure the Speech key matches the region.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.

The app saw a package name that looks like FGO, but it is not on the supported list yet.

1. Export the error log TXT; it includes the package, class and app label.

Still failing? Export the error log TXT and describe your FgoGotran version, device, FGO server and mode, then send them to the author together.