This is a command-line utility written in PHP that extracts files from World of Warcraft CASC archives.
Clone this repo, and run
composer install to get the requirements.
php casc.php --files <path> --out <path> [--wow <path>] [--cache <path>] [--program <wow>] [--region <us>] [--locale <enUS>] php casc.php --help -f, --files Required. Path of a text file listing the files to extract, one per line. -o, --out Required. Destination path for extracted files. -w, --wow Recommended. Path to World of Warcraft's base directory. -c, --cache Optional. Path for CASC's file cache. [default: $HOME/.casc-cache] -p, --program Optional. The NGDP program code (wow, wow_beta, wowt). [default: wow] -r, --region Optional. Region. (us, eu, cn, tw, kr) [default: us] -l, --locale Optional. Locale. [default: enUS] -h, --help This help message.
php casc.php --files dbcs.all.txt --out ./out --wow "$HOME/.wine/drive_c/Program Files (x86)/World of Warcraft"
This was written in a Linux environment, though it should also function in Windows. Windows compatibility has not yet been tested.
This requires at least 64-bit PHP 7.0.
This was designed specifically to extract data for World of Warcraft. Parts of it may happen to be compatible with other Blizzard games, but they have not been tested.
This tool is still in development, though most of the basic stuff is complete. It should be able to extract most files from both local and remote CASC sources.
Command line options and default functionality may change in later versions.
Major parts that are still unfinished or untested:
- Anything referenced in table B and the string block in Encoding
Features that are not planned to be supported:
- Patch archives (unnecessary since we aren't going to patch old files)
- Background downloader files
This work is neither endorsed by nor affiliated with Blizzard Entertainment.
World of Warcraft, Warcraft, Battle.net and Blizzard Entertainment are trademarks or registered trademarks of Blizzard Entertainment, Inc. in the U.S. and/or other countries.
I could not have done this without the documentation at the WoWDev wiki. Thanks to those who contribute there!
Some BLTE processing details (especially for encrypted blocks) came from the CASCExplorer project.
Copyright 2017 Gerard Dombroski
Licensed under the Apache License, Version 2.0 (the "License"); you may not use these files except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.