Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Save DiceTsuki/770b229126354e5167e45ae0d5de3d0c to your computer and use it in GitHub Desktop.
Save DiceTsuki/770b229126354e5167e45ae0d5de3d0c to your computer and use it in GitHub Desktop.
Wuthering Waves: Manual Install & Update (PC/Windows) (Global)

About

Originally posted on: https://old.reddit.com/r/WutheringWaves/comments/1esf3g8/wuthering_waves_manual_update_pc/

Generate Your Own Download/Update URLs

Important: You must have Python: https://www.python.org/downloads/ installed to run py file.

  1. Download WuWa_Manual_Download_URLs.py.

  2. For predownload:

    Edit the py file: change release_ch = "default" to release_ch = "predownload".

  3. Run the py file.

  4. Two files will be generated:

    1. wuwa_[version]_bigpaks_urls.txt e.g. wuwa_2.0.2_bigpaks_urls.txt:

      Contains update files' URLs.

    2. wuwa_[version]_bigpaks_hashes.md5 e.g. wuwa_2.0.2_bigpaks_hashes.md5:

      Contains update files' hashes (MD5).

  5. By default, only pak files with the size of >= 100 MB will be included inside the generated files.

    You can set output_bigpaks_only = False inside the py file to include all files (including non-pak files).

  6. URLs and hashes inside the txt and md5 files respectively are sorted by size (top: biggest; bottom: smallest).

Manual Install

  1. Download and install Wuthering Waves launcher from official website:

    https://wutheringwaves.kurogames.com/en/main

  2. Open the generated txt file and download all pak files listed in it.

    Hash checking (optional; for checking corrupted download):

  3. Right-click Wuthering Waves shortcut at desktop > Open file location.

  4. Create this path (subfolders) inside the opened folder: Wuthering Waves Game\Client\Content\Paks.

  5. Copy/Move the downloaded pak files into Wuthering Waves Game\Client\Content\Paks.

  6. Open the launcher > Click Download. Checking game resources will be displayed.

  7. The launcher will check for the downloaded pak files' integrity and will download the rest of the game files (around 1-2GB).

Notes:

  • If you use OpenHashTab for hash checking, be aware that there is a display bug where:

    • There are many files listed inside md5 file.

    • Some of them do not exist inside storage.

    • OpenHashTab will list all hashes as The system cannot find the file specified.

    • The hash checking is still happening, as evidence by a sharp increase of disk usage.

    Just wait until the disk usage returns to normal, which means that the hash checking is complete.

Manual Update

Basically similar to Manual Install, except:

  1. Overwrite existing pak files with the downloaded pak files after the update is live (can check with the launcher).

  2. Update the game with the launcher.

"""
Originally based on:
https://gist.github.com/Karylrz/88e65a22c32b99430a8aa2cad70ec266
New API link (for v2.2 and up) was taken from:
https://github.com/yuhkix/wuwa-downloader
It is recommended to use other actively maintained Wuthering Waves downloaders for faster update incase of new API change.
"""
import gzip
import json
import urllib.request
## [Options] ##
"""
API URL
-------
"""
index_api = "https://prod-alicdn-gamestarter.kurogame.com/launcher/game/G153/50004_obOHXFrFanqsaIEOmuKroCcbZkQRBC7c/index.json"
"""
Release Channel
---------------
Options:
- "default"
- "predownload"
"""
release_ch = "default"
"""
Resource CDN
------------
Options:
0: QCloud
1: AWS
2: Akamai
3: CloudFlare
4: Huoshan
"""
resource_cdn = 1
"""
MD5 Hash File
-------------
- md5_file_create = True:
Create MD5 file for hash checking (using OpenHashTab, 7-Zip etc.).
"""
md5_file_create = True
"""
* WuWa_Files: Wuthering Waves' files that need to be checked for their MD5 hashes.
- md5_file_full_path = True:
Put md5 file in "Wuthering Waves Game" folder and WuWa_Files need to be in correct paths inside the folder.
- md5_file_full_path = False:
WuWa_Files need to be in the same folder as md5 file.
"""
md5_file_full_path = False
"""
Output Files
------------
- output_bigpaks_only = True:
Only insert "big" pak files inside output files (urls and hashes).
"""
output_bigpaks_only = True
"""
- output_bigpaks_min_size:
Minimum size of pak file (in bytes) to be considered as "big".
"""
output_bigpaks_min_size = 100000000
## [/Options] ##
## [Global Variables] ##
wuwa_version = ""
## [/Global Variables] ##
def get_response(url):
response = urllib.request.urlopen(url)
response_data = response.read()
if response.headers.get("Content-Encoding") == "gzip":
response_data = gzip.decompress(response_data)
return response_data
def get_name(suffix):
prefix = "wuwa_%s_" % (wuwa_version)
infix = ""
if output_bigpaks_only:
infix += "bigpaks_"
return "%s%s%s" % (prefix, infix, suffix)
index_json = json.loads(get_response(index_api))
wuwa_version = index_json[release_ch]["version"]
resource_domain = index_json["default"]["cdnList"][resource_cdn]["url"]
resource_api = resource_domain + index_json[release_ch]["resources"]
resource_base = resource_domain + index_json[release_ch]["resourcesBasePath"]
resource_json = json.loads(get_response(resource_api))
resources = resource_json["resource"]
resource_urls = []
resource_md5 = []
for resource in resources:
if output_bigpaks_only and (resource["dest"].split(".")[-1] != "pak" or resource["size"] < output_bigpaks_min_size):
continue
resource_dest = resource["dest"]
resource_urls.append(resource_base + resource_dest)
if md5_file_create:
if md5_file_full_path:
resource_dest = resource_dest[1:]
else:
resource_dest = resource_dest.split("/")[-1]
resource_md5.append(resource["md5"] + " *" + resource_dest)
urls_file = open(get_name("urls.txt"), "w")
urls_file.write("\n".join(resource_urls))
urls_file.close()
if md5_file_create:
md5_file = open(get_name("hashes.md5"), "w")
md5_file.write("\n".join(resource_md5))
md5_file.close()
@studiobutter
Copy link

Hey! Found the script. It works for Generate the Download link files but unfortunately downloading those files a bit Tricky. It asks you for a key which IDK. Also the URL won't as Kuro have switch to a new Launcher system. So you will have to replace the URL as well

@DiceTsuki
Copy link
Author

Hey! Found the script. It works for Generate the Download link files but unfortunately downloading those files a bit Tricky. It asks you for a key which IDK. Also the URL won't as Kuro have switch to a new Launcher system. So you will have to replace the URL as well

I have updated the API link.
But in the future, it is better if you use other wuwa downloaders such as
https://github.com/yuhkix/wuwa-downloader
I don't play the game anymore, so i'm not aware of any changes made by Kuro.

@roromao2010
Copy link

roromao2010 commented Jul 20, 2025

slt,, jai executer le script et avoir les fichiers generes. Cependant lors du telechargerment des .txt, il y s échec

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment