Wuthering Waves Toolbox

English | 中文

Welcome to Wuthering Waves Toolbox, a handy CV-based toolset aiming at providing holistic, rigorous analysis and automation to help you better understand your in-game statistics.

Wuthering Waves Toolbox is still under intense developing. Currently, it integrates customizable echo analysis and echo scan&upgrade automation, which adopts the optimal strategy to reduce the wasted resources.

We only support Windows(x86) so far considering that most users prefer playing WW on Windows other than other platforms.

• Python (3.8 or newer, we recommend 3.11)
• Node.js (which includes npm)
• Visual Studio Build Tools (make sure to select "Desktop development with C++").
• (Optional) Install CUDA for gpu acceleration.

1. Clone the repository:

   git clone git@github.com:PlanarG/ww-toolbox.git
   cd ww-toolbox

2. Set up the Python backend: We recommend to use conda to create a virtual environment to manage dependencies.

   # Create a virtual environment
   conda create -n ww-toolbox python=3.11
   
   # Activate the virtual environment
   conda activate ww-toolbox
   
   # Install dependencies
   pip install -r requirements.txt
   
   # Check Python dependencies installation and build C++ interfaces
   pip install -e .

3. Set up the Electron frontend:

   # Navigate to the frontend directory
   cd frontend
   
   # Install Node.js dependencies
   npm install

4. Run the application: Once both the backend and frontend are set up, you can start the application in the ./frontend directory.

   # From the frontend directory
   npm start .

   The application will launch with administrator privileges and start the Python backend in the background since it requires administration to take screenshots of the game.

Coming soon

Wuthering Waves Toolbox is distributed under the MIT License. See LICENSE for more information.