> For the complete documentation index, see [llms.txt](https://docs.akiraghost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.akiraghost.com/product-guides/akira-jni/troubleshooting.md).

# Troubleshooting

Most JNI issues come down to a handful of causes. Work through the section that matches your symptom.

## Akira won't inject or the menu won't open

The usual suspects, in order:

{% stepper %}
{% step %}

### Check your setup is supported

Akira JNI only injects on Minecraft 1.7.10 or 1.8.9 through Vanilla, Forge, or Lunar. An unsupported version or launcher won't load. See [Compatibility](/product-guides/akira-jni/compatibility.md).
{% endstep %}

{% step %}

### Whitelist Akira in your antivirus

If your antivirus quietly quarantined Akira, injection fails silently. Whitelist it — our [whitelist tool](https://akiraghost.com/utils/whitelist.bat) handles Windows Defender, BitDefender, ESET, and Avast.
{% endstep %}

{% step %}

### Confirm you're logged in

Akira injects once you're signed in and the game is running. Make sure login succeeded, then open or restart Minecraft.
{% endstep %}

{% step %}

### Restart both, as admin

Close Akira and Minecraft, then run Akira as administrator and launch the game again. A clean start clears most stuck injections.
{% endstep %}
{% endstepper %}

When the menu does open, press your menu key in-game to toggle it.

## Akira or the game crashes on load

A crash right as Akira loads usually points at a missing system dependency.

{% stepper %}
{% step %}

### Update Windows

Install the latest Windows 10/11 updates.
{% endstep %}

{% step %}

### Install the Visual C++ Redistributable

Install the latest [Microsoft Visual C++ Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe).
{% endstep %}

{% step %}

### Install Java x64

Install the latest [Java x64](https://javadl.oracle.com/webapps/download/AutoDL?BundleId=248242_ce59cff5c23f4e2eaf4e778a117d4c5b) and remove any old version.
{% endstep %}

{% step %}

### Repair system files

Open an elevated command prompt and run:

```bash
sfc /scannow
DISM /Online /Cleanup-Image /RestoreHealth
```

Restart afterward.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Want a one-click pass at these fixes? Run our [QuickFix script](https://akiraghost.com/utils/QuickFix.bat).
{% endhint %}

## The menu opens but ESP and visuals don't show

* Confirm the visual module is enabled and bound, and that its keybind is actually active.
* Some visuals only render in-world — make sure you're in a game, not on a menu screen.
* If you run capture software, check whether Stream Proof is on. It hides visuals from screen capture, which can also hide them from you if it's misconfigured. See [Stream Proof](/product-guides/akira-jni/features/misc.md).

## I get kicked when joining a server

* Turn on **Client Brand Changer** and set it to `vanilla` or `forge`. Some servers auto-kick clients whose signature they don't recognize. See [Misc features](/product-guides/akira-jni/features/misc.md).
* Disable the most aggressive modules first (the ones marked as highly detectable) and re-enable them one at a time to find the culprit.

## Still stuck?

Reach out through our support channels with your launcher, Minecraft version, and a description of what happens. The more detail, the faster we can help. See [Support](/faq/general-questions/support.md).