# WutheringWavesTool replaces the launcher and adds the numbers

> WutheringWavesTool is a third-party desktop launcher for Wuthering Waves, written in Java with JavaFX, and it does three separate jobs: it starts the game, it manages the game files, and it reads the game's own data back out to show you gacha history, playtime and daily statistics. The feature table is split between the Chinese and global servers, and that split is the most useful thing in the documentation.

**leck995/WutheringWavesTool** — 鸣潮助手，鸣潮工具集与启动器，主要功能有获取角色信息，解锁帧率，实现库街区签到，游戏时长统计以及抽卡分析(支持国际服账号)。

- Repository: https://github.com/leck995/WutheringWavesTool
- Website: https://wwt-doc.999758.xyz
- Stars: 969 · Forks: 33
- Language: Java
- License: not declared
- Published: 2026-10-20 · Updated: 2026-10-20 · Language: en
- Canonical page: https://hysenlabs.com/projects/leck995-wutheringwavestool

## A launcher, a file manager and a statistics panel

The project describes itself as a third-party PC tool for Wuthering Waves that can replace the native launcher, with built-in gacha analysis, game data management and resource updating, and it says its aim is to improve the game experience and the handling of your data. The badge line gives the stack, Java 25 with JavaFX 26, and the tree confirms it, with a `wwt-app/` module for the application, a `wwt-game-resource-core/` module for the game asset side, and a `wwt-kuro-api/` module for the community service the tool integrates with. So this is not a patch or an overlay, it is a full replacement launcher written in Java, and the depth of what it does is best seen in the feature table, which lists twelve capabilities and marks each one for the Chinese server and the global server separately.

## The feature table, and where the two servers differ

The table is the most informative part of the readme, because it is a matrix of feature against server. The launcher itself is available on both, described as replacing the native launcher with extras such as the wiki and screenshot browsing, and the advanced launch options are on both, a one click setting of DX11 or DX12 and custom launch arguments, which is also where the frame rate option lives. Resource management is on both, covering game resource updating, verification and repair, pre-download and server switching. The gacha analysis with its several views and statistics, the playtime statistics of daily and total time, the battle data statistics of battles fought, echoes obtained and dodges, the basic daily data of stamina, task radio and chest counts, and the redemption code lookup with reminders are all on both servers as well. The four features marked for the Chinese server only are the community area check-in, the character viewer, the progression calculator and the tower history, and the readme explains why in one line, that the global server does not support the community area, so the international version has fewer features.

## The community check-in, and what it automates

The check-in feature is the one to look at most carefully, because it is the only part of the tool that acts on your account without you. The table says it supports up to nine accounts being signed in at the same time, and keeps a count of the items received from the check-ins, and it is marked as unavailable on the global server. The rest of the tool is read only with respect to your account. The character viewer shows the details of the characters you own, their resonance chains, levels, weapons and echoes. The progression calculator works out the materials needed to level a character or a weapon. The tower history shows your historical data from the deep tower. So the tool has two halves, a data half that reads the game's services and shows you your own history, and an automation half that claims a daily reward across several accounts.

## Resource management, and the launcher options

The resource management features are the ones that will matter if you have ever had a corrupted install, because they cover updating the game assets, verifying and repairing them, pre-downloading, and switching servers. The launcher features are the everyday ones, a replacement for the stock launcher, the wiki and a screenshot browser in the same window, and the advanced launch screen where the graphics API and the command line arguments are set. The project description also lists unlocking the frame rate among its main functions, and the advanced launch screen is where that kind of option belongs, in the launcher's own settings rather than in a modification of the running game. The project also ships a documentation site, linked as the tutorial, and a separate wiki for the game itself is what the launcher integrates.

## The statistics half, and the local database

The gacha analysis is the feature the project leads with in its own description, offering several views and statistics over your pull history, and it is the piece that needs the most from the game's services. The playtime and battle statistics are simpler and are recommended by the readme, counting daily play time and total time, and counting daily battle data such as how many battles were fought, how many echoes were obtained and how many dodges. The basic game data covers daily stamina, the task radio and the counts of the different chests. All of that has to live somewhere, and the tree answers the question, since one of the acknowledged dependencies is SQLite JDBC, and the project is a desktop application with a local store rather than a service that reports to a website.

## Building it needs a very recent JDK

