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 installation
PS C:\> scoop bucket add aoko https://github.com/naczo5/aoko-client
PS C:\> scoop install aoko
built with c# · c++ license gpl-3 for windows x64
aoko client · interactive preview
a closer look

Explore the control surface in your browser — no download needed.

opens a simulated desktop · press esc to close

01 / modules Everything in one place

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

combat9
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.

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.

antidebuffsurvival

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

movement2
speedbridgeassist

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

blockparty assistassist

Reads the safe color and helps you get there in PixelParty / BlockParty rounds.

visual6
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 & logohud

Configurable in-game module list (default, minimal, outlined, glass, bold) with optional logo.

utility6
autotoolinventory

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

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.

chest stealerinventory

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

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.

versionlatest (main)
targetlunar & standalone (1.8.9 forge · modern fabric)
platformwindows x64
licensegpl-3
open latest releases →

# or build from source — see README.md