| .github/workflows | ||
| .vscode | ||
| cmd | ||
| helper | ||
| notes | ||
| pfs | ||
| qfs | ||
| quail | ||
| raw | ||
| scripts | ||
| tree | ||
| wasm | ||
| wce | ||
| .env_default | ||
| .gitignore | ||
| doc.go | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| main.go | ||
| main_wasm.go | ||
| Makefile | ||
| quail.exe.manifest | ||
| quail.png | ||
| README.md | ||
| rsrc_windows_386.syso | ||
| rsrc_windows_amd64.syso | ||
Quail is a command line EverQuest asset manager.
You can find the latest download of quail in releases
Features include:
- zip/unzip pfs archives such as eqg, s3d, pak, and pfs
- convert between pfs archives and .quail folder format (also known as wce (WorldCom Emu))
- inspect binary files like wld, mod, mds
- tree to visualize binary files
Status
Quail currently in an early preview status. While many functionality goals have even reached, they are buggy and not supporting every use case.
Compiling WebAssembly API
Quail can be compiled to WebAssembly to be used in the browser. To compile to WebAssembly, run:
GOOS=js GOARCH=wasm go build -o wasm/quail.wasm main_wasm.go
EverQuest File Overview
Pfs
Pfs represents packaged files, you can think of them as zip compressed archives but has a special format
| Extension | Notes |
|---|---|
| eqg | EverQuest Game Asset Pfs Archive |
| s3d | EverQuest Game Asset Pfs Archive (Legacy) |
| pak | EverQuest Game Asset Pfs Archive (Legacy) |
| pfs | EverQuest Game Asset Pfs Archive (Legacy) |
Model/Mesh
Model meshes represents geometry data, and some times metadata
| Extension | Notes |
|---|---|
| dat | zone model for version 4 zones |
| mds | npc, object and item model information |
| mod | npc, object and item model information |
| ter | zone model data for version 1 to 3, similar to mod/mds just without bone data |
| wld | megapack of model metadata and model information for s3d legacy pfs archives |
Model/Metadata
Model Metadata gives additional information about a mesh
| Extension | Notes |
|---|---|
| ani | Animation data, frame by frame based on bone locations |
| edd | Emitter definition data, aligns with prt to give details about how particles and emitters work |
| lay | Layered texture data (Used for texture swaps/variations in a single model) |
| lit | Light baking data, has same count as vertices |
| lod | Level of Detail related information, usually refs to additional meshes to render based on distance |
| prt | Particle Rendering Transformations, |
| pts | Particle Transformation Statements, |
| tog | Toggle data |
| zon | Zone placement data, gives information about the zone terrain and object placements. Version 3 and below this is a binary file, Version 4+ it is raw text in a 3DsMax format |
| eco | Ecology metadata, used for randomizing and blending maps in Version 4 Zones |
| rfd | Radial Flora Data, grass, rocks,and other placable greenery metadata |
Special Files
| Name | Notes |
|---|---|
| floraexclusion.dat | Flora exclusion areas, Versin 4 zones use this to create ignores on RFD files |
| prj | 3DS Max Project files, this is used by internal team for opening a pfs mesh, doesn't appear to have any use for EverQuest. |
| dbg.txt | Debug log, shows the last export attempt internally, doesn't appear to have any use for EverQuest. |
Running Tests and Setting Up a Development Environment
At the root of the repo, you'll see a file called .env_default. Copy it to the file .env, and edit the EQ_PATH variable inside to point to your EQ directory. NOTE that this EQ directory will get folders made like _gequip.s3d/, or _test_data/, so you may want to consider pointing to a unused EQ path if you don't like the clutter of folders on top.