Element
Download

Download WuWaConfig — Free Wuthering Waves Optimizer APK

Free and open source (MIT). Current version v1.1.7. Android 8.0+, no root, no PC.

v1.1.7 · MIT License · Not affiliated with Kuro Games

The Story

I faced it. I planned it. I built it — and I'm still fixing it.

I'm not a professional developer. I'm a gamer — same as you. I faced the same problem: hand-editing INI files, copying configs that were never made for my phone. So I planned a tool and built it. The config editor works today. The generator reads your device because no one person can hand-tune files for every chipset. And when something breaks on your phone — tell me. That report becomes the next fix. Built by a player, for players.

Built by a player like you Not a company — no ads, no data games Still fixing it — openly
Facedthe pain was real Planneda tool, not a hack Builteditor + generator Still Fixingyour issues = the roadmap
01 / Requirements

System Requirements

What you need before installing.

ItemRequirement
Android8.0 or newer (not available on iOS or desktop)
GameWuthering Waves installed
Access methodADB Wireless (pairing on Android 11+), Shizuku, Root (Magisk / KernelSU / APatch) or SAF
PC / cableNot needed — the ADB protocol is built into the app
02 / Install

Installation Guide

Five steps from download to boosted.

Download the APK

Get the latest APK from the GitHub release page.

Install it

Allow installs from your browser or file manager when Android asks, then install.

Pick an access method

ADB Wireless is recommended; Shizuku works without root; SAF is read/write only.

Analyze and generate

SmartBrain reads your Client.log, picks a preset; generate and deploy.

Verify

Check the deploy result; restore the automatic backup any time.

08 / Access Methods

Rooted or Stock — You're Covered

ADB Wireless Recommended Full Access

Native in-app ADB wire protocol — no external binary. Full RSA 2048-bit auth handshake (SHA1withRSA, SSH-RSA pubkey), Android 11+ wireless pairing with the code from Developer options, auto port scanning and MD5-verified chunked pushes.

Ports 37,000–44,000 + 5555Wireless pairing (Android 11+)Loopback checked firstRSA 204815s keepaliveKeys sealed by the hardware KeyStore

Shizuku Best Non-Root No Root Needed

Binder-based UserService with graceful fallbacks and automatic temp-file cleanup. No compile-time dependency on the Shizuku API. If the bind stalls on a Chinese ROM, an in-app walkthrough points you at the exact settings to change.

45s bind, retried once75s command timeoutScript fallback >4096 charsROM fix guideAuto-cleanup

Root Full Access

Direct su -c shell via Magisk, KernelSU or APatch. No chunking needed — straight file operations with exit-code verification.

10s timeoutDirect cpExit code verify

SAF Read / Write Only

Storage Access Framework via DocumentFile with a persistable tree URI and 3-strategy path resolution. No shell — safest option.

No shell accessPersistable URI3-strategy resolution

Disclaimer: Fan-made tool, not affiliated with Kuro Games or Wuthering Waves. Modifying game files may be subject to the game's Terms of Service. Use at your own risk. Android-only (8.0+) — not available on iOS or desktop.

03 / Changelog

Changelog & Version History

Release notes are published on GitHub.

VersionNotes
v1.1.7Current release — full notes on the GitHub release page.
EarlierAll previous versions: GitHub Releases
11 / Tech & Deploy

Under the Hood

How deployment stays safe, and what the app is built with.

Deploy pipeline
SNAPSHOT HASHES→AUTO-BACKUP→PUSH (RETRY ×2)→RECONCILE HASHES→VERIFY LOG

Your game's 70+ [Core.System] paths are read off the device and re-applied, so plugin content keeps resolving. Files go via a staging directory with retry and are only reported as deployed once the whole pipeline finishes — a hash-sync or verification failure is a failure, not a warning.

Deploy safety system
D.01

Hash Sync

KuroConfigMonitor snapshots hashes before deploy and reconciles after — concurrent game access is detected. ModifyCount capped at 8; atomic .new → rename push with read-back verification.

D.02

Deploy History

deploy_history.json stores up to 20 records: preset, method, files, accepted / redundant / unknown counts, plus baseline & outcome metrics (FPS, thermal, OOM, drops) for delta comparison.

D.03

One-Tap Retune

Every deploy history entry keeps the settings it shipped with, so you can redeploy it adjusted — never an automated loop. Stable (±5 FPS, no OOM): keep. Degraded: screen ×0.75, shadow −2, detail −1, reflections and draw distance cut. New OOM: back to the Potato baseline. Improved: screen ×1.15, shadow +1.

Built with
Kotlin 2.2.20 Jetpack Compose BOM 2026.04.01 MVVM + StateFlow Material 3 Navigation 3 AGP 9.4.0 Gradle 9.6.0 SDK 26+ / Target 36 Gson Coil 3 System Agent Functions ExoPlayer JUnit 4 ktlint ProGuard

Security notes: ADB key material sealed with AES-256-GCM under a hardware-backed platform KeyStore key (older installs migrated on first load) · cleartext permitted only to 127.0.0.1 / localhost · gacha polling via in-process LocalBroadcastManager · allowBackup=false · the system agent surface is read-only and bound to the system's app-function permission.