Wuthering Waves Wish URL Finder (Linux)

A Linux bash script that automatically finds and extracts your Wuthering Waves convene/wish history URL from game log files. This URL can then be used with WuWa Tracker to import your wish history.

Quick Start

One-Line Installation & Run

curl -sSL https://git.yumeo.dev/Yumeo/wuwa-wish-url-finder/raw/branch/main/import.sh | bash

Manual Download & Run

# Download the script
wget https://git.yumeo.dev/Yumeo/wuwa-wish-url-finder/raw/branch/main/import.sh

# Make it executable
chmod +x import.sh

# Run it
./import.sh

Prerequisites

1. Open your Convene History first!

   • Launch Wuthering Waves
   • Go to Convene → Records → Details
   • Browse through your wish history tabs
   • Then run this script

2. Install clipboard tools (optional, for automatic clipboard copying):

   # For X11 systems
   sudo apt install xclip
   # OR
   sudo apt install xsel
   
   # For Wayland systems
   sudo apt install wl-clipboard
   

Supported Game Installations

The script automatically searches for Wuthering Waves installations in:

Steam/Proton

• ~/.steam/steam/steamapps/common/Wuthering Waves
• ~/.local/share/Steam/steamapps/common/Wuthering Waves
• ~/.var/app/com.valvesoftware.Steam/.local/share/Steam/steamapps/common/Wuthering Waves (Flatpak)
• Custom Steam library locations (detected automatically)

Wine

• ~/.wine/drive_c/Program Files/Wuthering Waves
• ~/.wine/drive_c/Program Files (x86)/Wuthering Waves
• ~/.wine/drive_c/Program Files/Epic Games/WutheringWavesj3oFh
• Custom Wine prefixes in ~/.local/share/wineprefixes

Lutris

• ~/Games/*wuthering* (case-insensitive search)

Mounted Windows Drives

• All mounted drives with Windows-style paths:
  • /mnt/windows/Program Files/Wuthering Waves
  • /media/*/Program Files/Epic Games/WutheringWavesj3oFh
  • And many other common Windows installation paths

How It Works

1. Automatic Search: The script searches common installation locations for Wuthering Waves
2. Log Analysis: Examines game log files for the convene history URL:
   • Client/Saved/Logs/Client.log
   • Client/Binaries/Win64/ThirdParty/KrPcSdk_Global/KRSDKRes/KRSDKWebView/debug.log
3. URL Extraction: Finds and extracts the wish history URL
4. Clipboard Copy: Automatically copies the URL to your clipboard (if clipboard tools are available)

Troubleshooting

No URL Found?

1. Did you open Convene History? This is the most common issue - you must browse your wish records in-game first
2. Check Engine.ini: The script will detect if logging is disabled and provide instructions to fix it
3. Third-party tools: Some tools can interfere with game logs - try disabling them

Game Not Found?

• The script will prompt you to manually enter your game installation path
• Common manual paths:

  ~/.steam/steam/steamapps/common/Wuthering Waves
  ~/.wine/drive_c/Program Files/Wuthering Waves/Wuthering Waves Game
  /mnt/windows/Program Files/Epic Games/WutheringWavesj3oFh
  

Permission Issues?

• Ensure the script has execute permissions: chmod +x import.sh
• For mounted Windows drives, you may need proper mount permissions

Usage with WuWa Tracker

1. Run this script to get your wish URL
2. Visit wuwatracker.com/import
3. Paste the URL and click "Import History"
4. Your wish history will be imported automatically

Support

• Discord: wuwatracker.com/discord
• Issues: If the script finds your game directory but can't extract the URL, make sure you've opened your Convene History in-game first

License

This script is licensed under the GNU General Public License v3.0 (GPL-3.0).

Credits

• Originally created by @theREalpha for Windows PowerShell
• Linux port and enhancements
• Thanks to the WuWa Tracker community for testing and feedback