The build requirements are JDK 25 or newer and Maven 3.9 or newer, and the four commands are these:

```bash
git clone https://github.com/leck995/WutheringWavesTool.git
cd WutheringWavesTool
mvn clean compile
mvn javafx:run -pl wwt-app
```

The last one is the one to note, since it runs the JavaFX module rather than the whole reactor, and the module name tells you the application is a separate artifact from the core libraries. The repository also ships the Maven wrapper, `mvnw` and `mvnw.cmd`, and a `.mvn/` directory, so you do not need Maven installed to build it even though the readme asks for it. The build is also configured for GitLab, with a `.gitlab-ci.yml` at the root, which is an unusual choice for a project hosted on GitHub and suggests where the automation actually runs.

## The dependency list, the licence question and the release rhythm

The acknowledgements are a good map of what the tool is built on. The user interface is OpenJFX with ControlsFX for the widgets, MvvmFX for the MVVM structure, AtlantaFX for theming and Ikonli for the icon set. The parts that touch the machine are JNativeHook, for global keyboard and mouse hooks, and JNA, for the native access. The image handling is Thumbnailator, the JSON is Jackson, the local store is SQLite JDBC, and one of the acknowledgements is Collapse, another launcher. The licence is the odd part. The readme carries an MIT badge, while the licence field in the repository's own settings is empty, so for a project of this size that is a question worth asking the maintainer rather than assuming. On versions, the releases are 1.6.0, 1.6.1 and 1.6.2 in August 2026, with the last push to the repository on 2026-08-27, and the default branch is `new-ui`, so the work is happening on a branch that is named for what it is doing.

## Conclusion

WutheringWavesTool suits a Wuthering Waves player who wants a launcher with the community wiki and screenshot browsing in it, who wants the game files verified and repaired rather than left to chance, and who wants their gacha history and playtime in a local database they can query. It is a poor fit if you only want to play the game, since the stock launcher does that, and it is a poor fit if you are on the global server, where the documentation says several features are simply not available because the global server does not have the community area the tool signs into. Before you run it, check three things: which server you are on, since the feature table shows the difference plainly, that the tool talks to the game's services with your account, which is worth being deliberate about, and the licence, because the readme carries an MIT badge while the repository itself records no licence.

## FAQ

### What is WutheringWavesTool?

A third-party PC launcher and companion tool for Wuthering Waves, written in Java with JavaFX, which can replace the native launcher and adds gacha analysis, resource updating and repair, playtime and battle statistics, a character viewer and a progression calculator. It supports both the Chinese and the global servers, with fewer features on the global server.

### Which WutheringWavesTool features work on the global server?

The launcher and the advanced launch options, resource management, gacha analysis, playtime statistics, battle data statistics, the basic daily game data and the redemption code lookup are on both servers. The community area check-in, the character viewer, the progression calculator and the deep tower history are marked for the Chinese server only, because the global server does not have the community area.

### How do I build WutheringWavesTool?

You need JDK 25 or newer and Maven 3.9 or newer. Clone the repository, then run `mvn clean compile` and `mvn javafx:run -pl wwt-app` to launch the application. The repository also ships the Maven wrapper, so the wrapper scripts work without Maven installed.

### What libraries is WutheringWavesTool built on?

OpenJFX with ControlsFX, MvvmFX and AtlantaFX for the interface, Ikonli for icons, JNativeHook for global input hooks, JNA for native access, Thumbnailator for images, Jackson for JSON, SQLite JDBC for local storage, and Collapse, another launcher listed in the acknowledgements. The application module is wwt-app, alongside a game resource core module and a module for the community service API.

### What licence is WutheringWavesTool under?

The readme carries an MIT badge, while the licence field in the repository's own settings is empty, which is worth clarifying with the maintainer before redistributing it. The releases are 1.6.0, 1.6.1 and 1.6.2 in August 2026, and the last push to the repository was on 2026-08-27.

## Sources

- [Issues](https://github.com/leck995/WutheringWavesTool/issues)
- [leck995/WutheringWavesTool on GitHub](https://github.com/leck995/WutheringWavesTool)
- [Project website](https://wwt-doc.999758.xyz)
- [README](https://github.com/leck995/WutheringWavesTool/blob/new-ui/README.md)
- [Releases](https://github.com/leck995/WutheringWavesTool/releases)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/leck995-wutheringwavestool