Skip to content

wowdev/wow-listfile

Repository files navigation

⚠Important update⚠

(Last updated May 23rd 2024 @ 17:00 CEST)

TL;DR Use the listfiles from releases from now on, NOT the listfiles in the repository as these will be removed soon.

Direct links for the latest full listfile from the latest release:
community-listfile.csv
community-listfile-withcapitals.csv

Longer explanation: Due to the 100MB size limit on files inside GitHub repos, complete versions of the community listfiles will from now on be distributed through GitHub releases. The compiled listfiles currently in the repository do not have placeholder filenames to save on space to temporarily allow them to stay updated with new files/changes.

Update May 23rd 2024: As announced in August 2023, the community listfiles in the repository will soon be removed.


Listfiles

This repository contains filenames and tools to generate listfiles for use with World of Warcraft.

Downloading

When downloading one of the listfiles, make sure to use the one from the latest release as the ones in the repository itself are either outdated or missing certain files to stay under the 100MB file limit imposed by GitHub.

Direct links to the latest released listfiles:

Contributing

Please open a new issue by picking the "CSV listfile suggestion" and attaching your suggestions in the form of a .txt file. Do not make pull requests. When accepted, files will be be merged into the community listfile, and any official/verified names merged into the verified listfile.

Community listfile

As of WoW: Battle for Azeroth, many files have lost their lookup hash which allowed us to verify and map filenames for a file. For that reason, a new listfile was created that binds names to file IDs instead. There are 2 different listfiles available, community-listfile.csv which is normalized to only contain lowercase filenames and community-listfile-withcapitals.csv with varied casing for user friendliness.

Note on filename "stability" in the community listfile

Due to lookup hashes largely being unavailable we are no longer able to verify the filenames for most files. As such, all files with unverifiable filenames (most files since 8.2) can change their name at any time if a better name is thought of/submitted, especially if the current filename is a placeholder filename (for example by having unk, unknown, autogen or a FileDataID in the name). If you work on/with tools that rely on the filenames in the listfile being "stable", please keep this note in mind or use the verified listfile below.

Verified listfile

Similar to the below listfile, but is formatted like the community listfile and is automatically updated with new verified/official names based on lookups in the meta/lookups.csv file (that one is manually updated still, for now). Also has two versions like the community listfile, one with capitals and one without.

Listfile (listfile.txt)

This listfile should only contain verified and/or official names from throughout WoW's history and as such will not have many names from modern WoW expansions. This is not automatically updated nor is it available in releases.

How to add things to listfile.txt (legacy lookup-based listfile)

  • ./normalize.sh
  • if git status has modifications, git add listfile.txt && git commit -m "normalisation permutation"
  • cat >> listfile.txt
  • ./normalize.sh
  • git add listfile.txt && git commit -m "$message"