Skip to content

wowdev/wow-listfile

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2,659 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Listfiles

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

Downloading

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"

About

A listfile for WoW archived files

Topics

Resources

Stars

Watchers

Forks

Contributors