server/src/tools/Extractor_Binaries/README.txt
2020-02-17 12:12:57 +00:00

51 lines
1.7 KiB
Text

Client data extraction helpers
==============================
This directory provides a few helper scripts which will extract maps for both
calculating maps positions using the *mangos* map tools built during the build
process.
Requirements
------------
You will need a working installation of the [World of Warcraft][1] client patched
to version 4.3.4.
Also, you will have to run a full build of *mangos* to create all map tools.
Instructions
------------
Copy the created map tools to the [World of Warcraft][1] installation directory,
namely the tools named:
* `map-extractor`
* `vmap-extractor`
* `vmap-assembler`
* `mmap-generator`
Then copy `ExtractResources.sh`, `MoveMapGen.sh` and `offmesh.txt` into the client
installation directory.
Now open a [git Bash shell][2], and change to the installation directory.
Execute `ExtractResources.sh`, and answer the questions asked by the tool to
* extract client database files, and maps (**required**).
* extract and assemble vmaps (**required**).
* extract movement maps (**optional**). Be aware that this process is very CPU
intense, and depending on your CPU may take up to a half day to create all
movement maps.
If you edit `offmesh.txt` to fix any issues with navigation meshes, you can rerun
`ExtractResources.sh` to rebuild movement maps.
Logging
-------
The helper scripts will log every step of the process. Both `map-tools.log`
and `map-tools_detailed.log` will provide the output generated by all map
tools.
If you extracted movement maps too, there will be additional logs available:
`mmap-generator.log`, and `mmap-generator_detailed.log`.
[1]: http://blizzard.com/games/wow/ "World of Warcraft"
[2]: http://git-scm.com/ "git"