Newer
Older
[](https://github.com/TrinityCore/WowPacketParser/blob/WowPacketParser/COPYING)
[](https://scan.coverity.com/projects/2618)
[](https://travis-ci.org/TrinityCore/WowPacketParser)
[](https://ci.appveyor.com/project/DDuarte/wowpacketparser-191)
[](https://hub.docker.com/r/trinitycore/wpp/)
[](https://www.codacy.com/app/TrinityCore/WowPacketParser?utm_source=github.com&utm_medium=referral&utm_content=TrinityCore/WowPacketParser&utm_campaign=Badge_Grade)
* Compile WowPacketParser using Visual Studio 2019 (with .NET Core SDK 3.1) or .NET Core SDK 3.1 (Linux/OSX).
Alternatively you can download compiled binaries from the links [below](#nightly-builds).
* Edit `WowPacketParser.exe.config` to fit your needs.
* Drag one or more files (.pkt or .bin) to `WowPacketParser.exe`.
* Command line usage: `WowPacketParser.exe [--ConfigFile path --Option1 value1 ...] filetoparse1 ...`
##### Databases
Optionally, WPP can connect to two kinds of MySQL databases: `world` from [TrinityCore](https://github.com/TrinityCore/TrinityCore)
and its own database, `WPP`. This can be enabled by setting `<add key="DBEnabled" value="true" />`
in the `.config` file. Remember to set `<add key="TargetedDatabase" value="1"/>` in accordance with the targeted version of the core.
The `world` database is used when creating SQL files after parsing to produce the minimum number of
changes needed to update the database. For example, if only the faction of a creature that appears
in the sniff needs to be updated, the produced SQL files will contain an UPDATE query, instead of
a full INSERT to the table `creature_template`. WPP does not modify this database directly, all the
tentative changes will be written to the output SQL files.
The `WPP` database is used to feed additional data that WPP may use while parsing. For example, in
the output text files, the spell name can be displayed next to spell ids:
> ServerToClient: SMSG_SPELL_START (0x2BB8) Length: 96 ConnIdx: 0 Time: 01/01/2016 00:22:33.235 Number: 701
> (Cast) CasterGUID: Full: 0x03691F00000000000000000000000001 Player/0 R3558/S0 Map: 0 Low: 1
> (Cast) SpellID: **2479 (Honorless Target)**
> (Cast) CastFlags: 15
This is available for a lot of other named entities (achievements, creatures, quests, etc.). The SQL
files required for this database is in the `SQL` directory. `create_WPP.sql` creates the database
and `wpp_data_objectnames.sql` has some data to fill the database.
.NET Core SDK 3.1 (3.1.100 or higher) or .NET Core Runtime 3.1 (3.1.100 or higher) is needed!
[Download .NET Core 3.1 here!](https://dotnet.microsoft.com/download/dotnet-core/3.1)
##### Windows
- Visual Studio 2019
- [Debug](https://ci.appveyor.com/api/projects/DDuarte/wowpacketparser-191/artifacts/WowPacketParser/WPP.zip?job=Image:%20Visual%20Studio%202019;%20Configuration:%20Debug&branch=master)
- [Release](https://ci.appveyor.com/api/projects/DDuarte/wowpacketparser-191/artifacts/WowPacketParser/WPP.zip?job=Image:%20Visual%20Studio%202019;%20Configuration:%20Release&branch=master)
##### Linux (Ubuntu)
- [Debug](https://ci.appveyor.com/api/projects/DDuarte/wowpacketparser-191/artifacts/WowPacketParser/WPP.zip?job=Image:%20Ubuntu;%20Configuration:%20Debug&branch=master)
- [Release](https://ci.appveyor.com/api/projects/DDuarte/wowpacketparser-191/artifacts/WowPacketParser/WPP.zip?job=Image:%20Ubuntu;%20Configuration:%20Release&branch=master)
Docker (experimental)
---------------------
It is possible run WPP on Docker using the `trinitycore/wpp` image:
```
docker run -v /place/where/sniffs/are/kept:/usr/src/app/build/sniffs trinitycore/wpp sniffs/sniffname.pkt
```
*/place/where/sniffs/are/kept* should your local directory containing the .pkt file and *sniffname.pkt* the file to be parsed.
Output (.txt/.sql) of the parser will be added to */place/where/sniffs/are/kept*.
Copyright & Third Party
-----------------------
##### WowPacketParser
License: GPLv3
Read file [COPYING](COPYING).
##### Third Party
The third party libraries have their own way of addressing authorship, and the authorship of commits importing/ updating
a third party library reflects who did the importing instead of who wrote the code within the commit.
###### NuGet libraries:
Copyright information of third party libraries provided through NuGet can be obtained by checking https://www.nuget.org/
###### Provided third party libraries:
DBFileReaderLib, 2019-2020 wowdev, located at https://github.com/wowdev/DBCD