aoko client

A free, open-source utility client and external overlay supporting 1.8.9 (Forge), 1.21.x, 26.1, and 26.2 (Fabric) - on both Lunar Client and standalone Minecraft instances.

powershell · scoop install
> scoop bucket add aoko https://github.com/naczo5/aoko-client
> scoop install aoko
built with c# · c++ license gpl-3 for windows x64
video preview
Aoko GUI video preview
0:16 tour 30 fps

01 / modules Everything in one place

Every module aoko ships, grouped by subsystem. Expand a row for details.

combat10
▸killauracombat

Automated targeting with configurable CPS, swing & attack ranges, FOV, auto-block, and smooth rotation noise.

▸autoclickerinput

LMB/RMB with configurable CPS range, jitter, block-only mode, and GUI/chest safety checks.

▸aim assistaim

Adjustable FOV, targeting range, and smoothing strength for on-target correction.

▸triggerbotaim

Crosshair-gated firing with a cooldown threshold and hit-chance controls.

▸auto rodcombat

Auto/forced hotbar selection with one-use action bind and exact previous slot restoration.

▸throwpotcombat

Instantly throws the first healing splash potion in your hotbar via action bind and restores your slot.

▸autohealcombat

Automatically throws a healing splash potion when your health drops below a configurable threshold.

▸reachcombat

Reach extender with a tunable range and hit-chance gate.

▸velocitycombat

Knockback dampener with horizontal / vertical percentages and hit-chance.

▸autototemsurvival

Ghost (inventory-only) and anarchy modes, health threshold, and elytra switch.

movement2
▸speedbridgeassist

Edge sneak assist with block-only, hold-sneak, looking-down, and safety timing controls.

▸pixel party assistassist

Scans matching floor tile colors and assists pathing in PixelParty / BlockParty rounds.

visual7
▸nametagsesp

Player tags detailing health, armor tier, and held items.

▸closest playerhud

On-screen panel showing direction, exact distance, and equipment of the nearest player.

▸fight statushud

Shows recent fight health and damage status in-game.

▸chest espesp

Chest highlighting through walls with count limits and distance culling.

▸block espesp

Highlights configured block types through terrain for quick scanning.

▸bedplatesesp

Highlights player beds with in-world bounding boxes and distance indicators.

▸module list & hud editorhud

Configurable in-game module list (default, minimal, outlined, glass, bold), logo, and in-game HUD positioning editor.

utility8
▸refillinventory

Moves healing potions and golden apples from backpack into empty hotbar slots while your inventory is open.

▸autotoolinventory

Auto weapon swap on hover, optimal block mining tool selection, and Bedwars mode.

▸chest stealerinventory

External cursor-based stealer with menu checks that empties containers fast.

▸antidebuffsurvival

Hides Blindness and Nausea client-side, plus Darkness on 1.21.x / 26.1 / 26.2.

▸nick hiderstealth

Replaces your in-game username with a custom alias locally via native JVMTI string filtering.

▸hit delay fixcombat

Removes 1.8.9 attack cooldown delays for responsive hits.

▸gtb helperoverlay

Reads Guess-The-Build hints and lists candidate words in an overlay.

▸discord rpcintegration

Live state, version, and active module count surfaced through Discord Rich Presence.

02 / architecture How aoko connects

How the loader and native bridge talk to the game.

loader
c# / .net 8 wpf
  • locates javaw.exe
  • injects the bridge dll
  • owns gui, profiles, keybinds
  • discord rpc
tcp · 25590
bridge
c++ jni overlay
  • attaches to the jvm
  • reads game state
  • renders imgui via SwapBuffers
  • yarn → mojmap fallback
jni
jvm
lunar & standalone
  • 1.8.9 · Forge / OptiFine
  • 1.21.x · Fabric (Yarn)
  • 26.1 & 26.2 · Fabric (Mojmap & Vulkan)

03 / setup Start simply

Injecting into a running world is recommended so every module initializes.

requirements
  • windows 10/11 x64
  • lunar client or standalone minecraft (1.8.9 forge, modern fabric)
  • release exe is self-contained - no .net install
  • mingw-w64 + jdk 17 headers (build only)
usage
  1. launch minecraft / lunar client, join a world.
  2. run Aoko.exe.
  3. click inject.
  4. drive everything from the external gui.
  5. bind keys on each module card to toggle that module.

04 / download Make it yours

Open-source build for Windows x64.

versionv11.5
targetlunar & standalone (1.8.9 forge · modern fabric)
platformwindows x64
licensegpl-3
open latest releases →

# or build from source - see README.md